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.

Fiskalizacija radi neovisno o načinu plaćanja: okida se na svaki prijelaz narudžbe u plaćeno (kartica, bon, ručna potvrda virmana ili pouzeća).
⚠ 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.

Uvjeti za fiskalizaciju
Automatska fiskalizacija je isključena dok se ne uključi i vrijedi po trgovini. Da bi se narudžba fiskalizirala, moraju biti ispunjena sva tri uvjeta:
- 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. Istu kvačicu nudi i dijalog punog povrata fiskalizirane narudžbe (uz djelomični povrat se ne nudi); povrat se evidentira u svakom slučaju, a ishod storna računa javlja se zasebnom porukom. Storno narudžbe koja je već Poslana smije samo upravitelj.
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

Arges ERP
Poveži Arges ERP kako bi artikle, usluge i zalihe po lokacijama sinkronizirao jednim pokretanjem, bez ponovnog upisivanja podataka u dva sustava.
Plaćanje
Kupcu ponudi plaćanje pouzećem, virmanom ili karticom, a zatim poveži Stripe, CorvusPay ili WSPay prema načinu na koji želiš primati kartične uplate.
R1 računi
Poslovni kupac na naplati upisuje naziv tvrtke i provjereni OIB, a ti te podatke vidiš uz narudžbu, račun i izvoz podataka.
Postavke
Na jednom ekranu uredi podatke tvrtke, naplatu, Arges, podsjetnike za napuštene košarice i izgled poruka koje trgovina šalje kupcima.