Senza una serie attiva di tipo fiscale, l'emissione restituisce 409 no_series_configured.
← Torna alla documentazione API
La prima fattura in 6 passi
- GET /v1/series elenca le serie di numerazione configurate per il tenant.
- Per l’emissione serve almeno una serie ATTIVA di tipo fiscale.
- In sua assenza, POST /v1/invoices restituisce 409 no_series_configured.
- Le serie si creano e si attivano nel pannello, non tramite l’API.
Tutti gli endpoint
| Metodo | Endpoint | Scope | Idempotency-Key | Richieste / minuto |
|---|---|---|---|---|
| GET | /series Elenca le serie di numerazione | invoices:read | — | 120 |
Cos'è l'API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Deve esistere almeno una serie ATTIVA di tipo "fiscale", altrimenti
# POST /invoices restituisce 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Errori
| Stato | Tipo | Codice |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Errori frequenti
- La risposta di POST /v1/invoices contiene series e number: registrali entrambi per la riconciliazione.
- Uno storno consuma un nuovo numero della serie; il numero della fattura originale non viene mai riutilizzato.
- Le proforma usano una numerazione separata dalle serie fiscali, quindi non consumano numeri fiscali.
- Non dare per scontato un formato di numero: tratta number come una stringa opaca, non come un intero.
Domande e risposte per sviluppatori
Posso creare una serie tramite l’API?
No. L’API legge soltanto le serie. La creazione e l’attivazione avvengono nel pannello, perché la numerazione fiscale è una decisione di conformità.
E se ho più serie attive?
Viene usata la serie predefinita configurata nel pannello. L’emissione non sceglie da sola tra serie ambigue.
Perché no_series_configured è un 409 e non un 422?
È un conflitto legato allo stato dell’account, non un problema dei dati inviati. Il tuo payload è valido; manca la configurazione.