označuje príslušnú krajinu.

Ak sa vlastnosti fiscalCountryProperties vyžiadajú prostredníctvom GET /api/v1/information/client/{clientId}/countryProperties, určí sa krajina priradená príslušnému klientovi.

Určuje, či je v danej krajine vyžadovaná certifikácia fiskálnej komponenty, alebo čo je potrebné certifikovať.

„mandatory“ – Certifikácia nadradeného systému (napr. pokladnice) je povinná. V tomto prípade musí pokladnica prejsť certifikačným alebo schvaľovacím procesom.

„miniPOS“ – Certifikácia je povinná, ale splňuje ju už certifikovaná zložka, ktorú je možné integrovať do RetailForce Middleware.

„notNecessary“ – Certifikácia predchádzajúceho systému sa nevyžaduje.

„true“ – v danej krajine sa údaje musia odosielať po riadkoch, napr. na daňovú tlačiareň.

• momentálne nie je podporované

„false“ – Rozhranie založené na dokumentoch (bez tlače riadok po riadku).

• Implementácia medzi nadradeným systémom a službou fiskalizácie je založená na štandardných koncových bodoch api.

Určuje typ fiskalizácie.

„fiscalPrinter“ – Fiskalizácia je založená na certifikovanej fiskálnej tlačiarni alebo certifikovanom systéme fiskálnej pokladnice.

• To znamená, že okrem RetailForce systemu je potrebná aj fiškálna tlačiareň. Tú možno bude potrebné zakúpiť od miestneho dodávateľa.

„online“ – Fiskalizácia prostredníctvom online systémov miestnych daňových úradov.

• Nie je potrebná žiadna dodatočná hardvérová súčasť.

„signature“ – Fiskalizácia prostredníctvom podpisu údajov na potvrdení pomocou digitálneho certifikátu uloženého vo fiskalizačnej službe.

• V niektorých krajinách môže byť potrebné získať kvalifikovaný digitálny certifikát vydaný certifikačnou autoritou (CA).

„signatureWithOnline“ – Fiskalizácia vytvorením podpisov a online odoslaním údajov daňovým úradom.

• Kombinácia dvoch vyššie uvedených typov.

Určuje, ktoré prostredie je podporované:

„local“ – lokálna inštalácia fiskálneho middlewaru (lokálne v POS systéme, na serveri predajne atď.)

• Volania api je možné smerovať na lokálne nainštalovanú fiskalizačnú službu:
  • http://localhost:7678/ v prípade implementácie REST, alebo
  • volanie metódy v prípade implementácie prostredníctvom nuget.

„cloud“ – fiškálny middleware je k dispozícii ako hostovaná cloudová služba na adrese https://fiscalisation.retailforce.cloud/.

• Volania API je možné smerovať na cloudovú fiskalizačnú službu.

Určuje, ktoré operačné systémy/platformy sú podporované.

„linux“

• prostredníctvom kontajnera Docker (implementácia REST)

„windows“

• prostredníctvom služby Windows (implementácia REST) alebo
• prostredníctvom implementácie nuget

„ios“

• prostredníctvom implementácie nuget

„android“

• prostredníctvom implementácie nuget, alebo
• služba pre Android (implementácia REST)

Určuje, ktoré právne požiadavky sú podporované a ich verzie.

Napr. pre Grécko: „myDATA v1.x.x“

Typy dokumentov, ktoré majú byť v príslušnej krajine „fiskalizované“. Musia byť napríklad spracované predpísanou hardvérovou komponentou, podpísané atď.

„documentTypes“ uvedené pod „fiscalDocumentTypes“ sú v príslušnej krajine automaticky spracované (napr. podpísané) službou fiskalizácie v súlade so zákonmi o fiskalizácii.

Tieto typy dokumentov MUSIA byť odoslané do služby fiskalizácie v príslušnej krajine, za predpokladu, že ich podporuje nadradený systém („pokladňa“).

Zoznam typov dokumentov podporovaných v jednotlivých krajinách.

Okrem „fiscalDocumentTypes“ MÔŽU byť do služby fiskalizácie odoslané aj typy dokumentov uvedené v položke „supportedDocumentTypes“.

Tieto typy dokumentov sú takzvané „nefiškálne“ dokumenty, t. j. dokumenty, ktoré nie sú „fiškálne spracované“ (napr. podpísané).

Zoznam typov dokumentov, ktoré nie sú v danej krajine podporované.

„DocumentTypes“ uvedené v položke „notSupportedDocumentTypes“ nemožno odoslať do služby fiskalizácie v príslušnej krajine.

Dôvodom môže byť technická nemožnosť alebo predpisy/zákony špecifické pre danú krajinu.

Ak sa typ dokumentu „notSupportedDocumentType“ odošle do služby fiskalizácie, táto služba odpovie chybovou správou („documentType not supported!“).

Nadriadený systém by nemal povoliť tieto typy dokumentov v príslušnej krajine.

Zoznam platobných metód podporovaných (akceptovaných) v príslušnej krajine.

Tieto platobné metódy je možné používať v príslušnej krajine.

