Configuración

Configuración inicial (backoffice)

La puesta en marcha de un cliente la realiza el operador de la imprenta desde el backoffice (ver Manual del backoffice):

1. Generar una serie de números de control para la empresa-cliente (POST /v1/imprenta/backoffice/series, solo ZENTTO_SUPERADMIN): tipo de documento, serie, prefijo y rango [Desde, Hasta].
2. Definir la tarifa del cliente (precio por número de control y/o por bloque, números incluidos gratis).
3. Si aplica, registrar el integrador y emitir su token de API (tokenUsuario + secret, este último se muestra una sola vez).

Operación desde el ERP / POS

Cuando el comercio factura desde el ERP o el POS de Zentto, la emisión a la imprenta digital ocurre automáticamente, sin pasos manuales adicionales: la venta no se bloquea y la transmisión de cumplimiento se reintenta en segundo plano.

Variables de entorno del microservicio

Variable	Descripción
PORT	Puerto HTTP (por defecto 4900).
PG_HOST · PG_PORT · PG_DATABASE · PG_USER · PG_PASSWORD	Conexión PostgreSQL.
JWT_SECRET / AUTH_JWKS_URL	Verificación del JWT de zentto-auth.
CREDENTIAL_ENC_KEY	Clave maestra AES-256-GCM para secretos.
SENIAT_CONSULTA_KEY	Clave de los endpoints /seniat/*.
INTEGRADOR_TOKEN_TTL_SECONDS	Vigencia del JWT corto de integrador.
IMPRENTA_RIF · IMPRENTA_NOMBRE · IMPRENTA_AUTORIZACION_SENIAT	Identidad de la imprenta autorizada.

Secretos

En producción las variables se cargan desde el almacén de secretos (Vault, approle del servicio). Ningún secreto se versiona ni se expone.

Ambientes

Ambiente	environment	Uso
Demo	demo	Pruebas de integración (imprentadev.zentto.net).
Producción	production	Emisión fiscal real (imprenta.zentto.net).