DgiRepresentación

Descripción

Genera la representación impresa de un Comprobante Fiscal Electrónico (CFE) de Uruguay, con su código de seguridad y el código QR de consulta que exige la DGI. Puede tomar un CFE ya emitido (identificado por tipo, serie y número, recuperando el XML firmado guardado en la base) o armar una previsualización a partir de un CFE en formato JSON que todavía no fue emitido.

Devuelve HTML listo para imprimir o convertir a PDF, junto con la imagen del QR y el contenido que codifica.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgi
tipo_cfe	text	No	Tipo del CFE ya emitido (para recuperarlo de la base)
serie	text	No	Serie del CFE ya emitido
número	text	No	Número del CFE ya emitido
cfe	json	No	CFE en JSON para previsualizar (si no se pasan tipo/serie/número)

Hay que completar tipo_cfe + serie + numero para representar un comprobante ya emitido, o cfe con ítems para previsualizar uno que todavía no se emitió.

Credenciales

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

• Certificado (.p12): certificado de firma avanzada en base64
• Contraseña del certificado: contraseña del .p12
• RUT: RUT del emisor
• Razón Social: razón social del emisor
• Entorno: test (homologación) o prod (producción)

Salida

{
  "tipoCfe": 111,
  "serie": "A",
  "numero": 159,
  "html": "<html>...representación imprimible...</html>",
  "qrUrl": "https://efactura.dgi.gub.uy/...",
  "qrImage": "data:image/png;base64,...",
  "codigoSeguridad": "AB12CD34",
  "digestValue": "sha1-abc123..."
}

Ejemplo de Uso

Representación de un CFE ya emitido

{
  "credentials_id": "cred-dgi-prod",
  "tipo_cfe": "111",
  "serie": "A",
  "numero": "159"
}

Previsualización de un CFE sin emitir

{
  "credentials_id": "cred-dgi-prod",
  "cfe": {
    "tipoCfe": 111,
    "receptor": { "tipoDocumento": 2, "documento": "212345670010" },
    "items": [
      { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 1000, "indicadorIva": "22" }
    ]
  }
}

Notas

• Cuando se representa un CFE ya emitido, el HTML incluye el código de seguridad real guardado al emitir; en la previsualización el código puede ser provisorio.
• El campo html está pensado para renderizarse directamente o pasarse a un nodo que lo convierta a PDF.
• El qrImage viene como data URL, listo para embeber en el HTML o enviarlo por email sin necesidad de subir un archivo aparte.
• Si no se encuentra el CFE por tipo/serie/número, el nodo devuelve error; para previsualizar hace falta pasar cfe con al menos un ítem.

Nodos Relacionados

• DgiEmitirCFE - Emitir el CFE antes de representarlo
• DgiConsultarCFE - Verificar el estado del CFE representado