a megfelelő országot jelöli.

Ha fiscalCountryProperties adatokat a GET /api/v1/information/client/{clientId}/countryProperties parancs segítségével kérjük le, akkor az adott ügyfélhez rendelt ország kerül megadásra.

Meghatározza, hogy egy országban szükséges-e egy adóügyi komponens tanúsítása, illetve mit kell tanúsítani.

„mandatory” – Az upstream rendszer (pl. pénztárgép) tanúsítása kötelező. Ebben az esetben a pénztárgépet tanúsítási vagy jóváhagyási eljárásnak kell alávetni.

„miniPOS” – A tanúsítás kötelező, de azt egy már tanúsított komponens biztosítja, amely integrálható a RetailForce middleware-be.

„notNecessary” – Az előző rendszer tanúsítása nem szükséges.

„true” – az adott országban az adatokat soronként kell elküldeni, pl. egy adóügyi nyomtatóra.

• jelenleg nem támogatott

„false” – Dokumentumalapú interfész (nincs soronkénti nyomtatás).

• A felsőbb szintű rendszer és a fiskalizációs szolgáltatás közötti megvalósítás szabványos api végpontokon alapul.

Meghatározza a fiskalizálás típusát.

„fiscalPrinter” – A fiskalizálás tanúsított fiskális nyomtatóra vagy tanúsított fiskális pénztárgép-rendszerre épül.

• Ez azt jelenti, hogy a RetailForce system mellett adóügyi nyomtatóra is szükség van. Ezt esetleg egy helyi beszállítótól kell beszerezni.

„online” – A fiskalizálás a helyi adóhatóságok online rendszerein keresztül történik.

• Nincs szükség további hardverkomponensre.

„signature” – A fiskalizálás a nyugtaadatoknak a fiskalizálási szolgáltatásban tárolt digitális tanúsítvánnyal történő aláírásával történik.

• Egyes országokban szükség lehet egy hitelesítő hatóság (CA) által kiadott minősített digitális tanúsítvány megszerzésére.

„signatureWithOnline” – Adóügyi hitelesítés az aláírások létrehozásával és az adatok online továbbításával az adóhatóságok felé.

• A két fent említett típus kombinációja.

Meghatározza, melyik környezet támogatott:

„local” – a fiskális middleware helyi telepítése (helyi telepítés a POS-rendszeren, az üzlet szerverén stb.)

• API-hívások kezdeményezhetők a helyileg telepített adóügyi szolgáltatás felé:
  • http://localhost:7678/ REST-megvalósítás esetén, vagy
  • módszerhívás a nuget-megvalósítás esetén.

„cloud” – a fiskális middleware felhőalapú szolgáltatásként érhető el a https://fiscalisation.retailforce.cloud/ címen.

• API-hívások indíthatók a Cloud adóügyi szolgáltatás felé.

Meghatározza, mely operációs rendszerek/platformok támogatottak.

„linux”

• Docker-konténeren keresztül (REST-megvalósítás)

„windows”

• Windows-szolgáltatáson keresztül (REST-megvalósítás), vagy
• Nuget-megvalósításon keresztül

„ios”

• Nuget-megvalósításon keresztül

„android”

• Nuget-megvalósításon keresztül, vagy
• Android szolgáltatás (REST-megvalósítás)

Meghatározza, mely jogi követelmények támogatottak, valamint azok verzióit.

Például Görögország esetében: „myDATA v1.x.x”

Az adott országban „adóügyi hitelesítésre” kerülő dokumentumtípusok. Például ezeket az előírt hardverkomponenssel kell feldolgozni, alá kell írni stb.

A „fiscalDocumentTypes” alatt felsorolt „documentTypes” típusokat az adott országban a fiskalizációs szolgáltatás a fiskalizációs törvényeknek megfelelően automatikusan feldolgozza (pl. aláírja).