Nadriadený systém by mal používateľovi pokladne ponúkať iba platobné metódy podporované v danej krajine.

Zoznam platobných metód, ktoré nie sú v danej krajine podporované (alebo povolené).

Nadriadený systém by mal potlačiť platobné metódy, ktoré nie sú v danej krajine podporované.

Zoznam platobných metód (PaymentTypes), pri ktorých nie je v danej krajine povolené preplatnenie dlžnej sumy.

Príklady:

Celková suma na pokladničnom doklade = 38,50 EUR

• Zákazník zaplatí 50 EUR debetnou kartou, pretože si želá vrátenie drobných v hotovosti.
• Zákazník zaplatí 50 EUR v hotovosti a dostane 11,50 EUR ako drobné (vrátená hotovosť).

Tieto transakcie nie sú v niektorých krajinách povolené (t. j. nemôžu byť odoslané do systému fiskalizácie).

To znamená, že platobné sumy („payment.amount“) musia vždy zodpovedať hrubej sume položiek („GrossValue“ všetkých „positions“) a nesmú sa prenášať žiadne záporné platobné sumy.

Zoznam typov obchodných prípadov podporovaných v jednotlivých krajinách.

Tieto obchodné prípady je možné použiť v príslušnej krajine, na rozdiel od typov „notSupportedBusinessTransactionTypes“.

Zoznam typov obchodných prípadov, ktoré nie sú v príslušnej krajine podporované (alebo nie sú povolené).

Tieto obchodné prípady nie je možné v danej krajine použiť a zdrojový systém by ich mal potlačiť a neposielať do služby fiskalizácie.

Podrobné informácie o sadzbách Vat podporovaných v jednotlivých krajinách.

Toto pole obsahuje nasledujúce informácie:

• Sadzba DPH: „VatPercent“ / „VatPercent2“
• Interné ID používané na priradenie príslušnej sadzby DPH: „VatIdentification“
• Názov sadzby Vat: „caption“ / „Caption_EN“
• Historické sadzby Vat s údajmi o platnosti („ValidFrom“ – „ValidTo“)

„nie je povinné“ – Zobrazenie zákazníka nie je povinné (nie je to záväzok).

„povinné (no-RF)“ – Zobrazenie zákazníka je povinné, ale nie je riadené prostredníctvom RetailForce Middleware. Riadenie sa vykonáva automaticky príslušným fiskalizačným systémom (napr. automaticky prostredníctvom fiskálnej tlačiarne).

„povinné (RF)“ – Zobrazenie zákazníkovi je povinné a je riadené prostredníctvom RetailForce Middleware.

• Zobrazenie na zákazníckom displeji sa riadi prostredníctvom funkcie: POST /api/v1/transactions/display/{clientId}

„neprípustné“ – Používanie zákazníckeho displeja je v tejto krajine zakázané.

Určuje, či musia byť vstupné zariadenia zaregistrované v príslušnej krajine („true“ / „false“).

Vstupné zariadenia nie sú samostatnými záznamovými systémami. Ďalšie informácie nájdete v časti: Architektúry elektronických záznamových systémov (EAS)

„true“ – v príslušnej krajine platí povinnosť viesť technický denník (audit log) (v tomto prípade je súčasťou licencie RF).

• V tomto prípade sa záznamy o technických udalostiach musia odosielať do služby fiskalizácie prostredníctvom
  • POST /api/v1/transactions/AuditLog , alebo
  • POST /api/v1/transactions/storeDocument („documentType“: „[1002] = AuditLog“)

„false“ – neexistuje požiadavka na vedenie technického denníka (nie je zahrnuté v licencii).

• Technické udalosti SA MÔŽU zaznamenávať, nie je to však povinné.

„true“ – v príslušnej krajine sa dotlač dokumentu musí povinné zaznamenať.

• Vyvolajte buď:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, alebo

  • PUT /api/v1/transactions/reprintDocument

    povinné.

„false“ – Opätovné vytlačenie dokumentu nemusí byť povinné.

„terminal“ – Dokument sa môže opätovne vytlačiť iba na tej istej pokladni, na ktorej bol vystavený pôvodný dokument.

„store“ – Opätovné vytlačenie dokumentu je možné vykonať iba v tej istej pobočke/predajni, kde bol vystavený aj pôvodný dokument.

• Funkcia opätovnej tlače naprieč viacerými pobočkami musí byť implementovaná nadradeným systémom.

„všetko“ – Opätovná tlač dokumentu sa môže vykonať na inej pokladni, ako aj v inej pobočke/predajni tej istej spoločnosti.

• Funkcia opätovnej tlače naprieč viacerými pobočkami musí byť implementovaná nadradeným systémom.

„true“ – raz denne sa musí vygenerovať denné uzávierka (Z-správa).

• denné uzávierka
  • POST /api/v1/transactions/storeDocument
  • „documentType“: „[99] = EndOfDay“

„false“ – denné uzávierky nie sú povinné.

Uvádza časové obdobie od denného otvorenia pokladne, v rámci ktorého musí prebehnúť denné uzatvorenie (napr. do 24 hodín).

