Sin una serie activa de tipo fiscale, la emisión devuelve 409 no_series_configured.
← Volver a la documentación de la API
Tu primera factura en 6 pasos
- GET /v1/series lista las series de numeración configuradas para el tenant.
- La emisión requiere al menos una serie ACTIVA de tipo fiscale.
- Sin ella, POST /v1/invoices devuelve 409 no_series_configured.
- Las series se crean y se activan en el panel, no a través de la API.
Todos los endpoints
| Método | Endpoint | Scope | Idempotency-Key | Peticiones / minuto |
|---|---|---|---|---|
| GET | /series Listar las series de numeración | invoices:read | — | 120 |
Qué es la API de 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Debe existir al menos una serie ACTIVA de tipo "fiscale"; si no,
# POST /invoices devuelve 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Errores
| Estado | Tipo | Código |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Errores frecuentes
- La respuesta de POST /v1/invoices incluye series y number: registra ambos para la conciliación.
- Una anulación (storno) consume un número nuevo de la serie; el número de la factura original nunca se reutiliza.
- Las proformas usan una numeración separada de las series fiscales, por lo que no consumen números fiscales.
- No presupongas un formato de número: trata number como una cadena opaca, no como un entero.
Preguntas y respuestas para desarrolladores
¿Puedo crear una serie a través de la API?
No. La API solo lee series. Crearlas y activarlas se hace en el panel, porque la numeración fiscal es una decisión de cumplimiento normativo.
¿Y si tengo varias series activas?
Se usa la serie predeterminada configurada en el panel. La emisión no elige por sí sola entre series ambiguas.
¿Por qué no_series_configured es un 409 y no un 422?
Es un conflicto de estado de la cuenta, no un problema de los datos que has enviado. Tu payload es válido; lo que falta es la configuración.