JIR i ZKI: što se događa nakon plaćanja?
Svaka naplaćena narudžba u hrvatskom web shopu mora biti fiskalizirana. WebShopHR to ne prepušta kupcu, trgovcu ni dodatnom modulu. Fiskalizacija je ugrađena u glavni tok narudžbe i pokreće se čim ona postane plaćena.
Fiskalizacija se pokreće na svakom prijelazu u „plaćeno“
Bilo da je kupac platio karticom, virmanom, pouzećem, poklon bonom koji je pokrio cijeli iznos ili da je trgovac ručno potvrdio uplatu, čim narudžba pređe u status plaćeno sustav pokreće fiskalizaciju. To znači da se ne može dogoditi da se jedan način plaćanja pošalje bez fiskalnog zapisa, a drugi ne.
Fiskalizacija ide asinkrono: kupac odmah dobije stranicu zahvale i potvrdu narudžbe, dok se JIR i ZKI generiraju u pozadini i dopisuju na narudžbu za nekoliko sekundi.
Što su JIR i ZKI?
JIR je Jedinstveni Identifikator Računa koji FINA dodijeli svakom fiskaliziranom računu. Bez njega račun nije prijavljen poreznom sustavu. ZKI je Zaštitni Kod Izdavatelja: dodatna oznaka koja povezuje račun s poslovnim prostorom i naplatnim uređajem. Uz oba podatka račun je potpun i pravno valjan.
WebShopHR ne generira te kodove sam. Oni se dobivaju od Argesovog naplatnog uređaja s FINA certifikatom. Ono što platforma radi je prikupiti sve podatke, poslati ih u pravi trenutku i sigurno spremiti vraćene kodove na narudžbu.
Jedan poziv prema Argesu kreira, zaključa i fiskalizira račun
WebShopHR komunicira s Arges ERP-om. Sve potrebne korake obavlja jedan poziv: kreira se račun, zaključa se i odmah se fiskalizira. Arges, preko naplatnog uređaja s FINA certifikatom, vraća JIR (Jedinstveni Identifikator Računa) i ZKI (Zaštitni Kod Izdavatelja). Ta dva podatka zatim se spremaju na narudžbu.
Kad su JIR i ZKI dostupni, kupac ih vidi na javnoj stranici narudžbe, a trgovac u detalju narudžbe u CMS-u. Do tada polja ostaju prazna, pa nikad ne nastaje dvosmislenost da je račun „fiskaliziran, ali bez broja“.
Ako ne bude JIR-a, račun nije fiskaliziran
Ponekad Arges može vratiti tehnički uspjeh, ali bez JIR-a, primjerice ako naplatni uređaj još nema FINA certifikat ili nije ispravno konfiguriran. U takvom slučaju sustav ne zabilježi lažnu fiskalizaciju, već zabilježi pogrešku i pokuša ponovno. Račun ostaje nefiskaliziran dok ne dobije pravi JIR.
Ako Arges trenutno nije dostupan zbog prekida mreže, posao se ponavlja sam bez da se narudžba ruši ili da kupac primi krivu poruku. Trgovac vidi pogrešku u detalju narudžbe.
Trostruka zaštita od dvostruke prijave istog računa
Dvostruka prijava istog računa FINA-i može stvoriti pravni problem, zato sustav ima tri sloja zaštite:
- Pozadinski posao fiskalizacije je jedinstven po narudžbi: dupli okidač ne stvara dva posla.
- Ako narudžba već ima JIR, sljedeći pokušaj odmah završi bez ponovnog poziva.
- Upis JIR-a u bazu ažurira samo redak u kojem je JIR još prazan, pa istovremeni poziv ne može upisati drugi JIR preko postojećeg.
Zahvaljujući tome nije moguće da se isti račun dva puta prijavi FINA-i.
Gdje kupac vidi JIR i ZKI?
Javna stranica narudžbe (/narudzba/{token}) nakon fiskalizacije dobiva poseban isječak s JIR-om i ZKI-jem. Kupac ih ne mora tražiti e-mailom niti prepisivati s fiskalnog računa. Dovoljno je otvoriti poveznicu iz potvrde narudžbe. Trgovac u CMS-u vidi ista dva polja, zajedno s vremenom fiskalizacije i eventualnom pogreškom ako se nešto prethodno pokvarilo.
Fiskalizacija ovisi o ispravnim Arges postavkama
Ako trgovac nije upisao Arges API token u postavkama, ili mu prekidač fiskalizacije i naplatni uređaj još nisu postavljeni, sustav fiskalizaciju preskače. API token i adresu Arges veze trgovac unosi sam u postavkama trgovine.
Prekidač fiskalizacije i ID naplatnog uređaja u ovoj verziji CMS-a nemaju vlastiti ekran: postavlja ih WebShopHR podrška u dogovoru s trgovcem, ne trgovac sam. Tek kad su sve postavke ispravne, svaka plaćena narudžba automatski ide dalje.
Ručni popust trgovca umanjuje račun, kupon i poklon bon su samo napomena
Na fiskalni račun kao stvarni popust po stavci prenosi se samo popust koji trgovac ručno postavi na narudžbi ili pojedinoj stavci, u postotku ili iznosu. To je Argesov vlastiti model popusta i nema veze s kupčevim kuponom. Kupon i poklon bon rade drukčije: njihov iznos ne umanjuje nijednu stavku na računu, nego WebShopHR uz račun samo dopiše tekstualnu napomenu (npr. "kupon LJETO10 -5,00 EUR" ili "poklon bon ABC123 -20,00 EUR") da trgovac i knjigovodstvo znaju odakle razlika. Fiskalizirani iznos narudžbe plaćene kuponom ili poklon bonom zato ostaje na punoj cijeni artikala, ne na iznosu koji je kupac stvarno platio.
Više o temi: Fiskalizacija web shopa.
Česta pitanja.
Koliko dugo kupac čeka na JIR i ZKI nakon plaćanja?
Kupac ne čeka uopće. Stranicu zahvale dobiva odmah. Fiskalizacija ide asinkrono u pozadini i JIR/ZKI se na narudžbu dopisuju za nekoliko sekundi.
Što ako Arges vrati grešku ili uopće ne odgovori?
Sustav ne zabilježi lažnu fiskalizaciju. Ako Arges vrati tehnički uspjeh bez JIR-a ili je nedostupan zbog prekida mreže, posao se sam ponavlja, a trgovac u detalju narudžbe vidi jasnu pogrešku dok fiskalizacija ne uspije.
Je li moguće da se ista narudžba fiskalizira dva puta?
Ne. Sustav ima tri sloja zaštite: jedinstveni posao po narudžbi, rani izlaz ako JIR već postoji i SQL upis koji ažurira samo redak bez JIR-a.
Gdje kupac vidi JIR i ZKI nakon plaćanja?
Na javnoj stranici narudžbe /narudzba/{token}, u posebnom isječku koji se
pojavi nakon fiskalizacije. Ne treba ih tražiti e-mailom ni prepisivati s
fiskalnog računa.
Zašto mi se narudžbe ne fiskaliziraju automatski?
Najčešće zato što Arges integracija još nije potpuno postavljena. API token upisuješ sam u postavkama, ali prekidač fiskalizacije i naplatni uređaj još nemaju vlastiti CMS ekran. Za njih se treba javiti WebShopHR podršci.
Umanjuje li kupon ili poklon bon iznos na fiskalnom računu?
Ne izravno. Fiskalni iznos ostaje na punoj cijeni artikala, a kupon i poklon bon se samo bilježe kao tekstualna napomena uz račun. Jedini popust koji se stvarno prenosi po stavci računa je ručni popust koji trgovac postavi na narudžbi.