Endpointi
Svi endpointi zahtijevaju autentifikaciju (API key) i aktivnu firmu.
Base: https://api.fiskalmn.me
Računi
| Method | Path | Opis |
|---|---|---|
POST | /api/invoices/draft | Kreira draft |
PUT | /api/invoices/{id}/draft | Ažurira draft |
POST | /api/invoices/{id}/fiscalize | Fiskalizuje; za Cash automatski registruje INITIAL |
GET | /api/invoices/{id} | Detalj + status |
GET | /api/invoices | Lista |
GET | /api/invoices/{id}/pdf | |
POST | /api/invoices/{id}/generate-pdf | Generiši PDF |
POST | /api/invoices/{id}/send-email | Pošalji emailom |
Korektivni / storno: isti endpointi, type: "Corrective" + original. Vidi Storno i korektivni.
Gotovinski računi
| Method | Path | Opis |
|---|---|---|
POST | /api/invoices/cash/create-and-print | Draft + fiskalizacija + PDF (jedan korak) |
POST | /api/cashdeposit/initial | Početni depozit (onboarding) |
POST | /api/tcr/register | Registracija ENU (onboarding) |
POST | /api/cashdeposit/register | Napredna registracija depozita (WITHDRAW, …) |
GET | /api/invoices/cash | Lista gotovinskih |
GET | /api/invoices/cash/{id} | Detalj |
GET | /api/invoices/cash/{id}/pdf |
Detalji: Gotovinski računi.
Za storno gotovinskog: isti endpoint, type: "Corrective" i original — Storno i korektivni.
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 |
| 202 | Fiskalizacija prihvaćena (pending) |
| 400 | Loš payload / validacija |
| 401 | Nedostaje / nevažeći key |
| 403 | Pauzirana firma, nema dozvole |
| 404 | Resurs ne postoji |
| 429 | Rate limit |
| 500 | Serverska greška |