SatRepresentación

Descripción

Genera la representación impresa de un CFDI 4.0 con el UUID, los sellos y el código QR de verificación del SAT, lista para convertir a PDF y entregar al cliente. Si se indica un uuid, el nodo recupera el CFDI ya timbrado (con sus sellos reales) desde la base; si no, arma una previsualización a partir de un CFDI en JSON, útil para revisar el formato antes de timbrar.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SAT
uuid	text	No	UUID del CFDI timbrado a representar (se recupera de la base)
cfdi	json	No	CFDI en JSON para previsualizar (si no se indica un uuid)

Credenciales

Este módulo requiere una credencial de tipo sat con:

• RFC del emisor, razón social, régimen fiscal y código postal (se usan para completar los datos del emisor en la representación)
• CSD (obligatorio en la credencial, aunque no se usa para generar la representación)
• Entorno: test o production

Salida

{
  "success": true,
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "html": "HTML imprimible con los datos del CFDI y el QR embebido",
  "qrUrl": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?...",
  "qrImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}

Ejemplo de Uso

Representación de un CFDI ya timbrado

{
  "credentials_id": "cred-sat-prod",
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB"
}

Previsualización antes de timbrar

{
  "credentials_id": "cred-sat-prod",
  "cfdi": {
    "tipoDeComprobante": "I",
    "serie": "FA",
    "folio": "1001",
    "receptor": { "rfc": "XAXX010101000", "nombre": "PUBLICO EN GENERAL" },
    "conceptos": [
      { "claveProdServ": "81112100", "descripcion": "Servicio de consultoría", "cantidad": 1, "claveUnidad": "E48", "valorUnitario": 1000.00 }
    ]
  }
}

Notas

• Con uuid, la representación incluye los sellos reales del SAT (Timbre Fiscal Digital); sin uuid, la previsualización no tiene validez fiscal.
• El HTML devuelto está pensado para convertirse a PDF con un nodo de conversión HTML a PDF antes de enviarlo por correo.
• El QR sigue el formato oficial de verificación del SAT, con el UUID, los RFCs del emisor y receptor, y el total.

Nodos Relacionados

• SatTimbrarCFDI - Timbrar un CFDI
• SatConsultarEstatus - Consultar si un CFDI está vigente o cancelado