API ključ, test i produkcija
Odgovori na pitanja koja nam integratori najčešće postavljaju pre prvog pravog računa. Kako se šalje prvi zahtev piše u dokumentaciji za programere.
Gde se pravi API ključ
Ključ pravi vlasnik naloga u kasi, pod Podešavanja → API Ključ. Ključ je vezan za jednu prodavnicu, odnosno jedan bezbednosni element: dve prodavnice ili dva sajta znače dva ključa.
Radiš integraciju za klijenta? Ključ dobijaš od njega, iz njegovog naloga. Na koju firmu i prodavnicu je ključ vezan proveravaš pozivom GET /auth/api-key/me.
Kako da testiraš pre produkcije
Adresa je ista za test i za produkciju: https://api.fiscomm.rs. Okruženje određuje nalog, odnosno sertifikat iza ključa, a ne adresa. Druge adrese koje možda vidiš u starim primerima nisu za integracije.
GET /receipt/tax-rates, ne prepisuj ih iz testa. Više u poreskim oznakama.
Šta zahtev mora da ima
Plaćanja se šalju kao niz payments, a svaki račun ima obavezan i jedinstvenorderNumber. Odgovor vraća correlationId i receipt. Sva polja su u referenci API-ja.
Ključ koji važi samo za test pušta predračune i training račune. Za prave račune ti treba ključ sa naloga koji ima pravi sertifikat.
Zahtev je pao, a ne znaš da li je račun izdat
Pošalji isti zahtev ponovo, sa istim orderNumber isettings.returnIfOrderNumberExists: true. Ako je račun već izdat, dobijaš njega nazad umesto novog. Zaštita važi 14 dana, po prodavnici i vrsti računa.
Fiksnog ograničenja broja zahteva nema, ali zahteve za istu porudžbinu ne šalji paralelno. Više o duplikatima u ponovljenim zahtevima.