HrFiskalizator - File API referenca

Općenito

Za rad u file načinu, postavka Čekanje na datoteku mora biti aktivan. ✅

Program čeka na kreiranu ili promijenjenu datoteku definiranu postavkom Datoteka sa zadatkom i vraća odgovore u datoteku definiranu postavkom Datoteka sa odgovorom.

ℹ️ Radi očuvanja kompatibilnosti sa Wrapperom, neke funkcije F1.0 vračaju odgovore i u datoteke sa imenima koje je koristio Wrapper.

Format datoteke sa zadatkom

Prvi red: naredba (zadatak)
Redovi 2+: dodatni parametri (ovisno o naredbi)
Red 3: XML datoteka za slanje (ili naziv datoteke)
Red 4: (opcionalno) ime datoteke za povrat podataka

Emulacija HTTP poziva

Svi pozivi opisani pod "Serverski način rada" su podržani kroz sljedeči format).

Za ove pozive Čekanje na Http zadatak (u tabu HTTP Server) mora biti aktivan. ✅

Prvi red: HTTP + eventualno :NOENCODEPOST ako je tako definirano za pojedinu naredbu
Query istovjetan pozivu servera
POST sadržaj ako postoji (Može biti recimo json ili link na file) . vidi primjere u nastavku
MIME oznaka http poziva (recimo text/xml)

Encoding: Sve ulazne text datoteke moraju biti UTF-8 encoded. Svi odgovori su plain text (UTF-8).

ℹ️ Osim binarnih datoteka (pdf, images, etc...)

Program ostavlja dovoljno vremena (200ms) matičnoj aplikaciji za uspješan upis podataka. Datoteka sa zadacima je zaključana za brisanje ali ne i za pisanje.

ℹ️ Večina funkcionalnosti nije opisana na ovoj stranici jer se obavlja kroz sustav plugina.

Za informacije proučite "Brzi uvodi" na glavnoj stranici.

EXIT

Gasi program. Korisno za pokretanje i zatvaranje iz korisničke aplikacije.

Povratna datoteka se ne kreira.

PING

Provjera radi li program.

Odgovor: OK ili povrata nema.

ECHO

Provjera može li program komunicirati sa serverom Porezne uprave.

Odgovor: True ili povrata nema.

GETSERVER

Provjera je li program usmjeren na Produkcijski ili Testni server PU.

Odgovor: Produkcijski ili Testni

GETHRFVERSION

Vraća verziju učitanog programa.

DOHVATIVRIJEME (VRIJEME)

Vraća trenutno sistemsko vrijeme.

Odgovor: 23.09.2016T19:13:35

Fiskalizacija 1.0

RACUNZAHTJEV (RZ) Fiskalizacija

Slanje računa na fiskalizaciju.

Format datoteke sa zadatkom

Red	Sadržaj
1	`RZ`
2	(prazan red)
3	R1234.xml — XML datoteka za slanje
4	R1234.txt — (opcionalno) ime datoteke za povrat

Primjer XML datoteke:

Odgovor (uspijeh)

Red	Sadržaj
1	69db925d-f967-4fb8-b482-7e2fb8f328f8 — UID
2	cdda222a-9df7-496f-94c0-aa4704ad6f35 — JIR
3	07.10.2016T15:07:37 — Vrijeme iz datoteke primljene od PU
4	c93a13d1092f4f5c385f391ab78a75ba — ZKI

Odgovor (greška)

Red	Sadržaj
1	(prazan red)
2	(prazan red)
3	(prazan red)
4	c93a13d1092f4f5c385f391ab78a75ba — ZKI
5	Poruka greške

U slučaju greške, moguće je da bude vraćena samo poruka greške ili da ne bude vraćena nikakva poruka — gotovo sigurno se radi o pogrešno formatiranoj XML poruci.

RACUNZAHTJEVTXT (RZTXT) TXT format

Konverzija i slanje TXT datoteke sa podacima. Program TXT pretvara u XML i šalje po pravilima RACUNZAHTJEV.

Format datoteke

Red	Sadržaj
1	`RZTXT`
2	(prazan red)
3	R1234.txt — TXT datoteka sa podacima
4	R1234odg.txt — (opcionalno) ime datoteke za povrat

Primjer TXT datoteke:

