Fără o serie activă de tip fiscale, emiterea returnează 409 no_series_configured.
Prima factură în 6 pași
- GET /v1/series listează seriile de numerotare configurate pentru tenant.
- Emiterea are nevoie de cel puțin o serie ACTIVĂ de tip fiscale.
- Fără ea, POST /v1/invoices returnează 409 no_series_configured.
- Seriile se creează și se activează în panou, nu prin API.
Toate endpoint-urile
| Metodă | Endpoint | Scope | Idempotency-Key | Cereri / minut |
|---|---|---|---|---|
| GET | /series Listează seriile de numerotare | invoices:read | — | 120 |
Ce este API-ul 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Trebuie să existe cel puțin o serie ACTIVĂ de tip "fiscale", altfel
# POST /invoices răspunde cu 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Erori
| Status | Tip | Cod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Greșeli frecvente
- Răspunsul de la POST /v1/invoices conține series și number — le loghezi pentru reconciliere.
- Storno-ul consumă un număr nou din serie; numărul facturii originale nu se refolosește niciodată.
- Proformele folosesc o numerotare separată de cea fiscală, deci nu consumă numere fiscale.
- Nu presupune un format de număr: tratează number ca șir opac, nu ca întreg.
Întrebări frecvente de la dezvoltatori
Pot crea o serie prin API?
Nu. API-ul doar citește seriile. Crearea și activarea se fac în panou, pentru că numerotarea fiscală este o decizie de conformitate.
Ce se întâmplă dacă am mai multe serii active?
Se folosește seria implicită configurată în panou. Emiterea nu alege singură între serii ambigue.
De ce primesc 409 și nu 422 pentru no_series_configured?
Este un conflict de stare a contului, nu o problemă cu datele trimise. Payload-ul tău e valid; configurația lipsește.