SatTimbrarCFDI

Descripción

Emite y timbra un Comprobante Fiscal Digital por Internet (CFDI) versión 4.0 ante el SAT de México. El nodo arma el comprobante a partir del JSON de entrada, valida los catálogos básicos, calcula la cadena original, lo sella con el CSD (Certificado de Sello Digital) del emisor configurado en la credencial y lo envía a timbrar al PAC (Proveedor Autorizado de Certificación) que también está configurado en la credencial. El comprobante queda fiscalmente válido recién cuando el PAC responde con el UUID (folio fiscal) y el sello digital del SAT.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SAT (CSD + PAC)
cfdi	json	No	Comprobante en JSON: tipoDeComprobante, receptor, conceptos. Si se deja vacío se usan los datos de entrada del nodo anterior. El emisor sale siempre de la credencial

Credenciales

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

• CSD: certificado de sello digital, como archivo .p12 o el par .cer + .key entregado por el SAT
• Contraseña del CSD
• RFC del emisor, razón social, régimen fiscal y código postal
• PAC: proveedor de timbrado (facturama, finkok o sw) y sus credenciales de acceso (usuario/contraseña o token)
• Entorno: test (sandbox del PAC) o production (timbrado real)

Salida

{
  "success": true,
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "estado": "stamped",
  "serie": "FA",
  "folio": "1001",
  "total": 1160.00,
  "totals": { "subTotal": 1000.00, "descuento": 0, "totalTraslados": 160.00, "total": 1160.00 },
  "fechaTimbrado": "2026-08-05T12:34:56",
  "xml": "cfdi:Comprobante timbrado en XML (string)",
  "pac": "facturama"
}

Ejemplo de Uso

{
  "credentials_id": "cred-sat-prod",
  "cfdi": {
    "tipoDeComprobante": "I",
    "serie": "FA",
    "folio": "1001",
    "moneda": "MXN",
    "formaPago": "03",
    "metodoPago": "PUE",
    "lugarExpedicion": "06600",
    "receptor": {
      "rfc": "XAXX010101000",
      "nombre": "PUBLICO EN GENERAL",
      "codigoPostal": "06600",
      "regimenFiscal": "616",
      "usoCFDI": "S01"
    },
    "conceptos": [
      {
        "claveProdServ": "81112100",
        "descripcion": "Servicio de consultoría",
        "cantidad": 1,
        "claveUnidad": "E48",
        "valorUnitario": 1000.00,
        "iva": 0.16,
        "objetoImp": "02"
      }
    ]
  }
}

Notas

• El timbrado en México NO es directo al SAT: siempre pasa por un PAC (Facturama, Finkok o SW) configurado en la credencial.
• El emisor (RFC, razón social, régimen fiscal, código postal) sale siempre de la credencial, nunca del JSON de entrada.
• El CFDI se valida contra catálogos SAT básicos y se persiste sellado ANTES de timbrar, para tener trazabilidad si el PAC rechaza el comprobante.
• Si el CSD está vencido, el nodo devuelve error sin intentar el timbrado.

Nodos Relacionados

• SatConsultarEstatus - Consultar si un CFDI está vigente o cancelado
• SatCancelarCFDI - Cancelar un CFDI timbrado
• SatRepresentación - Generar representación impresa con QR