DgiiRepresentación

Descripción

Genera la Representación Impresa del Comprobante Fiscal Electrónico (RFCE) de un e-CF emitido ante la DGII de República Dominicana, incluyendo el código QR de consulta de timbre. El nodo recupera el e-CF ya emitido desde la base de datos, buscándolo por su e-NCF o por su TrackId, y arma el HTML listo para imprimir o convertir a PDF.

Este nodo no vuelve a emitir ni a firmar nada: solo genera la representación visual de un comprobante que ya fue recibido por la DGII con DgiiEmitirFactura o DgiiEmitirNota.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgii
encf	text	No	e-NCF del e-CF a representar (o usar track_id)
track_id	text	No	TrackId del e-CF a representar (alternativa al e-NCF)

Hay que indicar al menos uno de los dos campos, encf o track_id, para localizar el comprobante.

Credenciales

Este módulo requiere una credencial de tipo dgii con los siguientes campos:

• Certificado digital (.p12): certificado de firma en base64 (alternativamente, clave privada + certificado en PEM)
• Contraseña del certificado: contraseña del .p12
• RNC del emisor: RNC de la empresa emisora (9 a 11 dígitos)
• Ambiente: test, cert (certificación) o prod (producción)

Salida

{
  "encf": "E310000000123",
  "html": "<html>...representación imprimible...</html>",
  "qrUrl": "https://ecf.dgii.gov.do/ecf/consultatimbre?...",
  "qrImage": "data:image/png;base64,iVBORw0KGgo...",
  "codigoSeguridad": "Ab3xZ9"
}

Ejemplo de Uso

{
  "credentials_id": "cred-dgii-prod",
  "encf": "E310000000123"
}

Notas

• Si no se encuentra el e-CF en la base con el e-NCF o TrackId indicado, el nodo devuelve error en lugar de generar una representación vacía.
• El QR apunta a la página de consulta de timbre de la DGII, armado con emisor, comprador, monto total, fechas y código de seguridad del comprobante.
• El campo html está listo para renderizarse directamente o convertirse a PDF en un paso posterior del workflow.
• Los ítems que se muestran en el detalle vienen del data/config.items de entrada del nodo, no se recuperan automáticamente de la base.

Nodos Relacionados

• DgiiEmitirFactura - Emitir el e-CF que luego se va a representar
• DgiiEmitirNota - Emitir la nota que luego se va a representar
• DgiiConsultarEstado - Confirmar que el e-CF quedó aceptado antes de entregarlo