Fiskalizacija računa (Arges ERP)
Ako trgovina posluje kroz Arges ERP, WebShopHR automatski fiskalizira plaćene narudžbe: čim narudžba postane plaćena, račun se prijavljuje kroz Arges, bez ručnog prepisivanja u zasebni program. Na potvrdi narudžbe se onda pojave JIR i ZKI.
- JIR (Jedinstveni Identifikator Računa): oznaka koju fiskalizirani račun dobije prilikom prijave.
- ZKI (Zaštitni Kod Izdavatelja): zaštitni kod koji potvrđuje da račun dolazi od tebe kao izdavatelja.
Automatski tok
Čim narudžba postane plaćena, WebShopHR u pozadini pokrene fiskalizaciju. Kupac ne čeka: potvrda narudžbe stiže odmah, a fiskalni podaci se dopune kad prijava prođe.
- Narudžba prijeđe u status plaćena (bilo kroz karticu, poklon bon koji pokriva cijeli iznos, ili kad ti ručno označiš virman/pouzeće plaćenim).
- WebShopHR pošalje račun Argesu, koji ga u jednom koraku kreira, zaključa i fiskalizira.
- Arges vrati JIR i ZKI, a WebShopHR ih spremi na narudžbu.
- Na stranici narudžbe (
/narudzba/…, poveznica iz potvrde) kupcu se prikaže fiskalni isječak s JIR-om i ZKI-jem.
⚠ Za virman i pouzeće WebShopHR ne zna sâm da je kupac platio. Uplatu na račun ili gotovinu koju naplati dostavljač sustav ne vidi: fiskalizacija se pokrene tek kad ti sam otvoriš narudžbu i klikneš „Označi plaćenom" (vidi Narudžbe). Dok to ne napraviš, ta narudžba ostaje bez fiskalnog računa, ni u Argesu ni kod FINA-e.
Povezivanje kroz Postavke
CMS strana fiskalizacije je u Postavkama, u sekciji Arges integracija. Ondje sam upisuješ:
- Arges API token: pristupni ključ tvoje Arges instalacije (unos je maskiran).
- Arges Base URL: adresa tvog Arges API-ja.
Gumbom „Sinkroniziraj s Argesom" pokrećeš sinkronizaciju odmah (artikli i zalihe). To je i jedini način da se pokrene, WebShopHR je sama ne ponavlja ni po kakvom rasporedu.
- Master prekidač fiskalizacije je uključen.
- Upisan je Arges API token (Postavke → Arges integracija).
- Postavljen je ID naplatnog uređaja iz tvoje Arges instalacije (Arges ga traži za prijavu računa).
Token upisuješ sam u Postavkama (uvjet 2). Prekidač fiskalizacije i ID naplatnog uređaja (uvjeti 1 i 3) u ovoj verziji CMS-a još nemaju vlastiti ekran, pa ih postavljamo zajedno s tobom uz WebShopHR podršku pri povezivanju s Argesom: javi se podršci da uključiš fiskalizaciju.
Ako bilo koji uvjet nedostaje, narudžbe se ne fiskaliziraju. Ostatak trgovine (narudžbe, potvrde, uplatnice) radi potpuno normalno. Većina trgovina koje ne posluju kroz Arges ovo ostavi isključeno.
Bez duple prijave
Fiskalizacija se za istu narudžbu izvrši točno jednom. WebShopHR to osigurava na više razina, pa ni ponovljeni pokušaji (npr. dvostruka potvrda plaćanja ili automatski pokušaj nakon privremene greške) ne prijave isti račun dvaput. Jednom fiskalizirana narudžba se preskoči.
Storniranje fiskaliziranog računa
Storniranje narudžbe koja već ima JIR ne stornira automatski i račun u Argesu. Dijalog storna nudi kvačicu „Storniraj i račun u Argesu" (zadano isključena, uz obavezan razlog). Tek ako je uključiš, WebShopHR pošalje Argesu storno tog računa. Narudžba se u WebShopHR-u stornira u svakom slučaju, neovisno o ishodu tog poziva.
Ostaviš li kvačicu isključenom, fiskalni račun u Argesu ostaje aktivan dok ga ne storniraš sam, izravno u ArgesERP-u. WebShopHR ne pamti vlastito stanje storniranosti, nego ga svaki put čita uživo iz Argesa. Puni opis dijaloga je na stranici Narudžbe.
Ako prijava ne prođe
Ako Arges privremeno nije dostupan zbog ispada ili mrežne greške, narudžba se ne ruši. Ostaje uredno zabilježena, a WebShopHR automatski ponavlja prijavu sa sve dužim pauzama između pokušaja, do otprilike 25 pokušaja kroz ~20 dana. Ako Arges ostane nedostupan toliko dugo i sustav potroši sve pokušaje, jedino što preostaje jest u detalju narudžbe kliknuti „Pokušaj ponovno fiskalizirati".
⚠ O grešci fiskalizacije te nitko ne obavještava. WebShopHR ne šalje mail ni obavijest u CMS-u kad prijava padne ili kad se pokušaji potroše: grešku vidiš isključivo ako sam otvoriš detalj te narudžbe. Ako Arges ostane nedostupan dulje vrijeme, isplati se povremeno provjeriti narudžbe koje čekaju fiskalizaciju.
Ako u Postavkama nedostaje naplatni uređaj ili API token, automatsko ponavljanje nema smisla jer problem neće sam nestati. Umjesto toga se zabilježi točan razlog (npr. nedostaje uređaj ili token), a ti trebaš popraviti Arges postavke i zatim u detalju narudžbe kliknuti „Pokušaj ponovno fiskalizirati": prijava se šalje odmah, bez dodatnog čekanja.
Fiskalizacija se nikad ne prijavi dvaput. I automatski pokušaji i ručno ponavljanje provjeravaju je li narudžba već fiskalizirana, pa je sigurno pritisnuti gumb ponovno.
Napomena o testnom okruženju
Stvarni JIR/ZKI generira FINA preko naplatnog uređaja s FINA certifikatom na
tvom Arges nalogu. U demo/testnom okruženju certifikata nema, pa se koriste
MOCK vrijednosti (MOCK-JIR…, MOCKZKI…) koje dokazuju da tok radi
(prijava → JIR/ZKI → prikaz), ali nisu stvarna fiskalizacija.
Točan porezni raspored računa (PDV razredi, tretman popusta i bonova) ovisi o konfiguraciji uređaja na tvom Arges nalogu.
Povezane stranice
