Nummerserier i API:t

Utan en aktiv serie av typen fiscale returnerar utfärdandet 409 no_series_configured.

Din första faktura i 6 steg

GET /v1/series listar nummerserierna som är konfigurerade för tenanten.
Utfärdande kräver minst en AKTIV serie av typen fiscale.
Utan en sådan returnerar POST /v1/invoices 409 no_series_configured.
Serier skapas och aktiveras i panelen, inte via API:t.

Alla endpoints

Metod	Endpoint	Scope	Idempotency-Key	Förfrågningar / minut
GET	/series Lista nummerserier	invoices:read	—	120

Vad 4invoices API är

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

# Det måste finnas minst en AKTIV serie av typen "fiscale", annars
# returnerar POST /invoices 409 no_series_configured.

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

Fel

Status	Typ	Kod
409	conflict_error	no_series_configured

Vanliga misstag

Svaret från POST /v1/invoices innehåller series och number — logga båda för avstämning.
Ett storno förbrukar ett nytt nummer från serien; originalfakturans nummer återanvänds aldrig.
Proformor använder en numrering skild från den fiskala serien, så de förbrukar inga fiskala nummer.
Anta inget nummerformat: behandla number som en ogenomskinlig sträng, inte som ett heltal.

Frågor och svar för utvecklare

Kan jag skapa en serie via API:t?

Nej. API:t läser bara serier. Att skapa och aktivera dem sker i panelen, eftersom fiskal numrering är ett regelefterlevnadsbeslut.

Vad händer om jag har flera aktiva serier?

Standardserien som är konfigurerad i panelen används. Utfärdandet väljer inte själv mellan tvetydiga serier.

Varför är no_series_configured en 409 och inte en 422?

Det är en konflikt i kontots tillstånd, inte ett problem med den data du skickade. Din payload är giltig; konfigurationen saknas.

Se även