Nummerserier i API-et

Uten en aktiv serie av typen fiscale returnerer utstedelse 409 no_series_configured.

Din første faktura på 6 steg

GET /v1/series lister nummerseriene som er konfigurert for tenanten.
Utstedelse krever minst én AKTIV serie av typen fiscale.
Uten den returnerer POST /v1/invoices 409 no_series_configured.
Serier opprettes og aktiveres i panelet, ikke gjennom API-et.

Alle endepunkter

Metode	Endepunkt	Scope	Idempotency-Key	Forespørsler / minutt
GET	/series List nummerserier	invoices:read	—	120

Hva 4invoices-API-et er

bash
curl -sS https://api.4invoices.net/v1/series \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Det må finnes minst én AKTIV serie av typen "fiscale", ellers
# returnerer POST /invoices 409 no_series_configured.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Feil

Status	Type	Kode
409	conflict_error	no_series_configured

Vanlige feil

Svaret fra POST /v1/invoices inneholder series og number — logg begge til avstemming.
En storno bruker et nytt nummer fra serien; originalfakturaens nummer gjenbrukes aldri.
Proformaer bruker nummerering som er skilt fra den fiskale serien, så de forbruker ingen fiskale numre.
Anta ikke et nummerformat: behandle number som en ugjennomsiktig streng, ikke som et heltall.

Spørsmål og svar for utviklere

Kan jeg opprette en serie via API-et?

Nei. API-et leser bare serier. Opprettelse og aktivering skjer i panelet, fordi fiskal nummerering er en compliance-beslutning.

Hva hvis jeg har flere aktive serier?

Standardserien som er konfigurert i panelet brukes. Utstedelse velger ikke selv mellom tvetydige serier.

Hvorfor er no_series_configured en 409 og ikke en 422?

Det er en konflikt i kontoens tilstand, ikke et problem med dataene du sendte. Forespørselen er gyldig; konfigurasjonen mangler.

Se også