Poreske oznake i format podataka
Većina odbijenih zahteva pada na jednom od tri mesta. Idi ovim redom.
1. Poreska oznaka mora biti tačno ona koju vrati sistem
Ne upisuj oznake u kod. Povuci važeće oznake sa GET /receipt/tax-rates za okruženje u kom radiš i pošalji tačno onu vrednost koju endpoint vrati.
Dva razloga zbog kojih je ovo pravilo, a ne preporuka:
Vizuelno slično latinično slovo nije ista vrednost i zahtev se odbija.
To nije greška, sandbox i produkcija imaju svoje skupove; kod koji radi u sandbox-u a pada u produkciji najčešće pada baš na tome.
Koja oznaka odgovara kojoj vrsti prometa nije pitanje integracije nego knjigovodstva — to potvrđuje knjigovođa trgovca za koga radiš.
2. Najviše dve decimale
Fiscomm ne zaokružuje iznose. Vrednost sa tri ili više decimala se odbija.
Ovo se najčešće javlja na izračunatim iznosima (zbirovima, popustima, ceni dostave) gde se decimale nagomilaju u samom obračunu. Zaokruži na svojoj strani pre nego što pošalješ.
3. GTIN samo ako ga stvarno imaš
GTIN je opciono polje. Ako proizvod nema registrovan barkod, nemoj ga slati — prazan ili izmišljen GTIN je čest uzrok odbijenog zahteva.
Ako ga šalješ, mora biti u dozvoljenom rasponu cifara.
Ako i dalje pada
Pošalji nam invoiceNumber iz zahteva i requestId iz odgovora, pa ćemo videti šta je stiglo do nas. Bez ta dva podatka ne možemo da nađemo konkretan zahtev.
Test i produkcija
Test i produkcioni tok su odvojeni; pre nego što pređeš u produkciju, pošalji nam po jedan primer prodaje i refundacije iz testa da ih pogledamo.
Puna referenca svih endpointa je u API dokumentaciji, a šta API pokriva pre nego što kreneš — na stranici API za fiskalizaciju. Šta sve mora da stoji na računu je na stranici fiskalni račun. Sva uputstva.