Sans série active de type fiscale, l'émission renvoie 409 no_series_configured.
← Retour à la documentation API
Votre première facture en 6 étapes
- GET /v1/series liste les séries de numérotation configurées pour le tenant.
- L’émission nécessite au moins une série ACTIVE de type fiscale.
- Sans elle, POST /v1/invoices renvoie 409 no_series_configured.
- Les séries sont créées et activées dans le panneau, pas via l’API.
Tous les endpoints
| Méthode | Endpoint | Scope | Idempotency-Key | Requêtes / minute |
|---|---|---|---|---|
| GET | /series Lister les séries de numérotation | invoices:read | — | 120 |
Ce qu'est l'API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Il faut au moins une série ACTIVE de type "fiscale", sinon
# POST /invoices renvoie 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Erreurs
| Statut | Type | Code |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Erreurs fréquentes
- La réponse de POST /v1/invoices contient series et number — journalisez les deux pour le rapprochement.
- Une facture d’annulation (storno) consomme un nouveau numéro de la série ; le numéro de la facture d’origine n’est jamais réutilisé.
- Les factures pro forma utilisent une numérotation distincte des séries fiscales et ne consomment donc aucun numéro fiscal.
- Ne présumez aucun format de numéro : traitez number comme une chaîne opaque, et non comme un entier.
Questions et réponses pour développeurs
Puis-je créer une série via l’API ?
Non. L’API ne fait que lire les séries. Leur création et leur activation se font dans le panneau, car la numérotation fiscale est une décision de conformité.
Et si j’ai plusieurs séries actives ?
C’est la série par défaut configurée dans le panneau qui est utilisée. L’émission ne choisit pas d’elle-même entre des séries ambiguës.
Pourquoi no_series_configured est-il une 409 et non une 422 ?
Il s’agit d’un conflit lié à l’état du compte, et non d’un problème dans les données envoyées. Votre payload est valide ; c’est la configuration qui manque.