Tip

INFO

ukazuje na odgovarajuću zemlju.

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

INFO

INFO

Određuje da li je u nekoj zemlji potrebna certifikacija komponente fiskalizacije, ili šta treba biti certificirano.

"mandatory" - Certifikacija nadređenog sistema (npr. kase) je obavezna. U ovom slučaju, kasa mora proći proces certifikacije ili odobrenja.

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

"notNecessary" - Nije potrebna certifikacija prethodnog sistema.

RFI

"true" - u odgovarajućoj zemlji, podaci se moraju slati red po red, npr. na fiskalnu blagajnu.

• trenutno nije podržano

"false" - Interfejs zasnovan na dokumentu (bez štampanja red po red).

• Implementacija između gornjeg sistema i Usluge fiskalizacije zasniva se na standardnim API krajnjim tačkama.

INFO

Određuje tip fiskalizacije.

"fiscalPrinter" - Fiskalizacija se zasniva na certificiranom fiskalnom štampaču ili certificiranom fiskalnom kasnom sistemu.

• To znači da je, pored sistema RetailForce, potreban fiskalni štampač. On se možda mora kupiti od lokalnog dobavljača.

"online" - Fiskalizacija putem online sistema lokalnih poreznih vlasti.

• nije potrebna dodatna hardverska komponenta.

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

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

"signatureWithOnline" - Fiskalizacija kreiranjem potpisa i slanjem podataka online poreznim vlastima.

• Kombinacija prethodna dva tipa.

RFI

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

"local" - lokalna instalacija fiskalnog middlewarea (lokalno na POS sistemu, na serveru prodavnice, itd.)

• API pozivi se mogu uputiti lokalno instaliranoj usluzi fiskalizacije:
  • http://localhost:7678/ u slučaju REST implementacije, ili
  • poziv metode u slučaju nuget implementacije.

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

• API pozivi se mogu uputiti Cloud servisu za fiskalizaciju.

RFI

Određuje koje operativne sisteme/platformu 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 servis (REST implementacija)

INFO

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

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

RFI

Tipovi dokumenata koji se trebaju "fiskalizirati" u odgovarajućoj zemlji. Na primjer, moraju biti obrađeni propisanom hardverskom komponentom, potpisani itd.

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

Ove vrste dokumenata MORAJU se proslijediti službi za fiskalizaciju u odgovarajućoj zemlji, pod uslovom da ih podržava izvorni sistem ("blagajna").

RFI

Spisak tipova dokumenata podržanih u svakoj zemlji.

Pored "fiscalDocumentTypes", vrste dokumenata navedene pod "supportedDocumentTypes" MOGU se slati fiskalizacijskoj službi.

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

RFI

Spisak tipova dokumenata koji nisu podržani u dotičnoj zemlji.

"DocumentTypes" navedeni pod "notSupportedDocumentTypes" ne mogu se prenijeti na servis za fiskalizaciju u odgovarajućoj zemlji.

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

Ako se "notSupportedDocumentType" pošalje fiskalizacijskoj službi, ona će odgovoriti porukom o grešci ("documentType not supported!").

Gornji sistem ne bi trebao dozvoliti ove tipove dokumenata u relevantnoj zemlji.

RFI

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

Ove metode plaćanja se mogu koristiti u odgovarajućoj zemlji.

Gornji sistem bi trebao korisniku blagajne ponuditi samo načine plaćanja koji su podržani u dotičnoj zemlji.

RFI

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

Gornji sistem treba da sakrije 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 dozvoljeno plaćanje viška iznosa.

Primjeri:

Ukupno na računu = 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.

Ove transakcije nisu dozvoljene u nekim zemljama (što znači da se ne mogu poslati fiskalizacijskom sistemu).

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

Lista tipova poslovnih slučajeva podržanih u svakoj zemlji.

Ovi poslovni slučajevi se mogu koristiti u odgovarajućoj zemlji, za razliku od notSupportedBusinessTransactionTypes.

RFI

Lista tipova poslovnih slučajeva koji nisu podržani (ili nisu dozvoljeni) u dotičnoj zemlji.

Ovi poslovni slučajevi se ne mogu koristiti u dotičnoj zemlji i trebaju biti suzbijeni od strane izvornog sistema i ne bi se smjeli prenositi 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"
• Unutrašnji ID koji se koristi za mapiranje odgovarajuće stope PDV-a: "vatIdentification"
• Naziv stope PDV-a: "caption" / "caption_EN"
• Historijske stope PDV-a s detaljima o važnosti ("validFrom" - "validTo")

RFI

RFI

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

