Tipas

INFO

nurodo atitinkamą šalį.

Jei „fiscalCountryProperties“ duomenys užklausiami per GET /api/v1/information/client/{clientId}/countryProperties, nurodoma atitinkamam klientui priskirta šalis.

INFO

INFO

Nurodo, ar šalyje reikalaujama fiskalinio komponento sertifikavimo, arba kas turi būti sertifikuota.

„mandatory“ – Priešakinės sistemos (pvz., kasos aparato) sertifikavimas yra privalomas. Šiuo atveju kasos aparatas turi būti sertifikuotas arba patvirtintas.

„miniPOS“ – sertifikavimas yra privalomas, tačiau šį reikalavimą atitinka jau sertifikuotas komponentas, kuris gali būti integruotas į „RetailForce Middleware“.

„notNecessary“ – Ankstesnės sistemos sertifikavimas nereikalingas.

RFI

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

• šiuo metu nepalaikoma

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

• Įgyvendinimas tarp aukštesnio lygio sistemos ir fiskalizacijos paslaugos grindžiamas standartiniais api galiniais taškais.

INFO

Nurodo fiskalizacijos tipą.

„fiscalPrinter“ – fiskalizacija atliekama naudojant sertifikuotą fiskalinį spausdintuvą arba sertifikuotą fiskalinę kasos sistemą.

• Tai reiškia, kad be „RetailForce“ sistemos reikalingas fiskalinis spausdintuvas. Jį gali tekti įsigyti iš vietos tiekėjo.

„online“ – fiskalizacija atliekama naudojant vietos mokesčių institucijų internetines sistemas.

• Papildomos aparatinės įrangos nereikia.

„signature“ – fiskalizacija, kai kvito duomenys pasirašomi naudojant fiskalizacijos paslaugoje saugomą skaitmeninį sertifikatą.

• Kai kuriose šalyse gali prireikti gauti kvalifikuotą skaitmeninį sertifikatą, išduodamą sertifikavimo institucijos (CA).

„signatureWithOnline“ – fiskalizavimas, kuriant parašus ir perduodant duomenis internetu mokesčių institucijoms.

• Minėtų dviejų tipų derinys.

RFI

Nurodo, kokia aplinka yra palaikoma:

„local“ – fiskalinio middleware vietinė instaliacija (vietinė POS sistemoje, parduotuvės serveryje ir pan.)

• API iškvietimai gali būti siunčiami į lokaliai įdiegtą fiskalinę tarpinę programinę įrangą:
  • http://localhost:7678/ REST įgyvendinimo atveju arba
  • metodo iškvietimas, jei naudojamas „nuget“ įgyvendinimas.

„cloud“ – fiskalinis middleware prieinamas kaip nuotolinė debesų paslauga adresu https://fiscalisation.retailforce.cloud/.

• API iškvietimai gali būti siunčiami į „Cloud Fiscalisation Service“.

RFI

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

„linux“

• per „Docker“ konteinerį (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)

INFORMACIJA

Nurodo, kokie teisiniai reikalavimai yra palaikomi, ir jų versijas.

Pvz., Graikijos atveju: „myDATA v1.x.x“

RFI

Dokumentų tipai, kurie atitinkamoje šalyje turi būti „fiskalizuoti“. Pavyzdžiui, jie turi būti apdoroti naudojant nustatytą aparatinę įrangą, pasirašyti ir pan.

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

Šie dokumentų tipai PRIVALOMA perduoti atitinkamos šalies fiskalizacijos tarnybai, jeigu juos palaiko pirminė sistema („kasos aparatas“).

RFI

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

Be „fiscalDocumentTypes“, „supportedDocumentTypes“ sąraše nurodyti dokumentų tipai GALI būti perduodami fiskalizacijos tarnybai.

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

RFI

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

„DocumentTypes“, išvardyti skyriuje „notSupportedDocumentTypes“, negali būti perduodami fiskalizacijos tarnybai atitinkamoje šalyje.

Tai gali būti dėl techninių priežasčių arba konkrečiai šaliai būdingų taisyklių ar įstatymų.

Jei „notSupportedDocumentType“ tipas siunčiamas į fiskalizacijos paslaugą, ji atsakys klaidos pranešimu („documentType not supported!“).

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

RFI

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

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

Pagrindinė sistema kasos aparato naudotojui turėtų siūlyti tik atitinkamoje šalyje palaikomus mokėjimo būdus.

RFI

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

Aukštesnio lygio sistema turėtų ignoruoti atitinkamoje šalyje nepalaikomus mokėjimo būdus.

RFI

Mokėjimo būdų (PaymentType), kurių atveju atitinkamoje šalyje neleidžiama sumokėti didesnės sumos nei priklauso, sąrašas.

