Nummernkreise in der API

Ohne aktive Serie vom Typ fiscale liefert die Ausstellung 409 no_series_configured.

Die erste Rechnung in 6 Schritten

GET /v1/series listet die für den Mandanten konfigurierten Nummernserien.
Für die Ausstellung ist mindestens eine AKTIVE Serie vom Typ fiscale nötig.
Ohne eine solche liefert POST /v1/invoices 409 no_series_configured.
Serien werden im Panel angelegt und aktiviert, nicht über die API.

Alle Endpunkte

Methode	Endpunkt	Scope	Idempotency-Key	Anfragen / Minute
GET	/series Nummernkreise auflisten	invoices:read	—	120

Was die 4invoices-API ist

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

# Es muss mindestens eine AKTIVE Serie vom Typ "fiscale" existieren, sonst
# liefert POST /invoices 409 no_series_configured zurück.

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

Fehler

Status	Typ	Code
409	conflict_error	no_series_configured

Häufige Fehler

Die Antwort von POST /v1/invoices enthält series und number – protokollieren Sie beides für den Abgleich.
Ein Storno verbraucht eine neue Nummer aus der Serie; die Nummer der ursprünglichen Rechnung wird nie wiederverwendet.
Proformarechnungen nutzen eine von den fiskalischen Serien getrennte Nummerierung und verbrauchen daher keine fiskalischen Nummern.
Setzen Sie kein Nummernformat voraus: Behandeln Sie number als undurchsichtigen String, nicht als Ganzzahl.

Fragen und Antworten für Entwickler

Kann ich eine Serie über die API anlegen?

Nein. Die API liest Serien nur. Anlegen und Aktivieren erfolgen im Panel, weil die fiskalische Nummerierung eine Compliance-Entscheidung ist.

Was, wenn ich mehrere aktive Serien habe?

Es wird die im Panel konfigurierte Standardserie verwendet. Die Ausstellung wählt nicht selbstständig zwischen mehrdeutigen Serien.

Warum ist no_series_configured ein 409 und kein 422?

Es ist ein Konflikt mit dem Kontozustand, kein Problem mit den gesendeten Daten. Ihr Payload ist gültig; es fehlt die Konfiguration.

Siehe auch