"obavezno (bez-RF)" - Prikaz kupca je obavezan, ali se ne kontroliše putem RetailForce Middleware-a. Kontrola se vrši automatski putem odgovarajućeg sistema fiskalizacije (npr. automatski putem fiskalne printera).

"obavezno (RF)" - Obavezno je koristiti prikaz za kupca i on se kontrolira putem RetailForce middlewarea.

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

"nije dozvoljeno" - Korištenje kupčevog displeja je zabranjeno u ovoj zemlji.

RFI

Određuje da li ulazni uređaji moraju biti registrovani u odgovarajućoj zemlji ("true" / "false").

Uređaji za unos nisu samostalni sistemi za snimanje. Za više informacija pogledajte: Arhitekture elektronskih sistema za snimanje (EAS)

RFI

"true" - u odgovarajućoj zemlji postoji obaveza vođenja tehničkog dnevnika (log evidencije) (u ovom slučaju uključen u RF licencu).

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

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

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

RFI

"true" - u odgovarajućoj zemlji, ponovni otisak dokumenta mora se obavezno evidentirati.

• Pozovite jednu od sljedećih opcija:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid}, ili

  • PUT /api/v1/transactions/reprintDocument

    obavezno.

"false" - Ponovno izdavanje dokumenta ne mora biti obavezno evidentirano.

RFI

"terminal" - Dokument se može ponovo ispisati samo na istom fiskalnom računaru na kojem je izdat originalni dokument.

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

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

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

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

RFI

"true" - dnevno zatvaranje (Z-izvještaj) mora se generisati jednom dnevno.

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

"false" - nema zahtjeva za dnevno zatvaranje.

RFI

Oznaka vremenskog perioda od posljednjeg dnevnog zatvaranja u kojem sljedeće dnevno zatvaranje mora biti izvršeno (npr. u roku od 24 sata). Nakon isteka ovog perioda, usluga fiskalizacije odbacuje svaki dokument osim dnevnog zatvaranja ("documentType": "[99] = EndOfDay") sa HTTP statusom 400, sve dok se ne pohrani dnevno zatvaranje. Prije prvog dnevnog zatvaranja ne postoji ograničenje.

"-1" - nije postavljeno.

RFI

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

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

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

"oneReceiptAllowedPerVatRate" - prodaja i povrat mogu se evidentirati 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 slanja podataka usluzi fiskalizacije, nadređeni sistem mora automatski razdvojiti prodaju i povrate u različite transakcije.

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

RFI

Gdje se mogu vratiti kupljene stavke?

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

"trgovina" - Artikli se mogu vratiti samo u istu poslovnicu/trgovinu (izdavanje vaučera) u kojoj je izvršena originalna prodaja.

"all" - Artikli se također mogu vratiti u različite poslovnice iste kompanije.

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

• "documentReference" je dozvoljeno samo za jedan preliminarni dokument, ili
• referenca na nivou stavke ("positionReference") dozvoljena 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 robe iz više kupovina).

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

RFI

Određuje da li element "fiscalDocumentNumber" iz "fiscalResonse" odgovarajuće zemlje mora biti isprintan na dokumentima.

• Brojevi dokumenata preneseni iz gornjeg sistema se zanemaruju. Fiskalni sistem (npr. štampač) samostalno dodjeljuje odgovarajući broj dokumenta/ID dokumenta.

RFI

"true" - u odgovarajućoj zemlji dozvoljeni su dodatni troškovi na robu ili usluge.

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

"false" - Dodatne naknade na cijenu nisu dozvoljene.

RFI

Pokazuje da li servis za fiskalizaciju za odgovarajuću zemlju podržava režim obuke / demo

"true" - dozvoljeno.

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

"false" - trening / demo mod nije podržan. Usluga fiskalizacije odbacuje svaki dokument sa "isTraining": true (greška pri validaciji "Trening račun nije dozvoljen u ovoj zemlji.").

RFI

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

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

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

RFI

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

Relevantno samo ako gornji sistem NE koristi funkciju GET /api/v1/transactions/document/{clientId}/start tokom inicijalizacije i sam generiše odgovarajući početni dokument.

RFI

Lista tipova isplata podržanih u relevantnoj zemlji.

Elementi navedeni pod "supportedPayOutTypes" mogu/moraju biti specificirani za isplate ("documentType": "[10] = PayOut" i "businessTransactionType": "[10] = PayOut").

RFI

RFI

Indikator da li stope PDV-a obračunava odgovarajući modul fiskalizacije zemlje.

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

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

RFI

RFI

RFI

RFI

Određuje da li i koliko decimalnih mjesta mora biti uključeno u JSON-dokument za fiskalni middleware prilikom slanja iznosa / ukupnih iznosa.

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

RFI

RFI

RFI

RFI