Nurodo atitinkamą šalį.

Jei užklausa fiscalCountryProperties atliekama per GET /api/v1/information/client/{clientId}/ countryProperties, nurodoma atitinkamam klientui priskirta šalis.

Nurodo, ar šalyje reikalingas fiskalinio komponento sertifikavimas, arba kas turi būti sertifikuojama.

„mandatory“ – privaloma pirminės sistemos (pvz., kasos aparato) sertifikacija. Šiuo atveju kasos aparatas turi būti sertifikuotas arba patvirtintas.

„miniPOS“ – sertifikavimas yra privalomas, tačiau jį atlieka jau sertifikuotas komponentas, kuris, jei reikia, yra integruotas į „RetailForce“ tarpinę programinę įrangą.

„notNecessary“ – pirminės sistemos sertifikavimas nebūtinas.

„true“ – atitinkamoje šalyje duomenys turi būti siunčiami eilutėmis į fiskalinį spausdintuvą.

• Šiuo metu nepalaikoma.

„false“ – dokumentais pagrįsta sąsaja (nespausdinama eilutėmis). 

• Įgyvendinimas tarp pirminės sistemos („kasos“) ir fiskalinės paslaugos pagrįstas standartiniais API galiniais taškais.

Nurodo fiskalizacijos tipą.

„fiscalPrinter“ – fiskalizacija pagrįsta sertifikuotu fiskaliniu spausdintuvu arba sertifikuota fiskaline kasos sistema.

• Tai reiškia, kad be „RetailForce“ sistemos reikalingas fiskalinis spausdintuvas. Prireikus jį reikia įsigyti iš vietos tiekėjo.

„online“ – fiskalizacija atliekama per vietos finansų administracijos internetines sistemas.

• Nereikalingi jokie papildomi aparatinės įrangos komponentai

„signature“ – fiskalizacija pasirašant kvito duomenis naudojant fiskalizacijos paslaugoje saugomą skaitmeninį sertifikatą.

• Kai kuriose šalyse gali būti būtina įsigyti kvalifikuotą skaitmeninį sertifikatą, išduotą sertifikavimo institucijos (CA).

„signatureWithOnline“ – fiskalizavimas sukuriant parašus ir internetu perduodant duomenis finansų administracijai.

• Abiejų minėtų tipų derinys.

Nurodo, kokia aplinka yra palaikoma:

„local“ – fiskalinės tarpinės programinės įrangos vietinė instaliacija (vietinė kasos sistemoje, parduotuvės serveryje...)

• API iškvietimai gali būti siunčiami į lokaliai įdiegtą fiskalinės programinės įrangos paslaugą:
  • http://localhost:7678/ REST įgyvendinimo atveju arba
  • metodų iškvietimas, jei įgyvendinama „nuget“

„cloud“ – fiskalinė tarpinė programinė įranga prieinama kaip hostuojama debesų paslauga adresu https://fiscalisation.retailforce.cloud/.

• API iškvietimai gali būti atliekami į „Cloud-Fiscalisation Service“.

Nurodo, kokios operacinės sistemos / platformos iš esmės yra palaikomos.

„linux“

• per „Docker“ konteinerius (REST įgyvendinimas)

„windows“

• per „Windows“ paslaugą (REST įgyvendinimas) arba
• per „nuget“ įgyvendinimą

„ios“

• per „NuGet“ įgyvendinimą

„Android“

• per „NuGet“ įgyvendinimą, arba
• „Android“ paslauga (REST įgyvendinimas)

Nurodo, kokie teisiniai reikalavimai yra palaikomi, taip pat jų versiją.

Pvz., Graikijai: „myData v1.x.x“

Dokumentų tipai, kurie atitinkamoje šalyje turi būti „fiskalizuoti“. Tai reiškia, kad jie turi būti apdorojami naudojant nustatytus aparatūros komponentus, pasirašomi ir pan.

„fiscalDocumentTypes“ sąraše išvardyti „documentTypes“ atitinkamoje šalyje automatiškai apdorojami fiskalizacijos tarnybos pagal fiskalizacijos įstatymus (pvz., pasirašomi).