Ezeket a dokumentumtípusokat KÖTELEZŐEN továbbítani kell az adott ország adóügyi szolgáltatásához, feltéve, hogy az előzményrendszer („pénztárgép”) támogatja őket.

Az egyes országokban támogatott dokumentumtípusok listája.

A „fiscalDocumentTypes” mellett a „supportedDocumentTypes” alatt felsorolt dokumentumtípusok is továbbíthatók a fiskalizációs szolgáltatásnak.

Ezek az úgynevezett „nem adóügyi” dokumentumtípusok, azaz azok, amelyek nem kerülnek „adóügyi feldolgozásra” (pl. aláírásra).

Az adott országban nem támogatott dokumentumtípusok listája.

A „notSupportedDocumentTypes” alatt felsorolt „documentType” típusú dokumentumok nem továbbíthatók az adott ország adóügyi szolgáltatásához.

Ennek oka lehet technikai lehetetlenség vagy országspecifikus szabályozás/törvények.

Ha egy „notSupportedDocumentType” típusú dokumentumot küldenek a fiskalizációs szolgáltatásnak, az hibaüzenettel válaszol („documentType not supported!”).

A feladó rendszernek nem szabad engedélyeznie ezeket a dokumentumtípusokat az adott országban.

Az adott országban támogatott (elfogadott) fizetési módok listája.

Ezek a fizetési módok használhatók az adott országban.

A felettes rendszernek az adott országban csak a támogatott fizetési módokat szabad felajánlania a pénztárgép-felhasználónak.

Az adott országban nem támogatott (vagy nem engedélyezett) fizetési módok listája.

A felülről érkező rendszernek el kell nyomnia az adott országban nem támogatott fizetési módokat.

Azoknak a fizetési módoknak (PaymentTypes) a listája, amelyek esetében az adott országban nem megengedett a tartozás összegének túlfizetése.

Példák:

A számla végösszege = 38,50 EUR

• Az ügyfél 50 EUR-t fizet bankkártyával, mert a visszajárót készpénzben szeretné megkapni.
• Az ügyfél 50 EUR-t fizet készpénzzel, és 11,50 EUR visszajárót kap (visszajáró).

Ezek a tranzakciók egyes országokban nem megengedettek (vagyis nem küldhetők el a fiskalizációs rendszerbe).

Ez azt jelenti, hogy a fizetési összegeknek („payment.amount”) mindig meg kell egyezniük a tételek bruttó összegével (az összes „position” „GrossValue” értéke), és negatív fizetési összegeket nem lehet továbbítani.

Az egyes országokban támogatott üzleti eset típusok listája.

Ezek az üzleti tranzakciótípusok az adott országban használhatók, ellentétben a „notSupportedBusinessTransactionTypes” kategóriával.

Az adott országban nem támogatott (vagy nem engedélyezett) üzleti eset típusok listája.

Ezek az üzleti esetek az adott országban nem használhatók, ezért a forrásrendszernek el kell nyomnia őket, és nem szabad továbbítania az adóügyi szolgáltatásnak.

Részletes információk az egyes országokban támogatott Vat-kulcsokról.

Ez a tömb a következő információkat tartalmazza:

• HÉA-kulcs: „VatPercent” / „VatPercent2”
• A megfelelő áfa-kulcs azonosítására használt belső ID: „VatIdentification”
• A Vat-kulcs neve: „caption” / „Caption_EN”
• Korábbi Vat-kulcsok érvényességi adataival („ValidFrom” – „ValidTo”)

„nem kötelező” – Az ügyfél megjelenítése nem kötelező (nincs kötelezettség).

„kötelező (no-RF)” – Az ügyfél megjelenítése kötelező, de nem a RetailForce Middleware vezérli. Az ellenőrzést automatikusan az adott adóügyi rendszer végzi (pl. automatikusan az adóügyi nyomtató).

„kötelező (RF)” – Az ügyfélkijelző használata kötelező, és az ellenőrzést a RetailForce Middleware végzi.

