Ponovljeni zahtevi i duplirani računi
Zahtev je pao. Nemoj ga odmah ponoviti
Ako poziv padne u timeout ili vrati grešku servera, račun je možda ipak izdat. Ponovljeni poziv u tom slučaju pravi drugi fiskalni račun na isti promet.
Pre ponovnog slanja proveri da račun već ne postoji.
Proveri i telo odgovora, ne samo HTTP status
Zna se desiti da odgovor ima status koji izgleda uspešno, a da je greška u telu odgovora. Ako tvoj kod grana samo po statusnom kodu, neuspeh prolazi neprimećeno — a to znači da računi tiho prestaju da izlaze i da to niko ne vidi danima.
Proveri i jedno i drugo.
Duplikat je već napravljen
Piši nam i pošalji spisak: datum, broj porudžbine, iznos. Spisak u tabeli je znatno brži za obradu od duplikata prijavljenih jedan po jedan.
Storniramo duplikate i pošaljemo ti linkove ka storno računima.
Obavesti knjigovođu trgovca o storniranju — to je deo koji se najčešće preskoči, pa se razlika pojavi kasnije u usaglašavanju.
Delimičan povraćaj više puta na istoj porudžbini
Radi. Više uzastopnih delimičnih povraćaja na istoj porudžbini prolazi, i za svaki se izda zaseban storno.
Nemam gde da vidim svoje greške
Trenutno ne postoji ekran ni endpoint na kom bi video svoje zahteve, odgovore i greške. Znamo da vam to nedostaje — traži se odavno i još uvek ne postoji.
Dok ga nema: loguj kod sebe i zahtev i ceo odgovor, uključujući requestId. Kad nam pišeš, to je jedino po čemu možemo da nađemo konkretan poziv.
Šta API pokriva pre nego što kreneš — API za fiskalizaciju. Puna referenca svih endpointa — API dokumentacija. Ostala uputstva za integratore su u bazi znanja za API, a sva uputstva su na jednom mestu.