Endpointi
Svi endpointi ispod zahtijevaju autentifikaciju (API key ili JWT) i aktivnu firmu.
Base: https://api.fiskalmn.me
Bezgotovinski računi
| Method | Path | Opis |
|---|---|---|
POST | /api/invoices/draft | Kreira draft |
PUT | /api/invoices/{id} | Ažurira draft (ako podržano) |
POST | /api/invoices/{id}/fiscalize | Pokreće fiskalizaciju (202) |
GET | /api/invoices/{id} | Detalj + status |
GET | /api/invoices | Lista (paginacija / filteri) |
GET | /api/invoices/{id}/pdf | PDF fajl |
POST | /api/invoices/{id}/generate-pdf | Generiši PDF |
POST | /api/invoices/{id}/send-email | Pošalji račun emailom |
Gotovina
| Method | Path | Opis |
|---|---|---|
POST | /api/invoices/cash/create-and-print | Kreiraj + fiskalizuj (+ print flow) |
GET | /api/invoices/cash | Lista gotovinskih |
GET | /api/invoices/cash/{id} | Detalj |
GET | /api/invoices/cash/{id}/pdf |
Ostalo
| Method | Path | Opis |
|---|---|---|
GET | /api/invoices/statistics | Statistika |
GET | /api/invoices/next-sequence-number | Sljedeći redni broj |
HTTP kodovi
| Kod | Značenje |
|---|---|
| 200 | OK |
| 201 | Kreirano (npr. API key) |
| 202 | Fiskalizacija prihvaćena (pending) |
| 400 | Loš payload / validacija |
| 401 | Nedostaje / nevažeći key ili JWT |
| 403 | Pauzirana firma, pogrešan env, nema dozvole |
| 404 | Resurs ne postoji |
| 429 | Rate limit (API key) |
| 500 | Serverska greška |