Posljednju inačicu HrFiskalizatora (77) ( zip ) skinite OVDJE.

Ako ste koristili raniju verziju pogledajte programske izmjene po inačicama od verzije 0.1.0 .

• Ako neko nezna za testni interface treba učitati http://localhost:8449/web
  *ako niste mjenjali password default je login = "login" , password = "password".

Upute na ovoj stranici su u obimne kako bi programer korisničke aplikacije imao točan uvid u funkcioniranje HrFiskalizatora.
Međutim korištenje HrFiskalizatora je relativno jednostavno pa za uspješno korištenje nije neophodno niti poznavati sve funkcije, niti detaljno proučiti kompletne upute.

Za bilo kakve informacije pošaljite mi upit na email adresu. vlado.vrbanec@mvv.hr

• Može mu se zadavati instrukcije putem HTTPS ili HTTP requesta ili upisom jednostavnih instrukcija u text datoteku.
• Jedna od naprednih funkcija mu da od poslovne aplikacije prima instrukcije i podatke te ako se to od njega traži potpisuje i šalje
     XML datoteke sa izlaznim računima (i drugim zahtjevima) na server porezne uprave kao SOAP request, te prihvača i interpretira primljene povratne podatke, te ih vrača poslovnoj aplikaciji.
• Pomoću njega možete poslati eRačun obveznicima B2G ili korisnicima B2B usluge.
• Također možete u programerskom interfejsu puno naučiti o strukturi UBL 2.1 eRačuna koji če uskoro biti obavezan za razmjenu računa među poslovnim korisnicima.
• U programerskom interfejsu možete naučiti puno i o strukturi XML dokumenata koje morate kreirati radi slanja na fiskalizaciju.
• Možete u testirati svoje XML datoteke ili učiti na priloženom primjeru.
• Možete slati podatke državnom servisu eOvrhe te skidati sa njega i analizirati primljene podatke.
• Možete omogućiti svojim korisnicima pregleda statičkih web sadržaja na udaljenom računalu.
• Možete koristiti napredne funkcije drugih serverskoh okolina (php, asp i drugi) koristeći HrFiskalizator kao proxy.
• Možete im omogućiti udaljeni pregled i pristup bazama podataka i drugim podacima te vršiti uvid i obradu istih.
     *Tako se može omogućiti vašim korisnicima da web browserom sa udaljenog računala pristupe podacima, sa računala na kojem je instaliran Hrfiskalizator,
     dohvate podatke iz baze podataka (recimo današnji promet ili stanje zaliha nekog artikla) , da naprave primku za robu ili slične operacije.
• Možete kreirati QRkod image potreban za ispis na račun radi fiskalizacije.
• Možete kreirati PDF417 barkod za skaniranje pri plačanju računa.

1) Može čekati na datoteku na disku (*klikni za detalje), čitati iz nje instrukcije te vračati odgovore u datoteku odgovora u unaprijed definiranom obliku.

2) Može čekati na HTTP instrukciju (*klikni za detalje)na unaprijed definiranom portu te vraćati podatke klijentu u unaprijed definiranom obliku.

Programu se može u Serverskom načinu rada pristupati i preko mreže (pa i preko interneta) ,što znači da nemora biti instaliran na svim računalima u prodavaonici.

U tome slučaju treba znati da če arhive biti pohranjene samo na računalu na kojem je pokrenut HrFiskalizator,ili na nekom drugom računalu ako je za arhiviranje datoteke zahtjeva i odgovora definiran mrežni disk.

Ako HrFiskalizatoru pristupamo preko interneta , poželjno je da se koristi HTTPS protokol jer ako se komunikacija odvija HTTP protokolom znači da bi podatke neko mogao "ukrasti i iskoristiti", za što međutim nevidim interes..

Na računalo mora biti instaliran minimalno operativni sutav Windows XP sa instaliranim Servis packom 3.

HrFiskalizator je pisan u JAVA programskom jeziku te za njegov rad na računalu mora biti instalirana posljednja inačica JAVE (Razvijeno i testirano na JRE 1.8.0)

Ukoliko postoje problemi sa instalacijom JAVE HrFiskalizator če pokušati pokrenuti javaw.exe program koji bi se trebao nalaziti unutar svojeg foldera u subolderu JRE\bin.
Znači moguće je sadržaj instaliranog foldera jave jednostavno kopirati u JRE subfolder.

Skidanje 32 ili 64 bitne instalacije za Windows je moguće na poveznici

32 bitni inačicu (koja radi i na 64 bitnom OSu) možete skinuti i u zipu da HrFiskalizatorom.

Pod Windows OS potrebno je raspakirati skinuti zip i raspakirati ga na C disk.
U tom slučaju kreira se folder "C:\HrFiskalizator" (*Poželjno ali ne i obavezano ime i lokacija foldera).

Nakon PRVOG pokretanja programa se pokreče proces u kojem možete odmah izvršiti uvoz svog korisničkog certifikata u Keystore te provjeriti početne postavke vaše konfiguracije.

U pravilu je dovoljno izvršiti uvoz certifikata te zatvoriti početnu formu te zatvoriti i ponovno pokrenuti program.

Ako želimo da se program pokreče pri paljenju računala, jednostavno napravimo Shortkat u StartUp Folder menija operativnog sustava.
Program također odlično radi i pod operativnim sustavom Linux.

Način instalacije i pokretanje pod LINUXOM pogledajte OVDJE

