SunatRepresentación

Descripción

Genera la representación impresa de un Comprobante de Pago Electrónico (CPE) con su código QR. Puede tomar un CPE ya emitido (indicando tipo, serie y número) y recuperar su hash real de la base, o recibir un CPE en JSON para previsualizar la representación antes de emitirlo. Devuelve un HTML autocontenido, imprimible a PDF, junto con el contenido del QR.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SUNAT (para tomar el RUC y los datos del emisor)
tipo	text	No	Tipo de comprobante (01 factura, 03 boleta). Por defecto 01
serie	text	No	Serie del CPE ya emitido, para recuperarlo de la base
número	text	No	Número del CPE ya emitido
cpe	json	No	CPE en JSON para previsualizar, si no se pasan serie y número

Credenciales

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

• Certificado (.p12): certificado digital del emisor
• Contraseña del certificado
• RUC del emisor (11 dígitos)
• Usuario SOL y Clave SOL: credenciales de Clave SOL de SUNAT
• Modo: directo (a SUNAT) u OSE (Operador de Servicios Electrónicos)
• URL del OSE, si el modo es OSE
• Entorno: beta (pruebas) o production (producción)

Salida

{
  "tipo": "01",
  "serie": "F001",
  "numero": 125,
  "html": "...",
  "qrText": "20123456789|01|F001|125|18.00|118.00|2026-08-04|6|20123456789|AbCdEf123...",
  "qrImage": "data:image/png;base64,...",
  "hash": "AbCdEf123..."
}

Ejemplo de Uso

{
  "credentials_id": "cred-sunat-prod",
  "tipo": "01",
  "serie": "F001",
  "numero": "125"
}

El QR de SUNAT

El QR contiene una cadena separada por barras verticales con: RUC del emisor, tipo de comprobante, serie, número, IGV, total, fecha de emisión, tipo de documento del receptor, número de documento del receptor y el hash del comprobante (DigestValue de la firma).

Notas

• Si se pasan serie y número, el nodo recupera el CPE ya emitido y firmado de la base, con su hash real.
• Si todavía no hay un comprobante emitido, se puede pasar un cpe en JSON para previsualizar la representación; en ese caso el nodo firma el XML solo para calcular el hash del QR, sin enviarlo a SUNAT.
• El HTML es autocontenido (estilos incluidos) y está pensado para imprimirse o exportarse a PDF directamente.

Nodos Relacionados

• SunatEmitirCPE - Emitir factura o boleta
• SunatEmitirNota - Emitir nota de crédito o débito