Nummerreeksen in de API

Zonder actieve reeks van het type fiscale geeft uitgifte 409 no_series_configured.

Je eerste factuur in 6 stappen

GET /v1/series toont de nummerreeksen die voor de tenant zijn geconfigureerd.
Voor uitgifte is minstens één ACTIEVE reeks van het type fiscale nodig.
Zonder zo'n reeks geeft POST /v1/invoices 409 no_series_configured terug.
Reeksen worden in het paneel aangemaakt en geactiveerd, niet via de API.

Alle endpoints

Methode	Endpoint	Scope	Idempotency-Key	Verzoeken / minuut
GET	/series Nummerreeksen weergeven	invoices:read	—	120

Wat de 4invoices-API is

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

# Er moet minstens één ACTIEVE reeks van het type "fiscale" bestaan, anders
# geeft POST /invoices 409 no_series_configured terug.

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

Fouten

Status	Type	Code
409	conflict_error	no_series_configured

Veelgemaakte fouten

De respons van POST /v1/invoices bevat series en number — log beide voor de afstemming.
Een creditering (storno) verbruikt een nieuw nummer uit de reeks; het nummer van de oorspronkelijke factuur wordt nooit hergebruikt.
Proforma's gebruiken een nummering los van de fiscale reeksen, dus ze verbruiken geen fiscale nummers.
Ga niet uit van een nummerformaat: behandel number als een ondoorzichtige string, niet als een integer.

Vragen en antwoorden voor ontwikkelaars

Kan ik een reeks via de API aanmaken?

Nee. De API leest reeksen alleen. Aanmaken en activeren gebeurt in het paneel, omdat fiscale nummering een compliancebeslissing is.

Wat als ik meerdere actieve reeksen heb?

Dan wordt de standaardreeks gebruikt die in het paneel is geconfigureerd. De uitgifte kiest niet zelf tussen dubbelzinnige reeksen.

Waarom is no_series_configured een 409 en geen 422?

Het is een conflict in de accountstatus, geen probleem met de gegevens die u hebt gestuurd. Uw payload is geldig; de configuratie ontbreekt.

Zie ook