označava odgovarajuću zemlju.

Ako se fiskalne osobine zemlje upitaju putem GET /api/v1/information/client/{clientId}/countryProperties, navodi se zemlja dodijeljena odgovarajućem klijentu.

Određuje je li u nekoj zemlji potrebna certifikacija komponente fiskalizacije ili što se mora certificirati.

"mandatory" - Certifikacija nadređenog sustava (npr. blagajne) je obavezna. U tom slučaju blagajna mora proći postupak certifikacije ili odobrenja.

"miniPOS" - Certifikacija je obavezna, ali se ispunjava već certificiranom komponentom koja se može integrirati u RetailForce middleware.

"notNecessary" - Nije potrebna certifikacija prethodnog sustava.

"true" - u dotičnoj zemlji, podaci se moraju slati redak po redak, npr. na fiskalnu blagajnu.

• trenutno nije podržano

"false" - Sučelje temeljeno na dokumentima (bez ispisa redak po redak).

• Implementacija između gornjeg sustava i usluge fiskalizacije temelji se na standardnim API krajnjim točkama.

Određuje vrstu fiskalizacije.

"fiscalPrinter" - Fiskalizacija se temelji na certificiranom fiskalnom pisaču ili certificiranom sustavu fiskalne blagajne.

• To znači da je, osim sustava RetailForce, potreban fiskalni pisač. Taj se pisač može morati kupiti od lokalnog dobavljača.

"online" - Fiskalizacija putem internetskih sustava lokalnih poreznih vlasti.

• nije potrebna dodatna hardverska komponenta.

"potpis" - Fiskalizacija potpisivanjem podataka o računu pomoću digitalnog certifikata pohranjenog u usluzi za fiskalizaciju.

• U nekim zemljama može biti potrebno pribaviti kvalificirani digitalni certifikat koji izdaje CA (Certificate Authority).

"signatureWithOnline" - Fiskalizacija stvaranjem potpisa i slanjem podataka putem interneta poreznim tijelima.

• Kombinacija prethodna dva tipa.

Određuje koje je okruženje podržano:

"local" - lokalna instalacija fiskalnog middlewarea (lokalno na POS sustavu, na poslužitelju trgovine itd.)

• Pozivi API-ja mogu se upućivati lokalno instaliranoj usluzi fiskalizacije:
  • http://localhost:7678/ u slučaju REST implementacije, ili
  • poziv metode u slučaju implementacije na Nugetu.

"cloud" - fiskalni middleware dostupan je kao hostirana usluga u oblaku na https://fiscalisation.retailforce.cloud/.

• API pozivi mogu se uputiti usluzi za fiskalizaciju u oblaku.

Navodi koje operativne sustave/platformi podržava.

"linux"

• putem Docker kontejnera (REST implementacija)

"windows"

• putem Windows servisa (REST implementacija), ili
• putem nuget implementacije

"ios"

• putem nuget implementacije

"android"

• putem nuget implementacije, ili
• android usluga (REST implementacija)

Navodi koje se pravne zahtjeve podržavaju i njihove verzije.

Npr. za Grčku: "myData v1.x.x"

Vrste dokumenata koje se trebaju "fiskalizirati" u dotičnoj zemlji. Na primjer, one se moraju obraditi propisanom hardverskom komponentom, potpisati itd.

"documentTypes" navedeni pod "fiscalDocumentTypes" automatski se obrađuju (npr. potpisuju) u dotičnoj zemlji od strane službe za fiskalizaciju u skladu sa zakonima o fiskalizaciji.

Ove vrste dokumenata MORAJU se prenijeti usluzi fiskalizacije u dotičnoj zemlji, pod uvjetom da ih podržava nadređeni sustav ("blagajna").

Popis vrsta dokumenata podržanih u svakoj zemlji.

Osim "fiscalDocumentTypes", vrste dokumenata navedene pod "supportedDocumentTypes" MOGU se prenijeti fiskalizacijskoj službi.

Ove vrste dokumenata su takozvani "nefiskalni" dokumenti, tj. oni koji nisu "fiskalizirani" (npr. potpisani).

Popis vrsta dokumenata koje nisu podržane u dotičnoj zemlji.

"DocumentTypes" navedeni pod "notSupportedDocumentTypes" ne mogu se prenijeti na uslugu fiskalizacije u dotičnoj zemlji.

Razlozi za to mogu biti tehnička nemogućnost ili propisi/zakoni specifični za pojedinu zemlju.

Ako se "notSupportedDocumentType" pošalje usluzi fiskalizacije, ona će odgovoriti porukom o pogrešci ("documentType not supported!").

Gornji sustav ne bi trebao dopuštati ove vrste dokumenata u relevantnoj zemlji.

Popis načina plaćanja podržanih (prihvaćenih) u dotičnoj zemlji.

