Saltar al contenido
Facturador

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:

  • 422 si falta un campo, el establecimiento no existe o el formato de la serie es inválido (p. ej. una factura que no empieza con F).
  • 409 si 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.