• Az ügyfélkijelzőt a következő funkcióval vezérlik: POST /api/v1/transactions/display/{clientId}

„nem megengedett” – Az ügyfélkijelző használata ebben az országban tilos.

Meghatározza, hogy a beviteli eszközöket regisztrálni kell-e az adott országban („true” / „false”).

A beviteli eszközök nem önálló nyilvántartási rendszerek. További információk: Elektronikus nyilvántartási rendszerek (EAS) architektúrái

„true” – az adott országban előírás a műszaki napló (audit log) vezetése (ebben az esetben az RF-engedély részét képezi).

• Ebben az esetben a műszaki eseménybejegyzéseket a fiskalizációs szolgáltatásnak kell elküldeni a
  • POST /api/v1/transactions/AuditLog , vagy
  • POST /api/v1/transactions/storeDocument („documentType”: „[1002] = AuditLog”)

„false” – nincs előírás a műszaki napló vezetésére (nem szerepel az engedélyben).

• A műszaki események rögzíthetők, de nem kötelező.

"true" – az adott országban a dokumentum újranyomtatását kötelezően rögzíteni kell.

• Hívja meg az alábbiak egyikét:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, vagy

  • PUT /api/v1/transactions/reprintDocument

    kötelező.

„false” – A dokumentum újranyomtatását nem kötelező nyilvántartásba venni.

„terminal” – A dokumentumot kizárólag azon a pénztárgépen lehet újranyomtatni, amelyen az eredeti dokumentumot kiállították.

„store” – A dokumentum újranyomtatása csak abban a fiókban/üzletben végezhető el, ahol az eredeti dokumentumot is kiállították.

• A több fiókban történő újranyomtatási funkciót a felettes rendszernek kell megvalósítania.

„all” – A dokumentum újranyomtatása elvégezhető egy másik pénztárgépen, valamint ugyanazon vállalat egy másik fiókjában/üzletében is.

• A több fiókra kiterjedő újranyomtatási funkciót a felettes rendszernek kell megvalósítania.

„true” – naponta egyszer napi zárást (Z-jelentést) kell generálni.

• napi zárás
  • POST /api/v1/transactions/storeDocument
  • „documentType”: „[99] = EndOfDay”

„false” – nincs követelmény a napi zárásra.

Jelzi azt az időtartamot a pénztárgép napi megnyitása óta, amelyen belül a napi zárást el kell végezni (pl. 24 órán belül).

"-1" – nincs beállítva.

Meghatározza, hogy az értékesítések és a visszavételek egyidejűleg rögzíthetők-e egy nyugtán (dokumentumon).

„oneReceiptAllowed” – megengedett (az értékesítések és a visszavételek egy nyugtán keverve is feltüntethetők).

• Értékesítés:
  • „positions” (0-as vagy 1-es típus) pozitív értékekkel,
• Visszavételek:
  • „positions” (0-as vagy 1-es típus) negatív értékekkel, és
  • a „documentReference” beállítva.

„oneReceiptAllowedVat” – mindaddig, amíg az Vat összege pozitív marad, az értékesítések és a visszavételek egyetlen (azonos) nyugtán rögzíthetők.

„multiReceipt” – Az értékesítéseket és a visszavételeket különböző nyugtákon kell rögzíteni.

• Az adatoknak a fiskalizációs szolgáltatáshoz történő továbbítása előtt az előzetes rendszernek automatikusan külön tranzakciókba kell felosztania az értékesítéseket és a visszavételeket.

„NoReturnAllowed” – az adott országban a visszatérítések feldolgozása a fiskalizációs rendszeren keresztül nem lehetséges. Ezekben az országokban a visszatérítéseket gyakran speciális űrlapok vagy hasonló eszközök segítségével kezelik a könyvelési osztályon.

Hol lehet a megvásárolt árukat visszaváltani?