Pavyzdžiai:

Kvitą suma = 38,50 EUR

• Klientas sumoka 50 EUR debetine kortele, nes nori grąžą gauti grynaisiais.
• Klientas sumoka 50 EUR grynaisiais ir gauna 11,50 EUR grąžos (grąžinama suma).

Kai kuriose šalyse tokios operacijos neleidžiamos (t. y. negali būti perduotos į fiskalinę sistemą).

Tai reiškia, kad mokėjimo sumos („payment.amount“) visada turi atitikti prekių bendrąją sumą („GrossValue“ visų „positions“) ir negalima pervesti neigiamų mokėjimo sumų.

RFI

Kiekvienoje šalyje palaikomų verslo atvejų tipų sąrašas.

Šie verslo atvejai gali būti naudojami atitinkamoje šalyje, skirtingai nei „notSupportedBusinessTransactionTypes“.

RFI

Verslo atvejų tipų, kurie atitinkamoje šalyje nėra palaikomi (arba neleidžiami), sąrašas.

Šių verslo atvejų negalima naudoti atitinkamoje šalyje, todėl šaltinio sistema turėtų juos pašalinti ir neperduoti fiskalizacijos tarnybai.

RFI

Išsami informacija apie kiekvienoje šalyje palaikomas Vat normas.

Šiame masyve pateikiama ši informacija:

• PVM tarifas: „VatPercent“ / „VatPercent2“
• Vidinis ID, naudojamas atitinkamam PVM tarifui susieti: „VatIdentification“
• Vat tarifo pavadinimas: „caption“ / „Caption_EN“
• Ankstesnės Vat normos su galiojimo duomenimis („ValidFrom“ – „ValidTo“)

RFI

RFI

„neprivaloma“ – kliento vardo rodymas nėra privalomas (nėra įpareigojimo).

„privaloma (be RF)“ – kliento duomenų rodymas yra privalomas, tačiau nėra kontroliuojamas per „RetailForce Middleware“. Kontrolė atliekama automatiškai atitinkamos fiskalinės sistemos (pvz., automatiškai fiskalinio spausdintuvo).

„privaloma (RF)“ – privaloma naudoti kliento ekraną, o jo veikimas kontroliuojamas per „RetailForce Middleware“.

• Kliento ekranas valdomas naudojant funkciją: POST /api/v1/transactions/display/{clientId}

„neleidžiama“ – šioje šalyje draudžiama naudoti kliento ekraną.

RFI

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

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

RFI

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

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

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

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

RFI

„true“ – atitinkamoje šalyje dokumento pakartotinis spausdinimas turi būti įrašomas privalomai.

• Reikia iškviesti vieną iš šių:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, arba

  • PUT /api/v1/transactions/reprintDocument

    privaloma.

„false“ – dokumento pakartotinis spausdinimas neprivalo būti registruojamas kaip privalomas.

RFI

„terminal“ – dokumentą galima perrašyti tik toje pačioje kasoje, kurioje buvo išduotas originalus dokumentas.

„store“ – dokumentą galima atspausdinti tik toje pačioje filialo / parduotuvės vietoje, kurioje buvo išduotas originalus dokumentas.

• Funkcija, leidžianti atspausdinti dokumentą keliuose filialuose, turi būti įgyvendinta aukštesnio lygio sistemoje.

„all“ – dokumento pakartotinis spausdinimas gali būti atliekamas kitoje kasoje, taip pat kitoje tos pačios įmonės filialo ar parduotuvėje.

• Perrašymo funkcija keliuose filialuose turi būti įgyvendinta aukštesnio lygio sistemoje.

RFI

„true“ – kasdienis uždarymas (Z-ataskaita) turi būti generuojamas vieną kartą per dieną.

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

„false“ – kasdienio uždarymo reikalavimas netaikomas.

RFI

Nurodo laikotarpį nuo paskutinio dienos uždarymo, per kurį turi įvykti kitas dienos uždarymas (pvz., per 24 val.). Pasibaigus šiam laikotarpiui, fiskalizacijos paslauga atmeta visus dokumentus, išskyrus dienos uždarymą („documentType“: „[99] = EndOfDay“), su HTTP būsena 400, kol nebus išsaugotas dienos uždarymas. Prieš pirmąjį dienos uždarymą apribojimai netaikomi.

„-1“ – nenustatyta.

RFI

Nurodykite, ar pardavimai ir grąžinimai gali būti registruojami vienu metu kvite (dokumente).

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

• Pardavimai:
  • „positions“ (0 arba 1 tipo) su teigiamomis reikšmėmis,
• Grąžinimai:
  • „positions“ (0 arba 1 tipo) su neigiamomis reikšmėmis ir
  • nustatytas „documentReference“.

