Najnoviju inačicu HrFiskalizatora (73) ( zip ) skinite OVDJE.

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

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

HrFiskalizator možete koristiti na jedan od 2 načina :

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

PREDUVJETI ZA RAD

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.

INSTALACIJA PROGRAMA

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

POTREBNI RAČUNALNI RESURSI

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.

POMOČ PRI OTKRIVANJU PROGRAMSKIH GREŠAKA 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.

HrFiskalizator se može koristiti na skoro oba načina u svim modernijim i manje modernim razvojnim okolinama.

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

HrFiskalizator se može pokrenuti na mnoštvo načina

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"

INSTALACIJA CERTIFIKATA za komunikaciju sa serverom i potpisnog cerifikata

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.