„terminal” – A termékeket kizárólag azon a pénztárnál (nyugtakiadás) lehet visszaváltani, ahol az eredeti értékesítés történt.

„store” – A termékeket kizárólag abban a fiókban/üzletben (nyugta kiállítási helye) lehet visszaváltani, ahol az eredeti vásárlás történt.

„all” – A termékeket ugyanazon vállalat más üzleteibe is vissza lehet vinni.

A visszavételek dokumentumhivatkozása

„single” – visszaküldés esetén kizárólag EGY korábbi dokumentumra (a visszaküldött szolgáltatások vagy áruk értékesítési dokumentumára) lehet hivatkozni.

• „documentReference” csak egyetlen előzetes dokumentumra megengedett, vagy
• tétel szintű hivatkozás („positionReference”) csak egyetlen előzménydokumentumra megengedett.

„multiple” – visszaküldés esetén hivatkozás tehető több korábbi dokumentumra (több értékesítési bizonylatra, ha több szolgáltatás vagy áru kerül visszaküldésre több vásárlásból). 

• „documentReference” több korábbi dokumentumra, vagy
• hivatkozás a megfelelő korábbi dokumentumra a „positionReference” segítségével az egyes visszaküldési tételeken.

Meghatározza, hogy a megfelelő ország „fiscalResponse” elemének „fiscalDocumentNumber” elemét ki kell-e nyomtatni a dokumentumokra.

• A feljebb lévő rendszerből átvitt dokumentumszámokat a rendszer figyelmen kívül hagyja. A pénzügyi rendszer (pl. a nyomtató) önállóan rendeli hozzá a megfelelő dokumentumszámot/dokumentumID-t.

„true” – az adott országban megengedettek az árukra vagy szolgáltatásokra kivetett pótdíjak.

• surcharges:
  • „positions.discounts” NEGATÍV értékekkel

„false” – Árfelárak nem megengedettek.

Jelzi, hogy az adott országban engedélyezett-e a pénztárgép képzési/demó üzemmódja

"true" – megengedett.

• Képzési mód:
  • „IsTraining”: true

„false” – A pénztárgép nem rendelkezhet képzési/bemutató üzemmóddal.

"true" – Az egyes tételek összegét a nettó összeg (NetValue) alapján számítja ki a rendszer (pl. Québec/Kanada).

"false" – Az egyes tételek összegét a bruttó összeg (GrossValue) alapján számítják ki (alapértelmezett).

„true” – Azokat a tételeket, amelyeket beviteleztek, de később nem kerültek be a dokumentumba, a payload-ban (JSON) továbbítani kell.

„false” – Azokat a tételeket, amelyeket beviteleztek, de később nem kerültek be a dokumentumba, nem kell továbbítani.

Meghatározza a kezdő dokumentum típusát az adott országban.

Csak akkor releváns, ha a feljebb lévő rendszer az inicializálás során NEM használja a GET /api/v1/transactions/document/{clientId}/start funkciót, hanem maga generálja a megfelelő kezdő dokumentumot.

Az adott országban támogatott kifizetési típusok listája.

A „supportedPayOutTypes” alatt felsorolt elemek megadhatók/meg kell adni a kifizetéseknél („documentType”: „[10] = PayOut” és „BusinessTransactionType”: „[10] = PayOut”).

Jelzi, hogy a Vat-kulcsokat az adott ország megfelelő adóügyi modulja számítja-e ki.

„true” – Az adókezelő modul számítja ki az áfa-kulcsokat.

„false” – a pénztárgépnek kell kiszámítania a Vat-kulcsokat.

Meghatározza, hogy az összegek/összegek elküldésekor a Fiscal Middleware-nek szóló JSON-dokumentumban szerepelnie kell-e tizedesjegyeknek, és ha igen, hánynak.

Minden, a payload-ban található hasznos adaton belüli értékmeghatározásra vonatkozik („GrossValue”, „NetValue”, „TaxValue”, „Amount” stb.)