Typ

INFO

označuje příslušnou zemi.

Pokud jsou vlastnosti fiscalCountryProperties dotazovány pomocí GET /api/v1/information/client/{clientId}/countryProperties, je uvedena země přiřazená danému klientovi.

INFO

INFO

Určuje, zda je v dané zemi vyžadována certifikace fiskální komponenty, případně co je třeba certifikovat.

„mandatory“ – Certifikace nadřazeného systému (např. pokladny) je povinná. V tomto případě musí pokladna projít certifikačním nebo schvalovacím procesem.

„miniPOS“ – Certifikace je povinná, ale je splněna již certifikovanou komponentou, kterou lze integrovat do middlewaru RetailForce.

„notNecessary“ – Certifikace předchozího systému není vyžadována.

RFI

„true“ – v dané zemi musí být data odesílána řádek po řádku, např. na fiskální tiskárnu.

• v současné době není podporováno

„false“ – Rozhraní založené na dokumentech (bez tisku po jednotlivých řádcích).

• Implementace mezi nadřazeným systémem a službou fiskalizace je založena na standardních koncových bodech API.

INFO

Určuje typ fiskalizace.

„fiscalPrinter“ – Fiskalizace je založena na certifikované fiskální tiskárně nebo certifikovaném fiskálním pokladním systému.

• To znamená, že kromě systému RetailForce je nutná fiskální tiskárna. Tu může být nutné zakoupit u místního dodavatele.

„online“ – Fiskalizace prostřednictvím online systémů místních daňových úřadů.

• Není vyžadována žádná další hardwarová součást.

„signature“ – Fiskalizace prostřednictvím podepsání údajů na účtence pomocí digitálního certifikátu uloženého ve fiskalizační službě.

• V některých zemích může být nutné získat kvalifikovaný digitální certifikát vydaný certifikační autoritou (CA).

„signatureWithOnline“ – fiskalizace prostřednictvím vytváření podpisů a online přenosu dat daňovým úřadům.

• Kombinace obou výše uvedených typů.

RFI

Určuje, které prostředí je podporováno:

„local“ – lokální instalace fiskálního middlewaru (lokálně na pokladním systému, na serveru prodejny atd.)

• Volání API lze provádět na lokálně nainstalovanou fiskální službu:
  • http://localhost:7678/ v případě implementace REST, nebo
  • volání metody v případě implementace přes NuGet.

„cloud“ – fiskální middleware je k dispozici jako hostovaná cloudová služba na adrese https://fiscalisation.retailforce.cloud/.

• Volání API lze provádět směrem ke službě Cloud Fiscalisation Service.

RFI

Určuje, které operační systémy/platformy jsou podporovány.

„linux“

• prostřednictvím kontejneru Docker (implementace REST)

„windows“

• prostřednictvím služby Windows (implementace REST) nebo
• prostřednictvím implementace NuGet

„ios“

• prostřednictvím implementace NuGet

„android“

• prostřednictvím implementace NuGet, nebo
• služba pro Android (implementace REST)

INFO

Určuje, které právní požadavky jsou podporovány a jaké jsou jejich verze.

Např. pro Řecko: „myData v1.x.x“

RFI

Typy dokumentů, které mají být v dané zemi „fiskalizovány“. Musí být například zpracovány předepsanou hardwarovou komponentou, podepsány atd.

„documentTypes“ uvedené pod „fiscalDocumentTypes“ jsou v příslušné zemi automaticky zpracovány (např. podepsány) službou fiskalizace v souladu s právními předpisy o fiskalizaci.

Tyto typy dokumentů MUSÍ být předány fiskalizační službě v příslušné zemi, za předpokladu, že je podporuje nadřazený systém („pokladna“).

RFI

Seznam typů dokumentů podporovaných v jednotlivých zemích.

Kromě „fiscalDocumentTypes“ MOHOU být do fiskalizační služby předány i typy dokumentů uvedené v položce „supportedDocumentTypes“.

Tyto typy dokumentů jsou tzv. „nefiskální“ dokumenty, tj. dokumenty, které nejsou „fiskalizovány“ (např. podepsány).

RFI

Seznam typů dokumentů, které nejsou v dané zemi podporovány.

„DocumentTypes“ uvedené v sekci „notSupportedDocumentTypes“ nelze odeslat do služby fiskalizace v dané zemi.

Důvodem může být technická nemožnost nebo předpisy/zákony specifické pro danou zemi.

Pokud je „notSupportedDocumentType“ odeslán do služby fiskalizace, ta odpoví chybovou zprávou („documentType není podporován!“).

Nadřazený systém by neměl tyto typy dokumentů v dané zemi povolit.

RFI

Seznam platebních metod podporovaných (akceptovaných) v dané zemi.

Tyto platební metody lze v dané zemi používat.

Nadřazený systém by měl uživateli pokladny nabízet pouze platební metody podporované v dané zemi.

RFI

