Bez aktivne serije tipa fiscale izdavanje vraća 409 no_series_configured.
Prva faktura u 6 koraka
- GET /v1/series ispisuje serije numeriranja konfigurirane za tenanta.
- Za izdavanje je potrebna barem jedna AKTIVNA serija vrste fiscale.
- Bez nje POST /v1/invoices vraća 409 no_series_configured.
- Serije se stvaraju i aktiviraju u panelu, a ne preko API-ja.
Svi endpointi
| Metoda | Endpoint | Scope | Idempotency-Key | Zahtjeva / minutu |
|---|---|---|---|---|
| GET | /series Popis serija numeracije | invoices:read | — | 120 |
Što je 4invoices API
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Mora postojati barem jedna AKTIVNA serija vrste "fiscale", inače
# POST /invoices vraća 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Pogreške
| Status | Tip | Kod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Česte pogreške
- Odgovor na POST /v1/invoices sadrži series i number — zabilježite oboje radi usklađivanja.
- Storno troši novi broj iz serije; broj izvorne fakture nikad se ne koristi ponovno.
- Predračuni koriste numeriranje odvojeno od fiskalnih serija, pa ne troše fiskalne brojeve.
- Ne pretpostavljajte format broja: number tretirajte kao neprozirni niz znakova, a ne kao cijeli broj.
Pitanja i odgovori za razvijatelje
Mogu li stvoriti seriju preko API-ja?
Ne. API serije samo čita. Stvaranje i aktivacija obavljaju se u panelu, jer je fiskalno numeriranje odluka o usklađenosti.
Što ako imam više aktivnih serija?
Koristi se zadana serija konfigurirana u panelu. Izdavanje ne bira samo između dvosmislenih serija.
Zašto je no_series_configured 409, a ne 422?
To je sukob sa stanjem računa, a ne problem s podacima koje ste poslali. Vaš payload je valjan; nedostaje konfiguracija.