Numeración y control

Zentto Imprenta Digital opera un modelo de numeración de doble nivel: el número de documento (correlativo del emisor) y el número de control fiscal (NCF-D), que Zentto genera de forma propia desde sus series internas.

Número de documento

Es el correlativo del emisor por tipo de documento, controlado por el sistema cliente. Se envía en el campo documentNumber de cada emisión.

Número de control fiscal (NCF-D)

Lo asigna Zentto al momento de la emisión y se devuelve en controlNumber. Se forma como Prefijo + LPAD(correlativo, 8, "0") (p. ej. 00012345).

Persistencia obligatoria

El sistema cliente debe persistir el número de control devuelto. Junto con la cadena hash, constituye la evidencia fiscal verificable del documento.

Series propias

Cada serie es un rango [Desde, Hasta] asignado a una empresa-cliente para un tipo de documento, en la tabla imprenta."ControlSerie":

Campo	Descripción
CompanyId	Empresa-cliente dueña de la serie.
Serie	Identificador de serie.
TipoDocumento	01..07.
Prefijo	Prefijo del número de control.
Desde / Hasta	Límites del rango.
Correlativo	Último número consumido (atómico).
Estado	ACTIVA · AGOTADA · SUSPENDIDA.

Asignación atómica — fn_assign_control_serie

La función PL/pgSQL imprenta.fn_assign_control_serie(p_company_id, p_tipo_doc, p_serie):

1. Selecciona la serie ACTIVA con SELECT ... FOR UPDATE (bloqueo de fila).
2. Calcula el siguiente número (Desde en el primer consumo, luego Correlativo + 1).
3. Si supera Hasta, marca la serie AGOTADA y no devuelve número.
4. Actualiza Correlativo y devuelve Prefijo + LPAD(número, 8, "0").

Esto garantiza un correlativo sin huecos ni colisiones bajo concurrencia.

Gestión de rangos (vertical / integrador)

Operación	Ruta	Quién
Asignar rango	POST /v1/imprenta/asignaciones	Vertical (empresa)
Listar numeraciones	GET /v1/imprenta/numeraciones	Vertical
Generar serie	POST /v1/imprenta/backoffice/series	Solo ZENTTO_SUPERADMIN
Extender / reasignar serie	POST /v1/imprenta/backoffice/series/{id}/extender · /reasignar	Solo ZENTTO_SUPERADMIN
Consultar rangos del integrador	GET /api/numeraciones	Integrador

Resumen

Nivel	Quién lo controla	Campo	Cuándo se asigna
Número de documento	Sistema cliente	documentNumber	Al construir el documento
Número de control NCF-D	Zentto (serie propia)	controlNumber	En la respuesta de emisión