HrFiskalizator - Mikro server za fiskalizaciju

Download
64 bitna inačica HrFiskalizatora za Windows (101),te 32 bitna (99): Preuzmite ovdje

Promjene kroz pojedine verzije: povijest verzija.

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

Ako več imate instalirani HrFiskalizator, testirajte ovdje opisane a i mnoge neopisane funkcionalnosti HrFiskalizatora, kao u plugina (plugine treba instalirati) !
Testni web interfejs: http://localhost:8449/web
Default login: login / password: password

Brzi uvodi

Hodogram Fiskalizacija 2.0

Razmjena računa i eIzvještavanja — pojednostavljeni prikaz.

eRačuni — DOKU

Slanje eRačuna preko informacijskog posrednika DOKU.

eRačuni — ePoslovanje

Slanje eRačuna preko informacijskog posrednika ePoslovanje.

eRačuni — MER

Slanje eRačuna preko informacijskog posrednika MER (Moj Eračun).

eRačuni — SUPER

Slanje eRačuna preko informacijskog posrednika SUPER (Crno jaje).

eIzvještavanje

Direktno izvještavanje poreznoj upravi.

TXT2INV plugin

Jednostavna konverzija TXT u eInvoice za slanje bilo kojem posredniku.

F2archive plugin

Lokalno arhiviranje eRačuna (optimizirano za DOKU).

Vizualizacija eRačuna

HTML PDF

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

Što je HrFiskalizator

od v100 HrFiskalizator je mikro server kreiran u Java 17 programskoj okolini.

do v99 Kreiran u Java 1.80xxx.

Zamišljen kao mali proxy koji će programerima omogućiti jednostavnu komunikaciju sa serverom porezne uprave u sustavu fiskalizacije 1.0 prerastao je u pravi mali ekosistem.

Može mu se zadavati instrukcije putem HTTP ili HTTPS zahtjeva, ili upisom jednostavnih instrukcija u text datoteku.
Gotovo 100% kompatibilan sa zastarjelim Wrapper projektom u dijelu koji se odnosi na pojedinačne pozive iz command prompta.
Od poslovne aplikacije prima instrukcije i podatke, po potrebi ih potpisuje i šalje XML datoteke sa izlaznim računima (i drugim zahtjevima) na server Porezne uprave kao SOAP request, te vraća poslovnoj aplikaciji primljene povratne podatke.
Slanje eRačuna obveznicima F2.0. (Podržano slanje provajderima - DOKU (Monoform), ePoslovanje, MER (MOj eRačun),SUPER (Crno jaje)
Napredna vizalizacija eRačuna i eOdobrenja (html dokumenat ili Pdf).

Omogučuje i :

Testiranje i učenje o strukturi UBL 2.1 eRačuna i XML dokumenata za fiskalizaciju.
Slanje podataka državnom servisu eOvrhe.
Prikaz statičkih web sadržaja u browseru.
Dinamički web sadržaji korištenjem JAVA programskog jezika (plugin).
Proxy za napredne funkcije drugih serverskih okolina (PHP, ASP i Harbour i dr.).
Udaljeni pregled i pristup bazama podataka.
Kreiranje QR koda za ispis na račun radi fiskalizacije.
Kreiranje PDF417 barkoda za skeniranje pri plaćanju računa.
Pretraživanje KPD specifikacije uz mogućnost pretrage po : NAME , CODE , SECTOR.
Pretraga oznaka jedinice mjera.
Podrška za dohvat,promjene,prijave radnog vremena kao novosti u fiskalizaciji 1.0 .
Jednostavna dorada funkcionalnosti glavnog programa sustavom plugina.
I još puno toga .....

Razmjena podataka sa HrFiskalizatorom

HrFiskalizator možete koristiti na dva načina:

1) Čekanje na datoteku na disku

Program čeka na kreiranu ili promijenjenu datoteku, čita instrukcije i vraća odgovore u definiranom obliku.

2) Čekanje na HTTP zahtjev

Program čeka na HTTP instrukciju na definiranom portu i vraća podatke klijentu u definiranom obliku.

Mrežni rad: U serverskom načinu rada program može opsluživati više klijenata preko mreže (pa i interneta). U tom slučaju arhive se pohranjuju samo na računalu na kojem je pokrenut HrFiskalizator, ili na mrežnom disku ako je definiran.

Sigurnost: Ako HrFiskalizatoru pristupamo preko interneta, preporuča se HTTPS protokol jer HTTP komunikacija nije enkriptirana.

Preduvjeti za rad od v100

Java 17: HrFiskalizator je razvijen za JRE 17 (64-bit). Za rad je potrebna instalirana Java 17 ili novija.
Ako instalacija JAVE ne postoji ili je neispravna HrFiskalizator.exe če pod Windows OS, sam skinuti i installirati svoju kopiju.