Ove metode plaćanja mogu se koristiti u dotičnoj zemlji.

Gornji sustav trebao bi korisniku blagajne ponuditi samo plaćanja podržana u dotičnoj zemlji.

Popis načina plaćanja koji nisu podržani (ili nisu dopušteni) u dotičnoj zemlji.

Gornji sustav trebao bi sakriti načine plaćanja koji nisu podržani u dotičnoj zemlji.

Popis načina plaćanja (paymentTypes) za koje u dotičnoj zemlji nije dopušteno prekoračenje iznosa dospjele uplate.

Primjeri:

Ukupni iznos računa = 38,50 EUR

• Kupac plaća 50 EUR debitnom karticom jer želi kusur u gotovini.
• Kupac plaća 50 EUR u gotovini i dobiva kusur od 11,50 EUR.

Te transakcije nisu dopuštene u nekim zemljama (što znači da se ne mogu poslati sustavu fiskalizacije).

To znači da iznosi plaćanja ("payment.amount") uvijek moraju odgovarati bruto zbroju stavki ("grossValue" svih "positions") i da se ne smiju prenositi negativni iznosi plaćanja.

Popis vrsta poslovnih slučajeva podržanih u svakoj zemlji.

Ovi poslovni slučajevi mogu se koristiti u dotičnoj zemlji, za razliku od notSupportedBusinessTransactionTypes.

Popis vrsta poslovnih slučajeva koje nisu podržane (ili nisu dopuštene) u dotičnoj zemlji.

Ovi poslovni slučajevi se ne mogu koristiti u dotičnoj zemlji i trebali bi biti blokirani od strane izvornog sustava, a ne prosljeđivati se usluzi fiskalizacije.

Detaljne informacije o stopama PDV-a podržanim u svakoj zemlji.

Ovaj niz sadrži sljedeće informacije:

• Stopa PDV-a: "vatPercent" / "vatPercent2"
• Unutarnji ID koji se koristi za mapiranje odgovarajuće stope PDV-a: "vatIdentification"
• Naziv stope PDV-a: "caption" / "caption_EN"
• Povijesne stope PDV-a s detaljima o važnosti ("validFrom" - "validTo")

"nije obavezno" - Prikaz kupca nije potreban (nema obveze).

"obavezno (bez-RF)" - Prikaz kupca je obavezan, ali se ne kontrolira putem RetailForce Middlewarea. Kontrola se provodi automatski putem odgovarajućeg sustava fiskalizacije (npr. automatski putem fiskalne tiskalice).

"obavezno (RF)" - Obavezno je koristiti zaslon za kupca i on se kontrolira putem RetailForce posredničkog softvera.

• Prikaz za kupca kontrolira se putem funkcije: POST /api/v1/transactions/display/{clientId}

"nije dopušteno" - Korištenje kupčevog zaslona zabranjeno je u ovoj zemlji.

Određuje trebaju li ulazni uređaji biti registrirani u dotičnoj zemlji ("true" / "false").

Ulazni uređaji nisu samostalni sustavi za snimanje. Za više informacija pogledajte: Arhitekture elektroničkih sustava za snimanje (EAS)

"true" - u dotičnoj zemlji postoji obveza vođenja tehničkog dnevnika (log evidencije) (u ovom slučaju uključen u RF licencu).

• U tom slučaju tehnički zapisi događaja moraju se slati usluzi fiskalizacije putem
  • POST /api/v1/transactions/auditlog , ili
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")

"false" - ne postoji obveza vođenja tehničkog dnevnika (nije uključeno u licencu).

• Tehnički događaji MOGU se bilježiti, ali ne moraju.

"true" - u odgovarajućoj zemlji, ponovni ispis dokumenta mora se obavezno zabilježiti.

• Poziv jednog od sljedećih:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid}, ili

  • PUT /api/v1/transactions/reprintDocument

    obavezno.

"false" - Ponovno izdavanje dokumenta ne mora se evidentirati kao obavezno.

"terminal" - Dokument se može ponovno ispisati samo na istom blagajnom terminalu na kojem je izdan izvorni dokument.

"trgovina" - Ponovni ispis dokumenta može se obaviti samo u istoj poslovnici/trgovini u kojoj je izdan i originalni dokument.

• Funkcija ponovnog ispisivanja preko više poslovnica mora biti implementirana u nadređenom sustavu.

"all" - Ponovno ispisivanje dokumenta može se obaviti na drugoj blagajni kao i u drugoj poslovnici / trgovini iste tvrtke.

• Funkciju ponovnog ispisivanja preko više poslovnica mora implementirati nadređeni sustav.

"true" - dnevno zatvaranje (Z-izvješće) mora se generirati jednom dnevno.

• dnevno zatvaranje
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = Kraj dana"

"false" - nema zahtjeva za dnevno zatvaranje.

