SifenKuDE

Descripción

Genera el KuDE (Kuatia’i De, la representación gráfica del Documento Electrónico) con su código QR de consulta pública. El nodo puede tomar un CDC ya emitido y recuperar el rDE firmado desde la base de datos, o recibir un DE en JSON para previsualizarlo antes de emitirlo. Devuelve un HTML imprimible directamente a PDF, junto con la URL del QR y su imagen en base64.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de SIFEN (aporta el CSC para el QR)
cdc	text	No	CDC de un DE ya emitido, 44 dígitos. Recupera el rDE firmado de la base
de	json	No	DE en JSON para previsualizar, si no se pasa un CDC

Credenciales

Este módulo requiere una credencial de tipo sifen, además de los campos habituales (certificado .p12, RUC y ambiente), aporta el ID CSC y el CSC (Código de Seguridad del Contribuyente) necesarios para construir el hash del código QR.

Salida

{
  "success": true,
  "cdc": "01800123456001001000001234567890123456789012",
  "html": "<html>...</html>",
  "qrUrl": "https://ekuatia.set.gov.py/consultas/qr?nVersion=150&...",
  "qrHash": "a1b2c3d4e5f6...",
  "qrImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
  "digestValue": "aGFzaERlbERvY3VtZW50bw=="
}

Ejemplo de Uso

A partir de un CDC ya emitido

{
  "credentials_id": "cred-sifen-prod",
  "cdc": "01800123456001001000001234567890123456789012"
}

Previsualización antes de emitir

{
  "credentials_id": "cred-sifen-prod",
  "de": {
    "tipoDE": 1,
    "numero": 4,
    "receptor": { "ruc": "80012345-6", "razonSocial": "Empresa Cliente S.A." },
    "items": [{ "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 2500000, "ivaTipo": 10 }]
  }
}

Notas

• Con un CDC recupera el rDE firmado de la base y genera el QR con el cHashQR completo (comprobante oficial)
• Sin CDC, arma el DE en el momento para previsualizar: el documento no está firmado, así que el QR no incluye el DigestValue real
• El QR usa el CSC configurado en la credencial; sin CSC válido, la consulta pública del QR fallará en el sitio de la DNIT
• El HTML devuelto está pensado para imprimirse o convertirse a PDF directamente, sin procesamiento adicional

Nodos Relacionados

• SifenEmitirDE - Emitir el DE cuyo KuDE se genera
• SifenConsultarDE - Consultar el estado del DE antes de generar el KuDE