Crear serie
POST /api/series
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra una serie para un establecimiento.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
establishment_id |
integer | Sí | Establecimiento al que pertenece la serie (ver 1. Establecimientos). |
document_type_id |
string | Sí | Tipo de documento: 01, 03, 07, 08, 09, 31, 80... |
number |
string | Sí | Serie de 4 caracteres (ver tabla de formatos). |
contingency |
boolean | No | true si es una serie de contingencia (numérica). Por defecto false. |
dedicated |
boolean | No | true si la serie es dedicada (reservada a un dispositivo o punto de venta). Por defecto false. |
series_device_group_id |
integer | No | Grupo de dispositivos al que se asigna la serie. null si no aplica. |
correlative |
integer | No | Último número ya emitido con esta serie fuera de la plataforma (≥ 0). El primer comprobante saldrá con correlative + 1. 0 = empieza en 1. Solo se puede configurar mientras la serie no tenga comprobantes. |
Errores:
422si falta un campo, el establecimiento no existe o el formato de la serie es inválido (p. ej. una factura que no empieza conF).409si ya existe la misma serie para ese tipo de documento (La serie ya ha sido registrada) o si la empresa es NRUS y el tipo no está permitido.
Cuerpo
Content-Type: application/json
{
"establishment_id": 1,
"document_type_id": "01",
"number": "F002",
"contingency": false,
"dedicated": false,
"series_device_group_id": null,
"correlative": 150
}
Respuestas
201 — Creada
{
"success": true,
"data": {
"id": 12,
"establishment_id": 1,
"document_type_id": "01",
"number": "F002",
"contingency": false,
"dedicated": false,
"in_use": false,
"series_device_group_id": null,
"group_name": null,
"category": "invoice",
"document_type_description": "Factura electrónica",
"correlative": 150
},
"message": "Serie registrada con éxito"
}
422 — Formato inválido
{
"success": false,
"message": {
"number": [
"El formato de la serie es inválido - Formato del campo: [F][A-Z0-9]{3}, Ejemplo: FF01"
]
}
}
409 — Serie duplicada
{
"success": false,
"message": "La serie ya ha sido registrada"
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.