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
`CARD` na `NonCash`	400	Način plaćanja nije dozvoljen — vidi Načini plaćanja
INITIAL depozit nije uspio	400	`code: "INITIAL_DEPOSIT_FAILED"` — vidi Gotovinski računi
EFI TCR/ENU (Code 53, 11)	400	Provjeri ENU u adminu ili `POST /api/tcr/register` sa `{}`
Previše requesta	429	Rate limit
Sertifikat / poreski servis	500 / Failed	Serverska ili poreska greška
`quantity` = 0 na korektivnom	400	Količina na korektivnom računu ne smije biti 0 — Storno i korektivni
Nema `original` na `Corrective`	400	Obavezni su IIC i datum izdavanja originala

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

Storno i korektivni Best practices