Moguča uporaba HrFiskalizatora ako čeka na File na disku :

Kako bi Program radio u ovom načinu u konfiguracijskoj datoteci (HrFiskalizator.ini) postavka "Način čekanja na zadatak "mora biti definirana kao "File".

Program če na čekati da bude KREIRANA ili PROMIJENJENA datoteka definira u konfiguracijskoj datoteci postavkom "Datoteka sa zadatkom"

i vračati odgovore u datoteku definiranu postavkom "Datoteka sa odgovorom".

Datoteka sa zadacima če cijelo vrijeme biti zaključana za brisanje ali če se u nju cijelo vrijeme moči pisati, a program detektira

promjenu vremena zadnjeg pisanja u datoteku.

Program ostavlja dovoljno vremena (200ms) matičnoj aplikaciji da uspješno upiše sve podatke.

Upit (zadatak) se upisuje u prvi red datoteke.

U ostalim redovima datoteke upita moguči su i neki dodatni parametri prema doljnim primjerima.

Sve ulazne text datoteke moraju biti utf-8 encoded .

Svi odgovori su plain text odgovori te su utf-8 encoded .

Program nastoji detektirati sve potencijalne korisničke greška te vrača razne poruke o greškama koje su se dogodile pri

izvođenju traženog zadatka ili dobivene od servera Porezne uprave.

Program če vračati odgovore na sljedeče upite(u zagradi skračeni upit) :

EXIT

Gasi program , te je korisna ako programer iz svoje aplikacije želi pokretati HrFiskalizator te ga zatvarati (recimo pri zatvaranju svoje aplikacije).

Povratna datoteka se ne kreira.

PING

Služi za provjeru dali program radi i odgovara na preddefinirani port

Moguči povrati : OK ili povrata nema

ECHO

Služi za provjeru dali program radi i te dali može komunicirati sa serverom porezne uprave.

Moguči povrati : True ili povrata nema

GETSERVER

Služi za provjeru dali je program usmjeran na slanje zahtjeva na Produkcjiski ili Testni Server PU.

Moguči povrati : Produkcijski ili Testni

GETHRFVERSION

Primjer : http://login:password@localhost:8449/fiskal?zadatak=GETHRFVERSION"

Moguči povrati : Verzija učitanog programa

GENERIRAJUID (GUID)

Moguči povrati : generirani jedinstveni broj

GENERIRAJZKI (GZKI)

Zahtjeva dodatnih 5 parametara za izračun ZKI u formatu prema priloženom primjeru.