Seznam platebních metod, které nejsou v dané zemi podporovány (nebo nejsou povoleny).

Nadřazený systém by měl v dané zemi potlačit nepodporované způsoby platby.

RFI

Seznam platebních metod (paymentTypes), u nichž není v dané zemi povoleno přeplatit dlužnou částku.

Příklady:

Celková částka na účtence = 38,50 EUR

• Zákazník zaplatí 50 EUR debetní kartou, protože si přeje dostat drobné v hotovosti.
• Zákazník zaplatí 50 EUR v hotovosti a obdrží 11,50 EUR jako drobné (vrácená částka).

Tyto transakce nejsou v některých zemích povoleny (tj. nelze je odeslat do fiskalizačního systému).

To znamená, že částky plateb („payment.amount“) musí vždy odpovídat hrubé celkové částce položek („grossValue“ všech „positions“) a nesmí být převáděny žádné záporné částky plateb.

RFI

Seznam typů obchodních případů podporovaných v jednotlivých zemích.

Tyto obchodní případy lze v dané zemi použít, na rozdíl od typů „notSupportedBusinessTransactionTypes“.

RFI

Seznam typů obchodních případů, které nejsou v dané zemi podporovány (nebo nejsou povoleny).

Tyto obchodní případy nelze v dané zemi použít a zdrojový systém by je měl potlačit a nepředávat službě pro fiskální účely.

RFI

Podrobné informace o sazbách Vat podporovaných v jednotlivých zemích.

Toto pole obsahuje následující informace:

• Sazba DPH: „vatPercent“ / „VatPercent2“
• Interní ID používané k přiřazení příslušné sazby Vat: „vatIdentification“
• Název sazby Vat: „caption“ / „Caption_EN“
• Historické sazby Vat s údaji o platnosti („ValidFrom“ – „ValidTo“)

RFI

RFI

„není povinné“ – Zobrazení zákazníka není vyžadováno (není povinné).

„povinné (bez RF)“ – Zobrazení zákazníka je povinné, ale není řízeno prostřednictvím middlewaru RetailForce. Řízení provádí automaticky příslušný fiskální systém (např. automaticky fiskální tiskárna).

„povinné (RF)“ – Zobrazení zákazníka je povinné a je řízeno prostřednictvím middlewaru RetailForce.

• Zákaznický displej je řízen pomocí funkce: POST /api/v1/transactions/display/{clientId}

„nepovoleno“ – Použití zákaznického displeje je v této zemi zakázáno.

RFI

Určuje, zda musí být vstupní zařízení v dané zemi registrována („true“ / „false“).

Vstupní zařízení nejsou samostatnými záznamovými systémy. Další informace naleznete v části: Architektury elektronických záznamových systémů (EAS)

RFI

„true“ – v dané zemi existuje povinnost vést technický deník (auditní protokol) (v tomto případě je součástí licence RF).

• V tomto případě musí být záznamy o technických událostech odeslány do fiskalizační služby prostřednictvím
  • POST /api/v1/transactions/auditlog , nebo
  • POST /api/v1/transactions/storeDocument („documentType“: „[1002] = AuditLog“)

„false“ – neexistuje požadavek na vedení technického deníku (není součástí licence).

• Technické události MOHOU být zaznamenávány, ale není to povinné.

RFI

„true“ – v dané zemi musí být povinně zaznamenán dotisk dokumentu.

• Zavolejte buď:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid}, nebo

  • PUT /api/v1/transactions/reprintDocument

    povinné.

„false“ – Opětovný tisk dokumentu nemusí být povinně zaznamenán.

RFI

„terminal“ – Dokument lze znovu vytisknout pouze na téže pokladně, na které byl vystaven původní dokument.

„store“ – Opětovný tisk dokladu je povolen pouze v rámci téže pobočky/prodejny, kde byl vystaven i původní doklad.

• Funkce opětovného tisku napříč více pobočkami musí být implementována nadřazeným systémem.

„all“ – Opětovný tisk dokladu lze provést na jiné pokladně i v jiné pobočce/prodejně téže společnosti.

• Funkci opětovného tisku napříč více pobočkami musí implementovat nadřazený systém.

RFI

„true“ – denní uzávěrka (Z-report) musí být generována jednou denně.

• denní uzávěrka
  • POST /api/v1/transactions/storeDocument
  • „documentType“: „[99] = EndOfDay“

„false“ – denní uzávěrka není vyžadována.

RFI

Udává časové období od posledního denního uzavření, v jehož rámci musí proběhnout další denní uzavření (např. do 24 hodin). Po uplynutí tohoto období služba fiskalizace odmítá každý dokument kromě denního uzavření („documentType“: „[99] = EndOfDay“) se stavovým kódem HTTP 400, dokud nebude denní uzavření uloženo. Před prvním denním uzavřením neplatí žádné omezení.

„-1“ – není nastaveno.

RFI

Určuje, zda lze na účtence (dokumentu) současně zaznamenat prodej i vrácení zboží.