Šie dokumentų tipai atitinkamoje šalyje PRIVALOMA perduoti fiskalizacijos tarnybai, jei juos palaiko pirminė sistema („kasos aparatas“).

Atitinkamoje šalyje palaikomų dokumentų tipų sąrašas.

Be „fiscalDocumentTypes“, dokumentų tipai, išvardyti „supportedDocumentTypes“, GALI būti perduoti fiskalizacijos tarnybai. 

Šie dokumentų tipai yra vadinamieji „nefiskaliniai“ dokumentai, t. y. tokie, kurie nėra „fiskalizuojami“ (pvz., pasirašomi).

Atitinkamoje šalyje nepalaikomų dokumentų tipų sąrašas.

„DocumentTypes“, išvardyti „notSupportedDocumentTypes“, atitinkamoje šalyje NEGALI būti perduodami fiskalizavimo tarnybai. 

To priežastys gali būti techninis neįmanomumas arba konkrečiai šaliai būdingi reglamentai / įstatymai.

Jei „notSupportedDocumentType“ siunčiamas fiskalizacijos tarnybai, ši atsako klaidos pranešimu („documentType not supported!“).

Priešsistema neturėtų leisti šių dokumentų tipų atitinkamoje šalyje.

Atitinkamoje šalyje palaikomų (leidžiamų) mokėjimo būdų sąrašas.

Šie mokėjimo būdai gali būti naudojami atitinkamoje šalyje.

Pagrindinė sistema atitinkamoje šalyje kasos vartotojui turėtų siūlyti tik palaikomus („supported“) mokėjimo būdus.

Atitinkamoje šalyje nepalaikomų (arba neleidžiamų) mokėjimo būdų sąrašas.

Priešinė sistema turėtų blokuoti nepalaikomus mokėjimo būdus atitinkamoje šalyje.

Mokėjimo būdų (paymentTypes), kuriais atitinkamoje šalyje neleidžiama permokėti skolos sumos, sąrašas.

Pavyzdžiai:

Kvitą suma = 38,50 EUR

• Klientas sumoka 50 EUR debetine kortele, nes nori gauti grąžą grynaisiais (permokėjimas).
• Klientas sumoka 50 EUR grynaisiais ir gauna 11,50 grąžos (grąžos grąžinimas).

Kai kuriose šalyse šios operacijos neleidžiamos (tai reiškia, kad jos negali būti siunčiamos į fiskalinę sistemą).

Tai reiškia, kad mokėjimo sumos („payment.amount“) visada turi atitikti pozicijų bendrąją sumą („grossValue“ visų „positions“) ir negali būti perduodamos neigiamos mokėjimo sumos.

Atitinkamoje šalyje palaikomų verslo sandorių tipų sąrašas.

Šios verslo operacijos gali būti naudojamos atitinkamoje šalyje, priešingai nei notSupportedBusinessTransactionTypes.

Atitinkamoje šalyje nepalaikomų (arba neleidžiamų) verslo atvejų tipų sąrašas.

Šios verslo operacijos negali būti naudojamos atitinkamoje šalyje ir turėtų būti blokuojamos pirminėje sistemoje bei neperduodamos fiskalizacijos paslaugai.

Išsami informacija apie atitinkamoje šalyje palaikomas PVM normas.

Šis masyvas apima šiuos duomenis:

• PVM tarifas: „vatPercent“ / „vatPercent2“
• Vidinis identifikatorius, kuriuo susietas atitinkamas PVM tarifas: „vatIdentification“
• PVM tarifo pavadinimas: „caption“ / „caption_EN“
• istoriniai PVM tarifai, nurodant galiojimo laikotarpį („validFrom“ – „validTo“)

„not mandatory“ – klientų ekrano rodymas nėra privalomas (nėra įpareigojimo).

„mandatory (no-RF)“ – klientų ekranas yra privalomas, tačiau jis nėra valdomas per „RetailForce“ tarpinę programinę įrangą. Valdymas vyksta automatiškai per atitinkamą fiskalinę sistemą (pvz., automatiškai per fiskalinį spausdintuvą)