ℹ️ Pažnja: Za razliku od Wrappera koji je više poreza i naknada razdvajao znakom *, HrFiskalizator ih razdvaja znakom &.
Međutim, ako bude upotrijebljen i znak * HrFiskalizator će uspjeti parsirati txt datoteku.

HrFiskalizator podržava i dokumente NAPOJNICAZAHTJEVTXT,PROMIJENINACPLACZAHTJEVTXT,PROMIJENIPODTKERACUNAZAHTJEVTXT

Detalji na testnom interejsu HrFiskalizatora. (TESTOVI FISKALIZACIJE 1.0)

RACUNPROVJERAZAHTJEV (RPZ) Provjera

Provjera ispravnosti računa (ne fiskalizira nego provjerava ispravnost).

Ne provjerava dali je račun fiskaliziran u CISu.

Isti parametri kao RACUNZAHTJEV. Razlika je samo u naredbi.

Odgovor: UUID + rezultat provjere (npr. "Poruka je ispravna." ili opis greške).

RACUNPROVJERAZAHTJEVTXT TXT format

Istovjetno kao RACUNPROVJERAZAHTJEV.

Osim što prethodno konvertira TXT datoteku u XML.

Podaci za konverziju su isti kao za RACUNZAHTJEVTXT

PRATECIDOKUMENTIZAHTJEV (PDZ UKINUTO 01.01.2026

Slanje pratećeg dokumenta. Svi parametri istovjetni kao kod RACUNZAHTJEV.

RACUNPDZAHTJEV (RPDZ) UKINUTO 01.01.2026

Slanje računa za prateći dokument. Svi parametri istovjetni kao kod RACUNZAHTJEV.

PROMIJENINACPLACZAHTJEV

Izmjena načina plaćanja na već fiskaliziranom računu. Detalji na stranici Server API-ja.

PROMIJENINACPLACZAHTJEVTXT TXT format

Istovjetno kao PROMIJENINACPLACZAHTJEV.

Osim što prethodno konvertira TXT datoteku u XML.

NAPOJNICAZAHTJEV od v60

Slanje napojnice nakon uspješne fiskalizacije. Svi parametri istovjetni kao kod RACUNZAHTJEV.

Detalji na stranici Server API-ja.

NAPOJNICAZAHTJEVTXT TXT format od v60

Istovjetno kao NAPOJNICAZAHTJEV.

Osim što prethodno konvertira TXT datoteku u XML.

PROMIJENIPODTKERACUNAZHTJEV od v60

Izmjena OIBA primatelja ili načina plačanja na več poslanom računu.

Detalji na testnom interejsu HrFiskalizatora. (TESTOVI FISKALIZACIJE 1.0)

PROMIJENIPODTKERACUNAZHTJEVTXT TXT format od v60

Istovjetno kao PROMIJENIPODTKERACUNAZHTJEV.

Osim što prethodno konvertira TXT datoteku u XML.

GENERIRAJUID (GUID)

Generira jedinstveni broj (UUID).

GENERIRAJZKI (GZKI)

Izračun ZKI zaštitnog koda identifikacije.

Zahtijeva 6 parametara u datoteci:

Red	Sadržaj	Primjer
1	Naredba	`GENERIRAJZKI`
2	OIB	`17052038498`
3	Formatiran DatumVrijeme	`23.09.2016 19:13:30`
4	Broj računa	`2571`
5	Broj poslovnice	`1`
6	Broj naplatnog uređaja	`1`
7	Iznos računa (točka kao separator)	`200.00`

Odgovor: Izračunati ZKI broj.

QR kod i barkod

QRCODE / CREATEBARCODE

Generiranje QR koda ili PDF417 barkoda.

Format datoteke (od verzije 64)

Red	Sadržaj
1	`CREATEBARCODE`
2	`QRCODE` ili `PDF417`
3	Tekst za konverziju (ili `file=putanja.txt`)
4	Dimenzije: `420x140` (širina x visina)
5	Ime datoteke: `test.png`

Napomene:

Sekvenca \r\n u textu tretira se kao novi red.
Ako text počinje sa file=, učitava se iz datoteke.
Ako nije upisana cijela putanja, datoteka se kreira u folderu HrFiskalizatora.
Podržani formati: png, jpg, bmp, gif.

Detaljniji opis pogledajte na stranici Server API-ja.

Validacija i konverzija

PEPPOLVALIDATOR od v70

Provjera UBL XML dokumenata putem PEPPOL API-ja.

Red	Sadržaj
1	`http`
2	`app/PEPPOLVALIDATOR?vesid=org.oasis-open:invoice:2.1`
3	`file=C:/hrfiskalizator/racun.xml`
4	`text/xml`

XSD provjera eRačuna od v76

Provjera eRačuna putem lokalnih XSD datoteka.

Red	Sadržaj
1	`http`
2	`app/eizvjestavanje/xml?action=TESTIRAJLOGIKU&soapaction=Invoice`
3	`file=C:/hrfiskalizator/Invoice.xml`
4	`text/xml`

Za JSON: zamijenite xml sa json u URL-u.

XMLVALIDATORLOCALXSD od v76

Provjera XML dokumenata Fiskalizacije 2.0. Vraća opsežan opis grešaka.

Red	Sadržaj
1	`http`
2	`app/XMLVALIDATORLOCALXSD`
3	`file=C:/hrfiskalizator/file.xml`
4	`text/xml`

Za jednostavan JSON odgovor: app/XMLSIMPLEVALIDATOR.

JSONTOXML

Konverzija JSON dokumenata Fiskalizacije 2.0 u XML.

Red	Sadržaj
1	`http`
2	`app/JSONTOXML?clean`
3	`file=C:/hrfiskalizator/file.json`
4	`text/html`

ERACUN2EIZVJESTAVANJE

Konverzija Invoice u formate za eIzvještavanje.

Red	Sadržaj
1	`http`
2	`app/eizvjestavanje/xml?action=ERACUN2EIZVJESTAVANJE&soapaction=Invoice&vrstadokumenta=I`
3	`file=C:/hrfiskalizator/Invoice.xml`
4	`text/html`

Parametar vrstadokumenta: I (izlazni), M, IR, NAPLATA, ODBIJANJE, U (ulazni).

Pretrage

KPDSEARCH od v78

Pretraga KPD specifikacija po NAME, CODE ili SECTOR.

Red	Sadržaj
1	`http`
2	`app/KPDSEARCH?trazipo=NAME&pojam=kosilic&limit=10`
3	(prazno)
4	`text/xml`

JMSEARCH od v78

Pretraga oznaka jedinice mjera.

Red	Sadržaj
1	`http`
2	`app/JMSEARCH?pojam=komad&limit=10`
3	(prazno)
4	`text/xml`

GETMPSFOROIB od v89

Dohvat podataka o informacijskom posredniku AMS sustavu za pojedini OIB.

Red	Sadržaj
1	`http`
2	`app/GETMPSFOROIB?oib=xxxxxxxxxxx`
3	(prazno)
4	`text/html;charset=UTF-8`

Pomoćne funkcije

FILETOBASE64STRING od v78

Učitava bilo koji file (uključujući binarne) i sprema BASE64 string u odgovor.

Red	Sadržaj
1	`http`
2	`app/FILETOBASE64STRING?filename=mojFile.pdf`
3	(prazno)
4	`text/xml`

Korisno za ubacivanje PDF privitaka kao BASE64 string u JSON ili XML.

INVOICE KREATOR

Generiranje HTML-a ili PDF-a sa vizualizacijom eRačuna.

Red	Sadržaj
1	`http`
2	`web/izvjestaji/invoice_creator.php?html=true`
3	`File=Invoice.xml`
4	`text/xml`

Radno vrijeme

Operacije sa radnim vremenom od v80

Mogući zadaci: DohvatiRadnoVrijemeZahtjev, ObrisiRadnoVrijemeZahtjev, PrijaviRadnoVrijemeZahtjev, PrijaviRadnoVrijemeZaPoslovniceZahtjev

Detaljne primjere pogledajte na testnom okruženju HrFiskalizatora (TESTOVI FISKALIZACIJE 1.0).

Red	Sadržaj
1	`http:NOENCODEPOST`
2	`fiskal?zadatak=DOHVATIRADNOVRIJEMEZAHTJEV`
3	`FILE=primjer_dohvat_radnog_vremena_zahtjev.txt`
4	`text/html;charset=UTF-8`

Certifikati

CETRTIFICATEFACTS od v88

Provjera detalja o certifikatu. Šalje se certifikat iz F20 dokumenta (Base64 encoded) ili cijeli XML file.

Red	Sadržaj
1	`http`
2	`app/CETRTIFICATEFACTS`
3	`Base64encodedCertificate` ili `file=Signed_invoice.xml`
4	`text/html;charset=UTF-8`