Sense una sèrie activa de tipus fiscale, l'emissió retorna 409 no_series_configured.
← Torna a la documentació de l'API
La teva primera factura en 6 passos
- GET /v1/series llista les sèries de numeració configurades per al client.
- L'emissió necessita almenys una sèrie ACTIVA de tipus fiscale.
- Sense cap, POST /v1/invoices retorna 409 no_series_configured.
- Les sèries es creen i s'activen al panell, no mitjançant l'API.
Tots els punts finals
| Mètode | Punt final | Àmbit | Idempotency-Key | Peticions / minut |
|---|---|---|---|---|
| GET | /series Llista les sèries de numeració | invoices:read | — | 120 |
Què és l'API de 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Ha d'existir almenys una sèrie ACTIVA de tipus «fiscale», altrament
# POST /invoices retorna 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Errors
| Estat | Tipus | Codi |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Errors habituals
- La resposta de POST /v1/invoices porta series i number — registra'ls tots dos per a la conciliació.
- Un storno consumeix un número nou de la sèrie; el número de la factura original mai no es reutilitza.
- Les proformes fan servir una numeració separada de la sèrie fiscal, de manera que no consumeixen números fiscals.
- No suposis un format de número: tracta number com una cadena opaca, no com un enter.
Preguntes i respostes per a desenvolupadors
Puc crear una sèrie a través de l'API?
No. L'API només llegeix les sèries. Es creen i s'activen al panell, perquè la numeració fiscal és una decisió de compliment.
Què passa si tinc diverses sèries actives?
S'utilitza la sèrie per defecte configurada al panell. L'emissió no tria per si sola entre sèries ambigües.
Per què no_series_configured és un 409 i no un 422?
És un conflicte d'estat del compte, no un problema amb les dades que has enviat. La teva càrrega útil és vàlida; el que falta és la configuració.