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

Demo nalogtest sertifikat i test poreske oznake; računi idu u test okruženje Poreske uprave i nisu fiskalni.
Training račun na bilo kom naloguinvoiceType „training" — prođe ceo tok, a na računu piše „OVO NIJE FISKALNI RAČUN".

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.

Poreske oznake na demo nalogu nisu iste kao na produkciji. Kad pređeš na pravi nalog, ponovo ih učitaj sa 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.

Česte greške pri povezivanju ERP-a

Predračunide na POST /receipt/drafts, ne kao obični račun.
Plaćanje koje nije gotovina, kartica ni prenosšalje se kao type „Other".
Popust na ceo računPoreska uprava ga ne prima kao posebnu stavku: umanji cene stavki srazmerno, tako da zbir ostane isti.
Sledeći korak

Treba ti demo nalog za integraciju? Otvori nalog ili nam piši.

Otvori nalog