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 enPOST /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.