Bez aktivne serije tipa fiscale, izdavanje vraća 409 no_series_configured.
Vaša prva faktura u 6 koraka
- GET /v1/series prikazuje serije numeracije konfigurisane za klijenta.
- Izdavanje zahtijeva bar jednu AKTIVNU seriju tipa fiscale.
- Bez nje, POST /v1/invoices vraća 409 no_series_configured.
- Serije se kreiraju i aktiviraju u panelu, ne preko API-ja.
Sve krajnje tačke
| Metod | Krajnja tačka | Opseg | Idempotency-Key | Zahtjeva / minut |
|---|---|---|---|---|
| GET | /series Listanje serija numeracije | invoices:read | — | 120 |
Šta je API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Mora postojati bar jedna AKTIVNA serija tipa "fiscale", inače
# POST /invoices vraća 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Greške
| Status | Tip | Kod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Česte greške
- Odgovor POST /v1/invoices nosi series i number — zabilježite oboje radi usklađivanja.
- Storno troši novi broj iz serije; broj originalne fakture se nikada ne koristi ponovo.
- Predračuni koriste numeraciju odvojenu od fiskalne serije, pa ne troše fiskalne brojeve.
- Ne pretpostavljajte format broja: tretirajte number kao neprozirni string, a ne kao cijeli broj.
Pitanja i odgovori za programere
Mogu li kreirati seriju preko API-ja?
Ne. API samo čita serije. Kreiranje i aktivacija su u panelu, jer je fiskalna numeracija pitanje usklađenosti.
Šta ako imam više aktivnih serija?
Koristi se podrazumijevana serija konfigurisana u panelu. Izdavanje sam ne bira između nejasnih serija.
Zašto je no_series_configured 409, a ne 422?
To je sukob stanja naloga, a ne problem sa podacima koje ste poslali. Vaš zahtjev je važeći; nedostaje konfiguracija.