HaciendaRepresentación

Descripción

Genera la representación impresa de un comprobante electrónico de Hacienda con su código QR, calculado a partir de la clave numérica de 50 dígitos. Puede tomar un comprobante ya emitido (pasando su clave, recupera los datos guardados en la base) o recibir un comprobante en JSON para previsualizar la representación antes de emitirlo. Devuelve un HTML autocontenido, listo para imprimir o exportar a PDF.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de Hacienda
clave	text	No	Clave numérica (50 dígitos) del comprobante emitido (recupera datos de la base)
comprobante	json	No	Comprobante en JSON para previsualizar (si no se pasa clave)

Credenciales

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

• Certificado (.p12): certificado digital del emisor
• Contraseña del certificado
• Cédula/identificación del emisor (9 a 12 dígitos)
• Usuario y contraseña del ATV (IDP de Hacienda)
• Ambiente: sandbox (pruebas) o producción

Salida

{
  "clave": "50601012600310123456700100001010000000001100000001",
  "html": "...",
  "qrImage": "data:image/png;base64,..."
}

Ejemplo de Uso

{
  "credentials_id": "cred-hacienda-prod",
  "clave": "50601012600310123456700100001010000000001100000001"
}

Notas

• Si se pasa clave, el nodo recupera el comprobante ya emitido de la base (tipo, consecutivo, receptor, totales) y arma el QR con su estado real.
• Si todavía no hay un comprobante emitido, se puede pasar un comprobante en JSON con sus ítems para previsualizar la representación antes de enviarlo a Hacienda.
• El HTML es autocontenido (estilos incluidos) y está pensado para imprimirse o exportarse a PDF directamente.
• Si la clave no se encuentra en la base, el nodo termina en error en lugar de generar una representación con datos vacíos.

Nodos Relacionados

• HaciendaEmitirFactura - Emitir la factura
• HaciendaEmitirNota - Emitir nota de crédito o débito
• HaciendaConsultarEstado - Consultar el estado del comprobante