Interaktivni implementacioni priručnik

HOLEST E-COMMECE fiscal API V1 - Mikroservis za fiskalizaciju

Kome je ovo strana namenjena?

Sadržaj ove stane namenjen je programerima i ljudima koji učestvuju u implementaciji fiskalizacije na sistemima posebne namene. Ukoliko ste web prodavac i planirate da integrišete web fiskalizaciju preko platnog modula ili HolestPay sistema ovo ne mora da Vas zanima jer se to sve automatski izvrašava za vaš sajt u pozadini i uz to Vam daje ceo komandni interfejs.

Programeri najčešće nisu upućeni u pravila fiskalizacije, jer je to skup pravila koje je donelo zakonodavno telo i ne spada u široko korišćene globalne tehnologije sa kojima su već upoznati ili lako mogu pronaći dokumentaciju. Ovde mogu da dobiju potrebne infomacije.

Specificnosti ovog sistema

Za razliku od klasične fiskalne postavke propisna WEB rešenja moraju zadovoljiti dodatne aspekte.
  1. Kod klasične upotrebe kase (ESIR-a) postoji jedan prodavac koji sa jedne kase (ESIR-a) redom uslužuje klijente. Izmedju 2 obraćanja kasi fizicki postoji začajan vremenski razmak.  Na web-u nije isključen slucaj da 100 ljudi može odjednom poručiti nesto sa sajta, a to stvara potrebu za obradom konkurentnih zahteva i tome se mora pistupiti sa pažnjom jer se to dešava u praksi čak i kad prodavac pretpostavi da to njemu ne treba jer ima mali promet preko web-a.
  2. Kasa (ESIR) ne razmarta pojam "Narudzbina" koje je osnovni pojam u web prodaji. Jedna narudzbina moze imati vise vezanih fiskalnih dokumenta. Npr. prodaja->storniranje->prodaja ili npr. avans->strniranje avansa->avans->strniranje avansa->avans->strniranje avansa->avans->finalana prodaja. Bez umetnutog apstraktnog programskog sloja koji dodaje ovo grupaciju po narudzbinama može doci do produkcije nekonzistentnih podataka.
  3. Ovaj API prema korisnuku daje programski interfejs koji za svaku moguću akciju zahteva samo jedan zahtev i to pojednostavljenog formata. Sistem naravno u pozadini može da izvrši više zahteva prema ESIR-u i napravi više fiskalnih dokumenata. Odgovor ili kreirani .../pdf koji vi dobije sadrzi jedan ili vise fiskalnih dokumenata koji je potrebno u tom trenutku uručiti kupcu.
  4. SUF (sitem poreske kod kog završavaju svi fiskalni računi) ne vrši nikakvu proveru i validaciju - jednostavno prihvata sve što mu se prosledi. Ako napravite fiskalne dokumente pogrešno nećete biti svesni toga dok eventualno ne dobijete kaznu ili vaš knjigovođa ne uoči nepravlinosti pri izradi izveštaja. Ovaj sistem u najvećem delu slučajeva sprečava nepravilno kreiranje fiskalnih dokumenata.
  5. Ovaj sitem podrzava obradu narudzbina kod kojih su iznosi iskazani u stranoj valuti. Konverzija je automatska i servis redovno iščtava srednji kurs sa sajta NBS-a. Dovoljno je samo dodatno proslediti valutu npr. EUR.
  6. Fleksibilno i sigurno. Ovaj mikroservis ('back-box' koji samostalno rešava jedan deo funkcionalnosti vaše aplikacije) je origanalo izrađen za potrebe visoko-fleksibilne payment provider/shipping/fiscal platforme HolestPay koja je sertifikovana po strogim PCI DSS sigurnosnim standardima. Moderne web aplikacije napravljene u REACT, VUE, ANGULAR ili najnovije - poziv mikroservisa od strane AI bot-a baziranom na ChatGPT 3,4+ platformi teže da sto veći deo obrade presele na klijentsku stranu i neopterečuju vaš server. Ali kritični sigurnosni podaci transmitivani ili korišćeni u ovim web aplikacijma ili aplikacijama za pametne telefone mogu biti isčitani od motivisane strane loših namera i zloupotrebljeni. API ima opciju frontend tokena za pristup koji se može bezbedno proslediti klijentskom delu aplikacije da bi sama završila celu mikroservis-obradu. Promene na vašem serverskom sitemu sa ovakvim konceptom implementaciju su minimalne. Takodje možete izbeci neugodno zahtevanje JMBG-a ili Br. licne karte, inače obaveznih za storniranje za F.L.. Kupci se često bune i optužuju Vas da nemate pravo da tražite te podatke a ovako kupac može sam to da unese ako želi povrat. Dovoljno je da dodate generisani fronttoken u podatke vaše narudzbine ili jednostavno postavite sporednu php (ili sl..) starnu od par linija koda koja će klijentskom delu sistema izdavati ove fronttoken-e.
  7. Web ESIR (kasa) se dobija uz API. Normalno za web ESIR je vezan na VPFR ali se ukoliko imate neki specifičan zahtev može vezati i na Vaš lokalni LPFR

Ovaj sitem prilagođen je web primeni i rešava sve pomenute probleme koji se javljaju kada se fiskalizacija izvršava sa web-a.


Sta mi pruža ovaj interaktivni priručnik?

  1. Ne-tehnicka razjasnjenja pravila fiskalizacije dovoljna programeru da bi uradio implementaciju
  2. Tehnnicko uptstvo i instrukcije za implementaciju api-ja
  3. Proba API-ja i prikaz svih elemenata zahteva (sama stana koristi javascipt za sve operacije)

U nastavku opšta refrenca pristupnih tačaka API servisa