Resursi koje zauzima HrFiskalizator nisu veliki.
Sam program na disku zauzima nekoliko Mb prostora , pri radu rezervira od 35 do 50mb rama, dok instalacija JAVE na disku zauzima oko 80Mb.
Program je optimiziran i uopče ne opterečuje procesor.

i implementacije u korisničkim programskim rješenjima je olakšano ako HrFiskalizator.exe pokrenemo sa programskim parametrom -Jskel_Debug=1 .

Program če pozvan tim parametrom otvoriti prozor u kojem če ispisivati večinu programskih događaja ili grešaka koje se događaju.

Pazi ! U ovom modu rada zatvaranjem prozora gasi se i glavni program.

Program (ukoliko je to u setupu uključeno) kreira i log datoteku Error.log datoteku u koju bilježi večinu negativnih događanja.
Datoteka se obnavlja nakon što dosegne 100Kb veličine.

Može se pregledati bilo kojim textualnim preglednikom ili klikom na ikonu upozorenje na vrhu menija.

Uz to program ima pokrenut i korisnički Web servis na adresi http://localhost:8449/web u kojem se može testirati osnovne funkcije programa i provjeriti ispravnost kreiranih xml datoteka.

Servis je naročito koristan kada program imamo pokrenut parametrom SERVICE jer onda nemamo učitan glavni programski meni.

Servis učitava source interfejsa sa web servera HrFiskalizatora tako da se može dograđivati novim funkcijama bez potrebe za nadogradnjom programa.

*Servis funkcionira samo kada smo priključeni na internet.

Apsolutno svaki programski jezik može pisati i čitati iz datoteke a gotovo svaki komunicirati HTTP protokolom

POD WINDOWS OS :

Program možemo pokrenuti klikom na HrFiskalizator.exe

Također možemo kreirati shortcat sa nekim od programskih parametara ako sa njim želimo pokretati program.

PROGRAMSKI PARAMETRI

Ako je prvi parametara -Jskel_Debug=1 program če otvoriti kontrolnu consolu za olakšano pračeno događanje pri radu programa.

Ako je jedan od parametara NOSPLASH neče biti prikazana reklamna forma pri pokretanju programa.

Ako je jedan od parametara SERVICE neče biti učitana niti ikona u Trayu niti glavni programski meni.

Ako je jedan od parametara NOMENU biti će učitana ikona u Trayu ali ne i glavni programski meni.

Ako program pokrenemo samo sa parametrom SETUP , otvoriče se samo Setup forma a pritom drugi servisi neče biti pokrenuti.

Svi parametri ( izuzev -Jskel_Debug=1 ) će biti prihvačeni i ako pokrečemo direktno HrfiskalizatorG.jar .

NAPOMENA

Za rad HrFiskalizatora pod svim operativnim sustavima dovoljno je imati uz JRE samo datoteke :

• HrFiskalizator.exe i HrFiskalizatorG.jar pod Windowsima.
    *HrFiskalizator.exe je u biti samo starter .jar datoteke koji obavlja neke predradnje kako bi jar mogao uspješno raditi.
• HrFiskalizatorG.jar pod Linuxom

Sve ostale datoteke su pomočne i obavljaju svaka pojedinu prateču funkciju te če biti kreirane pri pokretanju programa.

U Windowsima program pokrećemo kao exe + eventualni parametri ali će jednako raditi ako ga pokrenemo kao JAR.

javaw -jar HrFiskalizatorG.jar + eventualni parametri

ili

java -jar HrFiskalizatorG.jar + eventualni parametri (ako želimo prikaz kontrolne konzole)

Program možemo pokretati i pokretanju iz korisničke aplikacije , te ga pri izlasku zatvarati zatvarati http pozivom.

http://localhost:8449/fiskal?zadatak=EXIT

Da bi program mogao komunicirati serverom porezne uprave, u zajedničku datoteku, takozvani keystore moraju biti unešeni serverski* i osobni certifikat.
HrFiskalizator taj postupak čini vrlo jednostavnim a kako provesti postupak uvoza certifikata pogledajte ovdje.

*Svi trenutni Testni i Produkcijski certifikati su predinstalirani u Keystore pri instalaciji, tako da za rad dovoljno uvesti osobni potpisni certifikat.

Sve trenutno važeče tehničke detalje implementacije fiskalizacije 1.0 pogledajte pogledajte OVDJE

HrFiskalizator od verzije 78 ima ugrađen i SSE server koji omogućava klijentima da se pretplate na primanje push poruka o događajima u HrFiskalizatoru.
To omogućava vašoj aplikaciji da bude obavještena o događajima u HrFiskalizatoru bez potrebe za stalnim ispitivanjem (polling) servera.
Ova funkcionalnost je naročito korisna za aplikacije koje trebaju biti u realnom vremenu obavještene o događajima kao što su novi računi, greške ili statusni podaci.
Za korištenje SSE servera, vaša aplikacija treba implementirati SSE klijent koji se povezuje na HrFiskalizator i prima poruke.
Više informacija o implementaciji SSE klijenta možete pronaći u dokumentaciji vašeg programskog jezika ili okruženja.

Za funkcionalnost SSE servera pogledajte: Opis SSE sustava HrFiskalizatora.

HrFiskalizator proxy server strogo namjenski razvijen za potrebe fiskalizacije.

Za višestruko upotrebljiviji , svenamjenski , moćniji mikroserver pogledajte web stranicu VOS mikroservera.