Brez aktivnega niza vrste fiscale izdaja vrne 409 no_series_configured.
Prvi račun v 6 korakih
- GET /v1/series izpiše številčne nize, nastavljene za najemnika.
- Za izdajo je potreben vsaj en AKTIVEN niz vrste fiscale.
- Brez njega POST /v1/invoices vrne 409 no_series_configured.
- Nizi se ustvarijo in aktivirajo v panelu, ne prek API.
Vse končne točke
| Metoda | Končna točka | Scope | Idempotency-Key | Zahtev / minuto |
|---|---|---|---|---|
| GET | /series Seznam številčnih nizov | invoices:read | — | 120 |
Kaj je API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Obstajati mora vsaj ena AKTIVNA serija vrste "fiscale", sicer
# POST /invoices vrne 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Napake
| Stanje | Tip | Koda |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Pogoste napake
- Odgovor na POST /v1/invoices vsebuje series in number — za usklajevanje beležite oboje.
- Storno porabi novo številko iz niza; številka prvotnega računa se nikoli ne uporabi znova.
- Predračuni uporabljajo številčenje, ločeno od davčnih nizov, zato ne porabljajo davčnih številk.
- Ne predpostavljajte oblike številke: number obravnavajte kot neprozoren niz znakov, ne kot celo število.
Vprašanja in odgovori za razvijalce
Ali lahko niz ustvarim prek API?
Ne. API nize samo bere. Ustvarjanje in aktivacija potekata v panelu, ker je davčno številčenje odločitev o skladnosti.
Kaj, če imam več aktivnih nizov?
Uporabi se privzeti niz, nastavljen v panelu. Izdaja med dvoumnimi nizi ne izbira sama.
Zakaj je no_series_configured 409 in ne 422?
Gre za konflikt s stanjem računa, ne za težavo s poslanimi podatki. Vaš payload je veljaven; manjka konfiguracija.