Secuenciador de e-NCF

Permisos de la clave: secuencias:leer y secuencias:gestionar (este último no viene en los permisos por defecto de una clave nueva).

Qué es

La DGII autoriza a cada empresa uno o más rangos de e-NCF por tipo de comprobante (por ejemplo E31 del 1 al 500, con fecha de vencimiento). El secuenciador de BusinessLink guarda esos rangos y entrega el siguiente número disponible cada vez que se emite un comprobante, de forma atómica: aunque lleguen varias llamadas a la vez, nunca se entrega el mismo número dos veces.

Así una app no necesita llevar su propia numeración: BusinessLink es el backend de numeración y de emisión.

Quién numera: erp o businesslink

Cada empresa tiene una fuente de numeración, y es una sola (la DGII da un rango consecutivo por tipo):

  • erp: el e-NCF viene en el documento (todas las empresas con ERP existente, como Odoo).
  • businesslink: BusinessLink asigna el e-NCF en POST /v1/facturas.

El cambio lo hace el equipo de BusinessLink. Antes de cambiar a businesslink se rechazan rangos que empiecen en o antes del último e-NCF que el ERP ya emitió de ese tipo, para evitar duplicados.

Endpoints

Endpoint Qué hace
GET /v1/secuencias?tipo_ecf=31 Rangos registrados, cuántos números quedan y vencimientos.
POST /v1/secuencias Registra un rango autorizado por la DGII (OFV): tipo_ecf, desde, hasta, fecha_vencimiento, y opcionalmente siguiente (si parte del rango ya se usó) y aviso_umbral (avisar cuando queden N o menos; por defecto 50).
POST /v1/secuencias/{id}/anular con {"confirmar": true} El rango deja de entregar números. No envía nada a la DGII: los números sin usar se anulan aparte (ANECF).

Una clave bl_test_ solo ve y registra rangos de prueba; una bl_live_, los reales.

Números quemados

Un número se reutiliza solo si es seguro que la DGII nunca lo recibió (falló la validación o la firma antes de enviar). Si hubo timeout o resultado desconocido, nunca se reutiliza: se consulta el estado y, si la DGII no lo tiene, se anula con ANECF.

Avisos

BusinessLink avisa por correo cuando a un rango le quedan pocos números o está por vencer.

¿Dudas? Escríbenos o escribe a soporte@businesslink.do.