Secuencias · Documentación

La DGII autoriza a cada emisor rangos de e-NCF por tipo de comprobante. Regístralos en Firmo y no tendrás que mandar encf al emitir: Firmo asigna el siguiente número disponible del rango activo.

Registrar un rango#

POST/v1/sequences

Campo	Descripción
`tipo`	Tipo de e-CF.
`desde`	Número inicial del rango (entero positivo).
`hasta`	Número final del rango (entero positivo).
`venceEn`	Fecha de vencimiento autorizada, AAAA-MM-DD.

bash

curl -X POST https://api.firmo.do/v1/sequences \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tipo": 31, "desde": 1, "hasta": 500, "venceEn": "2027-12-31" }'

Listar rangos#

GET/v1/sequences

Secuencia

{
  "id": "1e2d3c4b-5a69-4788-9a0b-c1d2e3f4a5b6",
  "tipo": 31,
  "desde": 1,
  "hasta": 500,
  "siguiente": 42,
  "venceEn": "2027-12-31",
  "estado": "activa"
}

estado puede ser activa, agotada, vencida o anulada.

Si se acaban los números, la API responde 409 con código secuencia_agotada. Para enterarte antes, suscríbete al webhook secuencia.por_agotarse.