Configuration

Initial setup (backoffice)

A client is onboarded by the print operator from the backoffice (see Backoffice manual):

1. Generate a control-number series for the client company (POST /v1/imprenta/backoffice/series, ZENTTO_SUPERADMIN only): document type, series, prefix and range [Desde, Hasta].
2. Define the client’s tariff (price per control number and/or per block, free numbers included).
3. If applicable, register the integrator and issue its API token (tokenUsuario + secret, the latter shown only once).

Operation from the ERP / POS

When the merchant invoices from the Zentto ERP or POS, issuance to the digital printer happens automatically, with no extra manual steps: the sale is not blocked and compliance transmission is retried in the background.

Microservice environment variables

Variable	Description
PORT	HTTP port (default 4900).
PG_HOST · PG_PORT · PG_DATABASE · PG_USER · PG_PASSWORD	PostgreSQL connection.
JWT_SECRET / AUTH_JWKS_URL	zentto-auth JWT verification.
CREDENTIAL_ENC_KEY	AES-256-GCM master key for secrets.
SENIAT_CONSULTA_KEY	Key for the /seniat/* endpoints.
INTEGRADOR_TOKEN_TTL_SECONDS	Integrator short-JWT lifetime.
IMPRENTA_RIF · IMPRENTA_NOMBRE · IMPRENTA_AUTORIZACION_SENIAT	Authorized printer identity.

Secrets

In production, variables are loaded from the secrets store (Vault, service approle). No secret is versioned or exposed.

Environments

Environment	environment	Use
Demo	demo	Integration testing (imprentadev.zentto.net).
Production	production	Real fiscal issuance (imprenta.zentto.net).