Statusi i greške

Status računa

Status	Značenje
`Draft`	Sačuvan, nije fiskalizovan
`Pending`	Fiskalizacija u toku
`Fiscalized`	Uspješno — imate IIC/FIC
`Failed`	Neuspjeh — pogledajte `errorMessage`
`Offline`	Potpisano offline; sync kasnije

Preporučeni poll loop

POST /fiscalize  →  202
loop:
  GET /{id}
  if Fiscalized → gotovo (IIC/FIC/PDF)
  if Failed → log + alert
  if Pending → wait 1–2s (backoff)
  timeout → alert za ručnu provjeru

Tipične greške

Situacija	HTTP	Poruka (smisao)
Nema / loš key	401	Nevažeći API ključ
Pauzirana firma	403	Firma je pauzirana…
Live key na Test firmi	403	Ključ ne odgovara okruženju
Nevalidan JSON	400	Validacija polja
Previše requesta	429	Rate limit
Sertifikat / poreski servis	500 / Failed	Serverska ili poreska greška

Idempotentnost

Trenutno nema Idempotency-Key headera. Sa svoje strane:

čuvajte mapiranje orderId → invoiceId
ne zovite fiscalize dvaput za istu narudžbu bez provere statusa
pri retry-ju prvo GET postojeći draft/invoice

Payload Best practices