„oneReceiptAllowedPerVatRate“ – pardavimai ir grąžinimai gali būti įrašyti į vieną (tą patį) kvitą, jei visų Vat tarifų bendros sumos kvite turi tą patį ženklą (visos teigiamos arba visos neigiamos).

„multiReceipt“ – pardavimai ir grąžinimai turi būti įrašomi į skirtingus kvitus.

• Prieš perduodant duomenis fiskalizacijos tarnybai, pirminė sistema privalo automatiškai suskirstyti pardavimus ir grąžinimus į skirtingas operacijas.

„NoReturnAllowed“ – atitinkamoje šalyje grąžinimų apdorojimas per fiskalizacijos sistemą nėra galimas. Šiose šalyse grąžinimai dažnai tvarkomi naudojant specialias formas ar panašius dokumentus apskaitos skyriuje.

RFI

Kur galima grąžinti įsigytus daiktus?

„terminal“ – prekės gali būti priimtos atgal tik toje pačioje kasoje (kuri išdavė kvitą), kurioje buvo atliktas pirminis pardavimas.

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

„all“ – Prekes taip pat galima grąžinti į kitus tos pačios įmonės filialus.

RFI

Dokumento nuoroda grąžinimų atveju

„single“ – grąžinimo atveju galima remtis tik VIENU ankstesniu dokumentu (grąžinamų paslaugų ar prekių pardavimo dokumentu).

• „documentReference“ leidžiama tik vienam pirminiam dokumentui, arba
• nuoroda prekės pozicijos lygiu („positionReference“) leidžiama tik vienam pirminiam dokumentui.

„multiple“ – grąžinimo atveju galima daryti nuorodas į kelis ankstesnius dokumentus (kelis pardavimo kvitus, jei grąžinamos kelios paslaugos ar prekės iš kelių pirkimų).

• „documentReference“ į kelis ankstesnius dokumentus arba
• nuoroda į atitinkamą ankstesnį dokumentą per „positionReference“ atskiroje grąžinimo pozicijoje.

RFI

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

• Iš aukštesnio lygio sistemos perduoti dokumentų numeriai ignoruojami. Fiskalinė sistema (pvz., spausdintuvas) atitinkamą dokumento numerį / dokumento ID priskiria savarankiškai.

RFI

„true“ – atitinkamoje šalyje leidžiami priedai už prekes ar paslaugas.

• surcharges:
  • „positions.discounts“ su NEIGIAMOMIS reikšmėmis

„false“ – kainų priedai neleidžiami.

RFI

Nurodo, ar atitinkamos šalies fiskalizacijos paslauga palaiko mokymo / demonstracinį režimą

„true“ – leidžiama.

• Mokymo režimas:
  • „IsTraining“: true

„false“ – mokymo / demonstracinis režimas nepalaikomas. Fiskalizacijos paslauga atmeta kiekvieną dokumentą, kuriame „IsTraining“: true (patikrinimo klaida „Šioje šalyje mokymo kvitas neleidžiamas.“).

RFI

„true“ – atskirų prekių suma skaičiuojama remiantis grynąja suma (NetValue) (pvz., Québec/Kanada).

„false“ – atskirų pozicijų suma skaičiuojama remiantis bruto suma (GrossValue) (numatyta reikšmė).

RFI

„true“ – Pozicijos, kurios buvo įvestos, bet vėliau neįtrauktos į dokumentą, turi būti perduotos payload (JSON).

„false“ – Pozicijos, kurios buvo įvestos, bet vėliau neįtrauktos į dokumentą, perduoti nebūtina.

RFI

Nurodo pradinio dokumento tipą atitinkamoje šalyje.

Tai aktualu tik tuo atveju, jei aukštesnio lygio sistema inicializavimo metu NENAUDOJA funkcijos GET /api/v1/transactions/document/{clientId}/start ir pati sukuria atitinkamą pradinį dokumentą.

RFI

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

„supportedPayOutTypes“ sąraše išvardyti elementai gali būti / turi būti nurodyti išmokėjimams („documentType“: „[10] = PayOut“ ir „BusinessTransactionType“: „[10] = PayOut“).

RFI

RFI

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

„true“ – Vat tarifus apskaičiuoja fiskalinis modulis.

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

RFI

RFI

RFI

RFI

Nurodo, ar ir kiek dešimtainių skaičių turi būti įtraukta į JSON dokumentą, siunčiamą į fiskalinę middleware programinę įrangą, siunčiant sumas / bendras sumas.

Applies to all value specifications in the payload („GrossValue“, „NetValue“, „TaxValue“, „Amount“ and so on)

RFI

RFI

RFI

RFI