(GENERIRAJZKI, Formatiran DatumVrijeme,Oib,Iznos računa (separator lipa je točka),Broj poslovnice, Broj naplatnog uređaja,

GENERIRAJZKI Zadatak
17052038498 Oib
23.09.2016 19:13:30 Formatiran DatumVrijeme
17052038498 Oib
2571 Broj računa
1 Broj poslovnice
1 Broj naplatnog uređaja
200.00 Iznos računa (separator lipa je točka)

Moguči povrati : izračunati ZKI broj

DOHVATIVRIJEME (VRIJEME)

Moguči povrati : trenutno sistemsko vrijeme u formatu 23.09.2016T19:13:35

RACUNZAHTJEV (RZ)

Datoteka sa instrukcijama mora imati ovakav oblik

RZ  
  Prazan red
R1234.xml XML datoteka za slanje
R1234.txt Proizvoljno ime datoteke za povrat podataka

Treči parametar "Proizvoljno ime datoteke za povrat podataka." postoji kako u višekorisničkom okruženju, više kasa nebi dobilo istovremeno

odgovor u istu datoteku.(Ako 3 parametar nije naveden, povrat informacija se vrši u datoteku definiranu postavkom "Datoteka sa odgovorom".

u glavnim postavkama.

Napomena : Ukoliko su u programskim postavkama uključene opcije upisa vremena slanja i UIDA prilikom slanja računa program če upisati

podatke u XML string prije slanja, ako nisu, potrebno je da u XML stringu tagovi <IdPoruke></IdPoruke> te <DatumVrijeme></DatumVrijeme>

budu popunjeni.

<ZastKod></ZastKod> se u svakom slučaju izračunava te popunjuje, te ga stoga nije potrebno upisivati unutar korisničke aplikacije jer če ionako biti prepisan.

( za razliku od primjera sa poslovnim prostorom ovaj primjer je sa upisanim vrijednostima)

69db925d-f967-4fb8-b482-7e2fb8f328f8 UID
cdda222a-9df7-496f-94c0-aa4704ad6f35 JIR
07.10.2016T15:07:37 Vrijeme iz datoteke primljene od PU
c93a13d1092f4f5c385f391ab78a75ba ZKI izračunan na osnovu podataka iz XML datoteke

U slučaju greške program če vratiti odgovor po sljedečoj shemi:

  Prazan red
  Prazan red
  Prazan red
c93a13d1092f4f5c385f391ab78a75ba ZKI izračunan na osnovu podataka iz XML datoteke
Problem pri slanju poruke na server porezne uprave : com.sun.xml.internal.messaging.saaj.SOAPExceptionImpl: Message send failed Poruka greške (primjer)

*U slučaju greške pri izvođenju procedure, moguče je da bude vračena samo poruka greške ili da ne bude vračena nikakva poruka
, u tom slučaju se gotovo sigurno radi o pogrešno formatiranoj XML poruci zahtjeva.

RACUNPROVJERAZAHTJEV (RPZ)

Ovaj zadatak ima iste parametre kao i RACUNZAHTJEV te mu se šalje potpuno ista datoteka sa računom, jedina je razlika što neče fiskalizirati račun nego ga poslati u CIS, na provjeru te vratiti rezultat provjere u sljedečem obliku :

58b33336-68ac-49c5-b7c6-d6e5dea3e767 UUID poslane poruke
Poruka je ispravna. Ili drugi rezultat greške.
  Prazan red
v100 Šifru greške.

PROVJERAZAHTJEV (RPZ)

Ovaj zadatak ima iste parametre kao i RACUNZAHTJEV te mu se šalje potpuno ista datoteka sa računom, ali početni ključ datoteke sadrži "ProvjeraZahtjev" a ne "RacunZahtjev".Podaci se neče fiskalizirati nego ga poslati u CIS, na provjeru te vratiti rezultat provjere u obliku kao i RACUNPROVJERAZAHTJEV :

RACUNZAHTJEVTXT (RZTXT)

Omogučuje konverziju i slanje u CIS txt datoteke sa podacima koje je vrlo jednostavno izraditi u DOS programima.

Program če textualnu datoteku formatiranu na način iz primjera pretvoriti u XML string te ga poslati uz sva pravila koja vrijede za poziv RACUNZAHTJEV.

Datoteka sa instrukcijama mora imati ovakav oblik :

RZTXT  
  Prazan red
R1234.txt XML datoteka za slanje
R1234odg.txt Proizvoljno ime datoteke za povrat podataka.

Treči parametar "Proizvoljno ime datoteke za povrat podataka." postoji kako u višekorisničkom okruženju, više kasa nebi dobilo istovremeno

odgovor u istu datoteku.(Ako 3 parametar nije naveden, povrat informacija se vrši u datoteku definiranu postavkom "Datoteka sa odgovorom".

u glavnim postavkama.

Primjer datoteke sa računom za slanje Racuntxt.txt . Redovi sa # su opisni i program ih ne procesira.

PAŽNJA za razliku od Wrappera koji je više poreza i naknada razdvajao znakom * , Hrfiskalizator ih razdvaja znakom & (zbog programskih osobina JAVE).

*Kako je jednako lako unutar matične aplikacije kreirati XML string kao i TXT datoteku, ovu funkiju treba shvatiti kao pomočnu.

Uvedena je isključivo kao bi se korisnicima Wrappera koji su koristili ovu funkciju olakšao prelazak na HrFiskalizatora.

RACUNPROVJERAZAHTJEVTXT (RPZTXT)

Ovaj zadatak ima iste parametre kao i RACUNZAHTJEVTXT te mu se šalje potpuno ista TXT datoteka sa računom, jedina je razlika što neče fiskalizirati račun nego ga poslati u CIS, na provjeru te vratiti rezultat provjere u istom obliku kao i zadatak RACUNPROVJERAZAHTJEV .

PRATECIDOKUMENTIZAHTJEV (PDZ)

Koristi se za slanje PRATEČEG DOKUMENTA.

Svi pozivni parametri izuzev prvog su istovjetni kao kod RACUNZAHTJEV (izuzev )

Moguči povrati : su istovjetni kao kod RACUNZAHTJEV.

RACUNPDZAHTJEV (RPDZ)

Koristi se za slanje RAČUNA ZA PRATEČI DOKUMENT.

Svi pozivni parametri izuzev prvog su istovjetni kao kod RACUNZAHTJEV (izuzev )

Moguči povrati : su istovjetni kao kod RACUNZAHTJEV.

PROMIJENINACPLACZAHTJEV

Koristi se za slanje IZMJENE NAČINA PLAĆANJA NA VEČ FISKALIZIRANOM RAČUNU.

Klikni za detalje

NAPOJNICAZAHTJEV (u funkciji od verzije 60)

Koristi se za slanje XMLa NAPOJNICE nakon što smo uspješno fiskalizirali račun.

Svi pozivni parametri izuzev prvog su istovjetni kao kod RACUNZAHTJEV (izuzev )

Klikni za detalje

QRCODE ili CREATEBARCODE

  • Podržani barcodetype su QRCODE (primjena pri fiskalizaciji i dr.) i PDF417 (moguča primjena za generiranje barcoda za internet plačanje)

    Ako nije upisana cijela putanja npr. C:\HrFiskalizator\podmeni\test.png onda če datoteka biti kreirana u folder u kojoj je pokrenut HrFiskalizator. podataka
    Primjer do verzije 45
    QRCODE  
    TekstZaKonverzijuKojiPropisujeZakonodavac Tekst koji želimo da bude upisan u QRCODE image
    200 Dimenzija imegea (biče upotrebljena i za Visinu i Širinu))
    test.png Ime datoteke

    Primjer od verzije 64
    CREATEBARCODE  
    QRCODE Tip barkoda koji želimo kreirati (podržano QRCODE i PDF417)
    Tekst\r\nZa\r\nKonverziju Tekst koji želimo da bude upisan u BARCODE image.
    Sekvenca karaktera "\r\n" će biti tretirana kao oznaka za novi red.
    Od verzije 64 nadalje :
    Ako text za konverziju počinje sa "file=" onda će text za konverziju biti učitan iz datoteke u nastavku.
    *Pritom datoteka sa textom za konverziju može sadržati jedan ili više redova.
    420x140 Dimenzija imegea (širina x visina).Program vrši autokorakciju dimenzija.
    *Ako je upisana visina veća od širine, barkod če biti kreiran kao vertikalni image.
    test.png Ime datoteke (Podržani format je png,jpg,bmp te gif, i automatski se određuje iz imena datoteke.)

    OK ili poruka greške če biti upisana u datoteku definiranu postavkom "Datoteka sa odgovorom" u glavnim postavkama.
    *Kod nekih grešaka moguče je da nikakva poruka nebude upisana niti image kreiran.


    Detaljnije o QRCODE ili CREATEBARCODEu pogledajte OVDJE

    • POZIVI PREMA APIJu TVRTKE IERACUNI (u funkciji od verzije 70)

    Api omogučava provjereno najpovoljnije slanje B2G i B2B računa u Hrvatskoj bez pretplate.

    Specifikacija Apija je na web adresi https://ie-racuni.com/api/v4.
    *HrFiskalizator za pretvorbu poziva iz datoteke u HTTP nema posebno navedene instrukcije več se simulira HTTP poziv,pa može simulirati sve instrukcije navedene u apiju.

  • Nekoliko primjera komunikacije sa apijem putem razmjene datoteka (naredbe su case-sensitive) :
    Šalje ranije kreirani eRačun iz datoteke racun.xml
    http
    app/IERACUNI/import?type=INVOICE
    file=C:/hrfiskalizator/racun.xml
    text/xml
    Dohvat jsona sa statusom ranije poslanog računa id=7988
    http
    app/IERACUNI/invoices/7988
     
    text/xml
    Dohvat jsona sa listom svih ikad ODLAZNIH računa
    http
    app/IERACUNI/invoices/OUTGOING
     
    text/xml
    Preuzimanje (download) računa id=7988
    http
    app/IERACUNI/invoices/7988/download
     
    text/xml

    • POZIVI PREMA APIJu ZA PROVJERU eRačuna (u funkciji od verzije 70)

    Osim toga omogućava provjeru svih UBL strukturiranih XML dokumenata, čiju listu možete vidjeti OVDJE.
    *HrFiskalizator za pretvorbu poziva iz datoteke u HTTP nema posebno navedene instrukcije več se simulira HTTP poziv.

  • Nekoliko primjera komunikacije sa apijem putem razmjene datoteka (naredbe su case-sensitive) :
    Šalje na projeru dokumenat iz datoteke racun.xml
    prema standardu definiranom u GET parametru vesid
    http
    app/PEPPOLVALIDATOR?vesid=org.oasis-open:invoice:2.1
    file=C:/hrfiskalizator/racun.xml
    text/xml