„-1“ – nie je nastavené.

Určuje, či je možné na pokladničnom doklade (dokumente) zaznamenať predaj a vrátenie tovaru súčasne.

„oneReceiptAllowed“ – povolené (predaj a vrátenie tovaru môžu byť uvedené spoločne na jednej účtenke).

• Predaj:
  • „positions“ (typ 0 alebo 1) s kladnými hodnotami,
• Vrátenia:
  • „positions“ (typ 0 alebo 1) s zápornými hodnotami a
  • nastavený „documentReference“.

„oneReceiptAllowedVat“ – pokiaľ je suma Vat kladná, predaj a vrátenie tovaru môžu byť zaznamenané na jednej (tej istej) účtenke.

„multiReceipt“ – predaj a vrátenie tovaru musia byť zaznamenané na rôznych pokladničných blokoch.

• Pred odoslaním údajov do fiskalizačnej služby musí predchádzajúci systém automaticky rozdeliť predaj a vrátenie tovaru do rôznych transakcií.

„NoReturnAllowed“ – v danej krajine nie je možné spracovávať vrátenia tovaru prostredníctvom fiskalizačného systému. V týchto krajinách sa vrátenia tovaru často spracovávajú prostredníctvom špeciálnych formulárov alebo podobných prostriedkov v účtovnom oddelení.

Kde je možné vrátiť zakúpený tovar?

„terminal“ – tovar je možné vrátiť iba na tej istej pokladni (vydanie dokladu), na ktorej bol pôvodný predaj realizovaný.

„store“ – tovar je možné vrátiť iba v tej istej pobočke/predajni (vydanie pokladničného dokladu), kde bol pôvodný predaj realizovaný.

„all“ – Tovar je možné vrátiť aj v iných pobočkách tej istej spoločnosti.

Referenčný dokument pre vrátenie tovaru

„single“ – v prípade vrátenia tovaru sa môže odkazovať iba na JEDEN predchádzajúci dokument (predajný doklad o vrátených službách alebo tovare).

• „documentReference“ je povolené iba pre jediný predbežný dokument, alebo
• odkaz na úrovni položky („positionReference“) je povolený len pre jeden predchádzajúci dokument.

„multiple“ – v prípade vrátenia tovaru je možné uvádzať odkazy na viacero predchádzajúcich dokumentov (viacero predajných dokladov, ak sa vracajú viaceré služby alebo tovar z viacerých nákupov). 

• „documentReference“ na viac predchádzajúcich dokumentov, alebo
• odkaz na príslušný predchádzajúci dokument prostredníctvom „positionReference“ na jednotlivú položku vrátenia.

Určuje, či sa má na dokladoch vytlačiť prvok „fiscalDocumentNumber“ z „fiscalResponse“ príslušnej krajiny.

• Čísla dokumentov prenesené z nadradeného systému sa ignorujú. Daňový systém (napr. tlačiareň) priradí príslušné číslo dokumentu/ID dokumentu autonómne.

„true“ – v danej krajine sú povolené príplatky za tovar alebo služby.

• prirážky:
  • „positions.discounts“ s NEGATÍVNYMI hodnotami

„false“ – Cenové príplatky nie sú povolené.

Uvádza, či je v danej krajine povolený školiaci/demo režim pokladnice

„true“ – povolené.

• Trénovací režim:
  • „IsTraining“: true

„false“ – Pokladňa nesmie mať režim školenia/ukážky.

„true“ – Suma jednotlivých položiek sa vypočíta na základe čistej sumy (NetValue) (napr. Québec/Kanada).

"false" – Suma jednotlivých položiek sa vypočíta na základe hrubej sumy (GrossValue) (predvolené nastavenie).

„true“ – Položky, ktoré boli zadané, ale následne neboli zahrnuté do dokumentu, musia byť odoslané v payloade (JSON).

„false“ – Položky, ktoré boli zadané, ale následne neboli zahrnuté do dokumentu, sa nemusia odosielať.

Určuje typ počiatočného dokumentu v príslušnej krajine.

Relevantné len v prípade, ak nadriadený systém počas inicializácie NEPOUŽÍVA funkciu GET /api/v1/transactions/document/{clientId}/start a príslušný počiatočný dokument generuje sám.

Zoznam typov výplat podporovaných v príslušnej krajine.

Položky uvedené v „supportedPayOutTypes“ môžu/musia byť špecifikované pre výplaty („documentType“: „[10] = PayOut“ a „BusinessTransactionType“: „[10] = PayOut“).

Uvádza, či sadzby Vat vypočítava príslušný fiskalizačný modul danej krajiny.

„true“ – Sadzby DPH vypočítava modul zdanenia.

„false“ – sadzby Vat musí vypočítať pokladňa.

Určuje, či a koľko desatinných miest sa musí uviesť v dokumente JSON pre Fiscal Middleware pri odosielaní súm / súčtov.

Platí pre všetky špecifikácie hodnôt v payload („GrossValue“, „NetValue“, „TaxValue“, „Amount“ atď.)