Representación impresa

El endpoint

GET /api/v1/ecf/{id}/representation
GET /api/v1/ecf/{id}/representation?layout=pos
GET /api/v1/ecf/{id}/representation?download=true

Parámetro	Nota
`layout`	`letter` (por defecto) o `pos`.
`download`	`true` para forzar la descarga; sin él, el PDF se abre inline en el navegador.

El archivo se llama {e-NCF}.pdf ({e-NCF}-pos.pdf para el formato POS). Disponible para los tres roles de API key, no solo admin_tenant: si tu integración solo consulta comprobantes, también puede descargar su representación impresa.

Los dos formatos

Carta (por defecto): pensado para imprimir en una impresora normal. Si el comprobante tiene muchas líneas, se pagina automáticamente.
POS de 80 mm: pensado para una impresora térmica de punto de venta. Es una sola página continua, sin paginación, con los montos alineados para ese ancho.

Ambos muestran los mismos datos: identidad fiscal, comprador, líneas, totales, y el timbre de la DGII (código de seguridad y QR).

De dónde sale

La representación impresa se arma siempre a partir del mismo <ECF> firmado que NovaFE ya guardó al emitir, nunca de un modelo aparte. Esto importa para un caso puntual: si tu comprobante tipo 32 se envió a la DGII como RFCE (por estar debajo de RD$250,000), la representación impresa muestra de todas formas el comprobante completo, no el resumen que se transmitió.

El QR

El QR no es el código de seguridad: es una URL de verificación de la DGII (consultatimbre, o consultatimbrefc si el comprobante se envió como RFCE). Cualquiera que lo escanee ve, directamente en un servidor de la DGII, si ese comprobante es válido, y no depende de NovaFE para confirmarlo.

Elige tu formato por defecto

Si no mandas ?layout en el request, NovaFE usa el formato por defecto de tu tenant. Puedes cambiarlo tú mismo desde la configuración del tenant en el panel, con el ajuste representation.default_layout.

Acepta "letter" o "pos". Por defecto es "letter".

Leyenda de contingencia

Si un comprobante se firmó mientras NovaFE estaba en modo de contingencia, ambos formatos imprimen la leyenda que exige la DGII:

e-CF emitido en modalidad de Contingencia, el cual podrá ser consultado para su validez fiscal, a partir de las setenta y dos (72) horas.