EXTERNAL API v1

Integracioni ugovor

Osnovna adresa: https://api.fiskalnakasa.online/api/integration/v1. Svi odgovori su JSON, a svi zaštićeni zahtevi koriste Bearer token.

1. Autorizacija

Token se dobija OAuth Client Credentials prijavom. Client Secret se prikazuje samo jednom pri izdavanju u Account portalu.

POST https://api.fiskalnakasa.online/api/integration/v1/oauth/token
Content-Type: application/json

{"grant_type":"client_credentials","client_id":"...","client_secret":"..."}

2. Kontekst i katalog

GET/contextcontext.read

GET/catalogcatalog.read

GET/productscatalog.read

GET/customerscatalog.read

GET/taxescatalog.read

3. Fiskalni računi

GET/receiptsreceipts.read

POST/receiptsreceipts.create

Za POST koristite stabilan external_document_id. Ponovljen zahtev sa istim identifikatorom ne sme kreirati dupli račun.

4. Dokumenti i dostava

GET/receipts/{uuid}/pdfreceipts.deliver

GET/receipts/{uuid}/journalreceipts.deliver

POST/receipts/{uuid}/emailreceipts.deliver

5. Statusi i greške

401 nevažeći token, 403 nedovoljan scope ili nedostupna kasa, 422 neispravan zahtev, 409 konflikt stanja, 503 servis privremeno nije dostupan.