„privaloma (RF)“ – klientų ekranas privalo būti įrengtas ir turi būti valdomas per „RetailForce“ tarpinę programinę įrangą. 

• Kliento ekrano valdymas vykdomas naudojant funkciją: POST /api/v1/transactions/display/{clientId}

„not allowed“ – kliento ekrano naudojimas šioje šalyje yra draudžiamas.

Nurodo, ar įvesties įrenginiai turi būti registruojami atitinkamoje šalyje („true“ / „false“).

Įvesties įrenginiai nėra savarankiškos (stand-alone) registravimo sistemos. Daugiau informacijos rasite: Elektroninių registravimo sistemų (EAS) architektūros

„true“ – atitinkamoje šalyje galioja reikalavimas vesti techninį žurnalą (audito žurnalą) (šiuo atveju įtrauktas į RF licenciją).

• šiuo atveju techniniai įvykių įrašai turi būti siunčiami per
  • POST /api/v1/transactions/auditlog arba
  • POST /api/v1/transactions/storeDocument („documentType“: „[1002] = AuditLog“)
    į fiskalizacijos paslaugą.

„false“ – nėra reikalavimo vesti techninį žurnalą (neįtraukta į licenciją).

• techniniai įvykiai GALI būti registruojami, tačiau tai nėra privaloma.

„true“ – atitinkamoje šalyje privaloma registruoti dokumento pakartotinį spausdinimą.

• Iššaukti vieną iš šių:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid}, arba

  • PUT /api/v1/transactions/reprintDocument

    privaloma.

„false“ – dokumento pakartotinis spausdinimas neprivalomai registruojamas.

„terminal“ – dokumento kopija gali būti atspausdinta tik toje pačioje kasoje, kurioje buvo išduotas originalus dokumentas.

„store“ – dokumento pakartotinis spausdinimas leidžiamas tik toje pačioje parduotuvėje, kurioje buvo išduotas originalus dokumentas.

• Pakartotinio spausdinimo funkcijos, apimančios kelis filialus, įgyvendinimas turi būti atliekamas pagrindinėje sistemoje.

„all“ – dokumento pakartotinis spausdinimas leidžiamas tiek kitoje kasoje, tiek kitame padalinyje.

• Pakartotinio spausdinimo funkcijos įgyvendinimas keliose parduotuvėse turi būti įgyvendintas iš ankstesnės sistemos.

„true“ – kartą per dieną turi būti sukurtas dienos uždarymas (Z ataskaita).

• Dienos ataskaita:
  • POST /api/v1/transactions/storeDocument
  • „documentType“: „[99] = EndOfDay“

„false“ – nėra reikalavimo rengti kasdienę dienos ataskaitą.

Nurodo laikotarpį nuo kasos atidarymo, per kurį turi būti atliktas dienos uždarymas (pvz., per 24 val.).

"-1" – nenustatyta.

Nurodo, ar viename kvite (dokumente) galima vienu metu registruoti pardavimus ir grąžinimus.

„oneReceiptAllowed“ – leidžiama (pardavimai ir grąžinimai gali būti pateikiami kartu viename kvite).

• Pardavimai:
  • „positions“ (0 arba 1 tipo) su teigiamomis vertėmis,
• grąžinimai:
  • „positions“ (tipas 0 arba 1) su neigiamomis vertėmis ir 
  • jei taikoma, nustatytas „documentReference“.

„oneReceiptAllowedVat“ – kol PVM suma išlieka teigiama, pardavimai ir grąžinimai gali būti įrašomi viename bendrame dokumente.

„multiReceipt“ – pardavimai ir grąžinimai privalo būti pateikiami skirtinguose dokumentuose.

• Prieš perduodant duomenis fiskalinės sistemos tarnybai, pirminė sistema turi automatiškai suskirstyti pardavimus ir grąžinimus į skirtingas operacijas.

„NoReturnAllowed“ – atitinkamoje šalyje grąžinimų tvarkymas per fiskalinę sistemą nėra galimas. Šiose šalyse grąžinimai dažnai tvarkomi naudojant buhalterijos ar panašias formas.

