Nummerserier i API'et

Uden en aktiv serie af typen fiscale returnerer udstedelse 409 no_series_configured.

Din første faktura i 6 trin

GET /v1/series lister de nummerserier, der er konfigureret for tenanten.
Udstedelse kræver mindst én AKTIV serie af typen fiscale.
Uden en sådan returnerer POST /v1/invoices 409 no_series_configured.
Serier oprettes og aktiveres i panelet, ikke gennem API'et.

Alle endpoints

Metode	Endpoint	Scope	Idempotency-Key	Anmodninger / minut
GET	/series List nummerserier	invoices:read	—	120

Hvad 4invoices API'et er

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

# Der skal findes mindst én AKTIV serie af typen "fiscale", ellers
# returnerer POST /invoices 409 no_series_configured.

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

Fejl

Status	Type	Kode
409	conflict_error	no_series_configured

Almindelige fejl

Svaret fra POST /v1/invoices indeholder series og number — log begge til afstemning.
En storno forbruger et nyt nummer fra serien; den oprindelige fakturas nummer genbruges aldrig.
Proformaer bruger en nummerering adskilt fra den fiskale serie, så de forbruger ingen fiskale numre.
Antag ikke et nummerformat: behandl number som en uigennemsigtig streng, ikke som et heltal.

Spørgsmål og svar for udviklere

Kan jeg oprette en serie via API'et?

Nej. API'et læser kun serier. Oprettelse og aktivering sker i panelet, fordi fiskal nummerering er en compliance-beslutning.

Hvad hvis jeg har flere aktive serier?

Standardserien, der er konfigureret i panelet, bruges. Udstedelse vælger ikke selv mellem tvetydige serier.

Hvorfor er no_series_configured en 409 og ikke en 422?

Det er en konflikt i kontoens tilstand, ikke et problem med de data, du sendte. Din payload er gyldig; konfigurationen mangler.

Se også