Označava vremenski period od dnevnog otvaranja blagajne unutar kojeg se mora obaviti dnevno zatvaranje (npr. unutar 24 sata).

"-1" - nije postavljeno.

Navedite mogu li se prodaje i povrat robe istovremeno evidentirati na jednom računu (dokumentu).

"oneReceiptAllowed" - dopušteno (prodaje i povrat mogu biti prikazani pomiješani na jednom računu).

• Prodaja:
  • "positions" (vrsta 0 ili 1) s pozitivnim vrijednostima,
• Vraćanja:
  • "positions" (vrsta 0 ili 1) s negativnim vrijednostima i
  • "documentReference" postavljen.

"oneReceiptAllowedVat" - sve dok iznos PDV-a ostaje pozitivan, prodaja i povrat mogu se evidentirati na jednoj (isto) računu.

"multiReceipt" - Prodaja i povrat moraju biti zabilježeni na različitim računima.

• Prije slanja podataka usluzi fiskalizacije, nadređeni sustav mora automatski razdvojiti prodaju i povrat u različite transakcije.

"NoReturnAllowed" - u dotičnoj zemlji obrada povrata putem sustava fiskalizacije nije moguća. U tim se zemljama povrat često obrađuje putem posebnih obrazaca ili slično u računovodstvenom odjelu.

Gdje se mogu vratiti kupljene stavke?

"terminal" - Artikli se mogu vratiti samo na istom blagajnom mjestu (izdavanje vaučera) na kojem je izvršena izvorna prodaja.

"trgovina" - Artikli se mogu vratiti samo u istu poslovnicu/trgovinu (izdavanje kupona) u kojoj je izvršena izvorna prodaja.

"all" - Artikle je također moguće vratiti u različite poslovnice iste tvrtke.

Referenca dokumenta za povrat

"single" - u slučaju povrata, referenca se može odnositi samo na JEDAN prethodni dokument (prodajni dokument vraćenih usluga ili dobara).

• "documentReference" dopuštena samo za jedan preliminarni dokument, ili
• referenca na razini stavke ("positionReference") dopuštena je samo za jedan pripremni dokument.

"multiple" - u slučaju povrata moguće je navesti više prethodnih dokumenata (više računa za prodaju ako se vraćaju više usluga ili dobara iz više kupnji). 

• "documentReference" na više prethodnih dokumenata, ili
• poziv na odgovarajući prethodni dokument putem "positionReference" na pojedinačnoj stavci povrata.

Određuje treba li se element "fiscalDocumentNumber" iz "fiscalResonse" odgovarajuće zemlje ispisati na dokumentima.

• Brojevi dokumenata preneseni iz nadređenog sustava zanemaruju se. Fiskalni sustav (npr. pisač) samostalno dodjeljuje odgovarajući broj dokumenta/ID dokumenta.

"true" - u dotičnoj zemlji dopušteni su dodatni troškovi na robu ili usluge.

• dodatne naknade:
  • "positions.discounts" s NEGATIVNIM vrijednostima

"false" - Dodatna naplaćivanja cijena nisu dopuštena.

Označava je li u dotičnoj zemlji dopušten način rada za obuku/demo na blagajni

"true" - dopušteno.

• Način obuke:
  • "isTraining": true

"false" - Blagajna ne smije imati način obuke / demonstracije.

"true" - Zbir pojedinačnih stavki izračunava se na temelju neto iznosa (netValue) (npr. Québec/Kanada).

"false" - Zbir pojedinačnih stavki izračunava se na temelju bruto iznosa (grossValue) (zadano).

"true" - Stavke koje su unesene, ali nisu naknadno uključene u dokument, moraju se prenijeti u korisnom teretu (JSON).

"false" - Stavke koje su unesene, ali nisu naknadno uključene u dokument, ne moraju se prenositi.

Određuje vrstu početnog dokumenta u relevantnoj zemlji.

Relevantno samo ako nadređeni sustav NE koristi funkciju GET /api/v1/transactions/document/{clientId}/start tijekom inicijalizacije i samostalno generira odgovarajući početni dokument.

Popis vrsta isplata podržanih u relevantnoj zemlji.

Stavke navedene pod "supportedPayOutTypes" mogu/moraju biti specificirane za isplate ("documentType": "[10] = PayOut" i "businessTransactionType": "[10] = PayOut").

Pokazuje se li stope PDV-a izračunavaju odgovarajući modul fiskalizacije dotične zemlje.

"true" - Modul fiskalizacije izračunava stope PDV-a.

"false" - blagajna mora izračunati stope PDV-a.

Određuje treba li i koliko decimalnih mjesta uključiti u JSON-dokument za fiskalni middleware pri slanju iznosa / ukupnih iznosa.

Primjenjuje se na sve specifikacije vrijednosti u korisnom teretu ("GrossValue", "NetValue", "TaxValue", "Amount" itd.)