Operativni sustavi:

Windows 10, Windows 11 (64-bit)
Linux 64-bit distribucije (Ubuntu, Debian, Lubuntu) s desktop okolinom (vjerojatno i bez, ali nije detaljno testirano).

Napomena:
HrFiskalizator.exe unutar Windows OS obavlja sve radnje pri instalaciji programa, JAVE i pomočnih datoteka.
Za rad pod Linuxom dovoljno je imati samo HrFiskalizatorG.jar, ali sve radnje na instalaciji JAVE, potrebno je obaviti ručno.

do v99 Java 1.80xxx . Svi Win OS od XP nadalje 32 i 64 bit , Linux 32 i 64 bit.

Instalacija programa

Windows od v100

Skinite i pokrenite HrFiskalizator.exe.
Program če nakon odabira foldera za instalaciju (preporuka. C:\HrFiskalizator), samostalno obaviti instalaciju.
Potom uvezite svoj potpisni certifikat u Keystore.
Zatvorite formu i ponovno pokrenite program.

Za automatsko pokretanje pri paljenju računala, dodajte shortcut u StartUp folder.

Linux

Način instalacije i pokretanja pod Linuxom pogledajte na posebnoj stranici.

do v99

Windows i Linux

Potrebno je skinuti raspakirati željeni zip sa download stranice.

Potrebni resursi

Disk: Nekoliko MB za program + ~80 MB za instalaciju Jave
RAM: 100–150 MB tijekom rada
Procesor: Minimalno opterećenje

Pokretanje programa i pozivni parametri

Windows

Program možemo pokrenuti klikom na HrFiskalizator.exe [parametri]

Pozivni parametri

Parametar	Opis
`NOSPLASH`	Bez reklamne forme pri pokretanju
`SERVICE`	Headles način rada (Bez tray ikone i glavnog menija)
`NOMENU`	Tray ikona bez glavnog menija
`SETUP`	Samo Setup forma, bez pokretanja drugih servisa
Samo Windows
`CONSOLE`	Otvora kontrolnu konzolu za praćenje događaja
`UNINSTALL`	Deinstalacija

Pokretanje iz korisničke aplikacije

Program možemo pokretati iz korisničke aplikacije:

HrFiskalizator.exe + eventualni parametri

i zatvarati HTTP pozivom:

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

ili upisom jednostavne instrukcije u request.ini:

EXIT

Instalacija certifikata

Za komunikaciju sa serverom Porezne uprave u Keystore moraju biti unešeni serverski i osobni certifikat.

HrFiskalizator taj postupak čini jednostavnim — detaljan postupak pogledajte na stranici o certifikatima.

Svi trenutni testni i produkcijski certifikati su predinstalirani u Keystore. Za rad je dovoljno unijeti samo osobni potpisni certifikat.

Razvojna okruženja

HrFiskalizator se može koristiti u svim modernijim razvojnim okolinama. Apsolutno svaki programski jezik može pisati i čitati iz datoteke, a gotovo svaki može komunicirati HTTP protokolom.

Kako se instaliraju pluginovi

Pluginovi proširuju osnovnu funkcionalnost HrFiskalizatora.

Kopirajte JAR datoteku plugina u folder plugins unutar foldera HrFiskalizatora.
Ili ih instalirajte u web setupu pod tabom "Pluginovi".
Ponovo pokrenite program — pluginovi se sami učitavaju.

HrFiskalizator pri učitavanju provjerava postojanje novije verzije plugina na serveru.

Za informacije o izradi pluginova kontaktirajte: vlado.vrbanec@mvv.hr

Otklanjanje programskih grešaka

Za detaljniji uvid u rad programa, pokrenite ga sa parametrom CONSOLE. Program će otvoriti konzolu sa ispisom programskih događaja i grešaka.

Pažnja: U ovom modu rada, zatvaranjem prozora gasi se i glavni program.

Program kreira i Error.log datoteku u koju bilježi negativne događaje. Datoteka se obnavlja nakon 100 KB.

Web servis za testiranje dostupan je na: http://localhost:8449/web

SSE server od v78

HrFiskalizator ima ugrađen SSE (Server-Sent Events) server koji omogućava klijentima primanje push poruka o događajima.

Ova funkcionalnost je korisna za aplikacije koje trebaju biti u realnom vremenu obavještene o novim računima, greškama ili statusnim podacima.

Više informacija: Dokumentacija SSE sustava

VOS mikroserver

HrFiskalizator je proxy server strogo namjenski razvijen za fiskalizaciju.

Za višenamjenski, moćniji mikroserver pogledajte web stranicu VOS mikroservera.