„oneReceiptAllowed“ – povoleno (prodeje a vrácené zboží lze na jedné účtence uvádět společně).

• Prodeje:
  • „positions“ (typ 0 nebo 1) s kladnými hodnotami,
• Vrácené zboží:
  • „positions“ (typ 0 nebo 1) s zápornými hodnotami a
  • nastavený parametr „documentReference“.

„oneReceiptAllowedPerVatRate“ – tržby a vrácené zboží lze zaznamenat na jedné (stejné) účtence, pokud mají hrubé součty všech sazeb Vat na účtence stejné znaménko (všechny kladné nebo všechny záporné).

„multiReceipt“ – Prodeje a vrácené zboží musí být zaznamenány na různých účtenkách.

• Před odesláním dat do fiskalizační služby musí předřazený systém automaticky rozdělit tržby a vrácené zboží do různých transakcí.

„NoReturnAllowed“ – v dané zemi není možné zpracovávat vrácené zboží prostřednictvím fiskalizačního systému. V těchto zemích se vrácené zboží často zpracovává pomocí speciálních formulářů nebo podobných prostředků v účetním oddělení.

RFI

Kde lze zakoupené zboží vrátit?

„terminal“ – Zboží lze vrátit pouze na stejné pokladně (vydání dokladu), na které byl původní prodej uskutečněn.

„store“ – Zboží lze vrátit pouze ve stejné pobočce/prodejně (vydání účtenky), kde byl původní prodej uskutečněn.

„all“ – Zboží lze vrátit i v jiných pobočkách téže společnosti.

RFI

Odkaz na doklad pro vrácení zboží

„single“ – v případě vrácení zboží lze odkazovat pouze na JEDEN předchozí dokument (prodejní doklad o vrácených službách nebo zboží).

• „documentReference“ je povoleno pouze pro jeden předběžný dokument, nebo
• odkaz na úrovni položky („positionReference“) je povolen pouze pro jeden předběžný dokument.

„multiple“ – v případě vrácení zboží lze odkazovat na více předchozích dokumentů (více prodejních dokladů, pokud se vrací více služeb nebo zboží z více nákupů).

• „documentReference“ na více předchozích dokumentů, nebo
• odkaz na odpovídající předchozí doklad prostřednictvím „positionReference“ u jednotlivých položek vráceného zboží.

RFI

Určuje, zda musí být na dokladech vytištěn prvek „fiscalDocumentNumber“ z „fiscalResponse“ příslušné země.

• Čísla dokladů přenesená z nadřazeného systému se ignorují. Daňový systém (např. tiskárna) přiřadí příslušné číslo dokladu/ID dokladu samostatně.

RFI

„true“ – v dané zemi jsou povoleny příplatky za zboží nebo služby.

• příplatky:
  • „positions.discounts“ s ZÁPORNÝMI hodnotami

„false“ – Cenové příplatky nejsou povoleny.

RFI

Uvádí, zda služba fiskalizace pro danou zemi podporuje trénovací/demo režim

„true“ – povoleno.

• Trainingmode:
  • „isTraining“: true

„false“ – tréninkový/demo režim není podporován. Služba fiskalizace odmítne každý doklad s „isTraining“: true (chyba validace „Tréninková účtenka není v této zemi povolena.“).

RFI

„true“ – Součet jednotlivých položek se vypočítává na základě čisté částky (netValue) (např. Québec/Kanada).

„false“ – Součet jednotlivých položek se počítá na základě hrubé částky (grossValue) (výchozí nastavení).

RFI

„true“ – Položky, které byly zadány, ale následně nebyly zahrnuty do dokumentu, musí být odeslány v datové části (JSON).

„false“ – Položky, které byly zadány, ale následně nebyly do dokumentu zahrnuty, nemusí být odeslány.

RFI

Určuje typ počátečního dokumentu v příslušné zemi.

Relevantní pouze v případě, že nadřazený systém při inicializaci NEPOUŽÍVÁ funkci GET /api/v1/transactions/document/{clientId}/start a příslušný počáteční dokument generuje sám.

RFI

Seznam typů výplat podporovaných v dané zemi.

Položky uvedené pod „supportedPayOutTypes“ lze/je nutné specifikovat pro výplaty („documentType“: „[10] = PayOut“ a „businessTransactionType“: „[10] = PayOut“).

RFI

RFI

Uvádí, zda jsou sazby Vat vypočítávány příslušným fiskalizačním modulem dané země.

„true“ – Sazby Vat vypočítává fiskalizační modul.

„false“ – sazby Vat musí vypočítat pokladna.

RFI

RFI

RFI

RFI

Určuje, zda a kolik desetinných míst musí být zahrnuto v dokumentu JSON zasílaném do fiskálního middlewaru při odesílání částek / součtů.

Platí pro všechny specifikace hodnot v užitečném obsahu („GrossValue“, „NetValue“, „TaxValue“, „Amount“ atd.)

RFI

RFI

RFI

RFI