# 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.
