Tip

INFO

označava odgovarajuću zemlju.

Ako se putem GET /api/v1/information/client/{clientId}/countryProperties upiti fiskalne karakteristike zemlje, određuje se zemlja dodijeljena tom klijentu.

INFO

INFO

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.

RFI

"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 dokumentu (bez ispisa redak po redak).

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

INFO

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 (ovlašteni izdavač certifikata).

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

• Kombinacija prethodna dva tipa.

RFI

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 uputiti 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 se mogu upućivati usluzi za fiskalizaciju u oblaku.

RFI

Određuje 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)

INFO

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

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

RFI

Vrste dokumenata koje se trebaju "fiskalizirati" u dotičnoj zemlji. Na primjer, moraju se 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").

RFI

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).

RFI

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 te vrste dokumenata u relevantnoj zemlji.

RFI

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.

RFI

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.

RFI

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

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 u sustav fiskalizacije).

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

RFI

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.

RFI

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 potisnuti od strane izvornog sustava, a ne preneseni na uslugu fiskalizacije.

RFI

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")

RFI

RFI

"nije obavezno" - Prikaz kupcu 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 sloja.

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

"ne dopušteno" - Korištenje kupovnog zaslona zabranjeno je u ovoj zemlji.

RFI

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)

RFI

"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 zabilježiti, ali ne moraju.

RFI

"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 obavezno evidentirati.

RFI

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

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

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

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

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

RFI

"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.

RFI

Označava vremenski period od posljednjeg dnevnog zatvaranja unutar kojeg se sljedeće dnevno zatvaranje mora obaviti (npr. unutar 24 sata). Nakon isteka tog perioda, usluga fiskalizacije odbacuje svaki dokument osim dnevnog zatvaranja ("documentType": "[99] = EndOfDay") s HTTP statusom 400 dok se ne pohrani dnevno zatvaranje. Prije prvog dnevnog zatvaranja ne primjenjuje se nikakvo ograničenje.

"-1" - nije postavljeno.

RFI

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,
• Povrat:
  • "positions" (vrsta 0 ili 1) s negativnim vrijednostima i
  • postavljena "documentReference".

"oneReceiptAllowedPerVatRate" - prodaja i povrat mogu se zabilježiti na jednoj (isto) računu sve dok bruto ukupni iznosi svih stopa PDV-a na računu imaju isti predznak (svi pozitivni ili svi negativni).

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

• Prije prijenosa 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.

RFI

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.

RFI

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
• pozivanje na razini stavke ("positionReference") dopušteno je samo za jedan preliminarni 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.

RFI

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

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

RFI

"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.

RFI

Označava je li servis fiskalizacije za dotičnu zemlju podržan za način rada učenja / demonstracije

"true" - dopušteno.

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

"false" - način obuke / demo načina nije podržan. Usluga fiskalizacije odbacuje svaki dokument s "isTraining": true (pogreška validacije "Obrazac za obuku nije dopušten u ovoj zemlji.").

RFI

"true" - Zbroj 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).

RFI

"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.

RFI

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.

RFI

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").

RFI

RFI

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.

RFI

RFI

RFI

RFI

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 specificacije vrijednosti u korisnom teretu ("GrossValue", "NetValue", "TaxValue", "Amount" itd.)

RFI

Ova zastavica označava je li u relevantnoj zemlji potrebno označiti uplate namijenjene kao napojnice. Ako je navedeno više uplata, ona kojom kupac plaća napojnicu mora biti označena zastavicom "isTip" postavljenom na 'true'.

Primjer: Ukupni iznos na računu je 46,30 EUR; kupac plaća

• EUR 30 kreditnom karticom i
• EUR 20 (ukupno EUR 50), od čega je EUR 3,70 napojnica.
  U tom slučaju gotovinski iznos mora biti označen zastavicom "isTip": 'true'.

RFI

RFI

RFI