Secuenciales | API de facturación electrónica

Las secuencias mantienen el contador del próximo número de comprobante para cada serie: la combinación de establecimiento, punto de emisión y tipo de documento. Series distintas llevan contadores independientes (001-001-000000001 y 001-002-000000001 son válidas a la vez). El backend las crea automáticamente al crear cada punto de emisión: tu integración solo necesita consultarlas y, eventualmente, actualizar su valor.

GET/sequences API Key

Lista las secuencias de un negocio (una fila por serie).

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.

Cada fila incluye, además del tipo de documento y el value, los campos establishmentId, establishmentCode, emissionPointId y emissionPointCode que identifican la serie.

json

{
  "success": true,
  "data": [
    {
      "id": 10,
      "value": 45,
      "documentType": { "id": 1, "code": "01", "name": "FACTURA" },
      "establishmentId": 1,
      "establishmentCode": "001",
      "emissionPointId": 1,
      "emissionPointCode": "001"
    },
    {
      "id": 17,
      "value": 3,
      "documentType": { "id": 1, "code": "01", "name": "FACTURA" },
      "establishmentId": 1,
      "establishmentCode": "001",
      "emissionPointId": 2,
      "emissionPointCode": "002"
    }
  ]
}

GET/sequences/{id} API Key

Obtiene una secuencia por su ID.

Campo	Tipo	Requerido	Descripción
businessId	int	Sí	ID del negocio.

PUT/sequences/{id} API Key

Avanza el valor actual del secuencial. Solo debería usarse para alinear con el SRI tras una incidencia o al migrar desde otro sistema.

Body

Campo	Tipo	Requerido	Descripción
value	int	Sí	Nuevo valor del secuencial. Debe ser mayor o igual al valor actual.

json

{ "value": 100 }