Kur galima grąžinti įsigytus prekių vienetus?

„terminal“ – prekės gali būti grąžinamos tik toje pačioje kasoje (išduodant kvitą), kurioje buvo atliktas pirminis pardavimas.

„store“ – prekės gali būti grąžinamos tik toje pačioje parduotuvėje (išduodant kvitą), kurioje buvo atliktas pirminis pardavimas.

„all“ – prekės gali būti grąžinamos ir kitose parduotuvėse.

Kvitų nuoroda grąžinant prekes

„single“ – grąžinant prekes leidžiama nurodyti tik vieną pirminį dokumentą (grąžinamų prekių ar paslaugų pardavimo kvitą).

• „documentReference“ leidžiama nurodyti tik vieną pirminį dokumentą, t. y.
• nuoroda pozicijos lygiu („positionReference“) leidžiama tik į vieną pirminį dokumentą.

„multiple“ – grąžinant prekes leidžiama nurodyti kelis pirminius dokumentus (kelis pardavimo dokumentus, jei grąžinamos kelios prekės ar paslaugos iš kelių pirkimų).

• „documentReference“ leidžiama nurodyti kelis pirminius dokumentus, arba
• nuoroda į atitinkamą pirminį dokumentą per „positionReference“ atskiroje grąžinimo pozicijoje.

Nurodo, ar elementas „fiscalDocumentNumber“ atitinkamos šalies „fiscalResponse“ turi būti atspausdintas ant dokumentų.

• Iš ankstesnės sistemos perduoti dokumentų numeriai ignoruojami. Fiskalinė sistema (pvz., spausdintuvas) pati suteikia atitinkamą dokumento numerį / dokumento ID.

„true“ – atitinkamoje šalyje leidžiami priedai (kainų priedai) prekėms ar paslaugoms.

• Priedai:
  • „positions.discounts“ su NEIGIAMOMIS vertėmis

„false“ – kainų priedai neleidžiami.

„true“ – kasoje gali būti mokymo modulis.

• Treniruočių režimas:
  • „isTraining“: true

„false“ – kasos aparatas negali turėti mokymo/demonstracinio režimo.

„true“ – atskirų pozicijų suma skaičiuojama remiantis grynąja suma (netValue) (pvz., Kvebekas/Kanada).

„false“ – atskirų pozicijų suma skaičiuojama remiantis bruto suma (grossValue) (standartas).

„true“ – įrašytos, bet vėliau į dokumentą neįtrauktos pozicijos turi būti perduotos duomenų pakete (JSON).

„false“ – užregistruotos, bet vėliau į dokumentą neįtrauktos pozicijos neturi būti perduodamos.

Pastaba: daugiau informacijos apie tai rasite straipsnyje „Ištrintų prekių pozicijų perdavimas“

RFI / 

INFO

Nurodo pradinio dokumento tipą atitinkamoje šalyje.

Tai aktualu tik tuo atveju, jei pirminė sistema inicijavimo metu NENAUDOJA funkcijos GET /api/v1/transactions/document/{clientId}/start ir pati sukuria atitinkamą pradinį dokumentą.

Atitinkamoje šalyje palaikomų išmokėjimo tipų sąrašas.

„supportedPayOutTypes“ nurodyti tipai gali / turi būti nurodyti išmokėjimams („documentType“: „[10] = PayOut“ ir „businessTransactionType“: „[10] = PayOut“).

Nurodo, ar PVM tarifai apskaičiuojami naudojant atitinkamą šalies fiskalizacijos modulį.

„true“ – fiskalinis modulis (fiskalinė paslauga) apskaičiuoja PVM tarifus.

„false“ – PVM tarifus turi apskaičiuoti kasos aparatas.

Nurodo, ar ir kiek skaičių po kablelio turi būti įtraukta į JSON dokumentą, siunčiamą į Fiscal Middleware, kai siunčiamos sumos / bendros sumos.

Taikoma visiems duomenims apie vertes duomenų pakete („GrossValue“, „NetValue“, „TaxValue“, „Amount“,...)