SAT México — Facturación electrónica (CFDI 4.0)

Descripción

Los nodos SAT conectan tus workflows con la facturación electrónica de México (CFDI 4.0). Floogos arma el comprobante, calcula la cadena original, lo sella con tu CSD y lo timbra con un PAC, obteniendo el UUID (folio fiscal).

Nodo	Qué hace
SAT: Timbrar CFDI 4.0 (satTimbrarCFDI)	Emite y timbra un CFDI (arma, sella, timbra vía PAC)
SAT: Cancelar CFDI (satCancelarCFDI)	Cancela un CFDI timbrado (motivos 01-04)
SAT: Consultar estatus CFDI (satConsultarEstatus)	Estatus del comprobante en el SAT (Vigente/Cancelado)
SAT: Representación / QR (satRepresentacion)	Genera el comprobante imprimible con QR

En México el timbrado es vía PAC — no hay integración directa al SAT

A diferencia de otros países, en México no se puede timbrar directamente contra el SAT. El timbrado es obligatorio a través de un PAC (Proveedor Autorizado de Certificación). Floogos arma y sella el CFDI con tu CSD, y lo envía al PAC (Facturama, Finkok, SW, Solución Factible…) que lo valida, lo timbra (le agrega el UUID y el sello del SAT) y lo registra ante el SAT. El PAC se configura en la credencial.

Credencial

Los nodos usan una credencial de tipo SAT. Creala en Credenciales → Agregar → México SAT / CFDI 4.0 con:

Campo	Descripción
CSD	Tu Certificado de Sello Digital: un .p12 (base64) o el par .cer + .key del SAT.
Contraseña del CSD	La clave que protege la llave del CSD.
RFC y Razón social	Datos del emisor.
Régimen fiscal y Código postal	Clave del régimen (c_RegimenFiscal) y lugar de expedición.
PAC + usuario/contraseña/token	El proveedor de timbrado y sus credenciales.
Ambiente	Sandbox del PAC o producción.

El CSD sella el comprobante; el timbrado lo hace el PAC con tus credenciales del PAC.

El flujo completo

1. Preparás el comprobante como un JSON (tipo, receptor, conceptos). El emisor sale de la credencial.

2. Timbrás con Timbrar CFDI 4.0. Floogos valida los catálogos, calcula la cadena original, sella con el CSD y lo envía al PAC, que devuelve el UUID.

3. Generás la representación impresa con Representación / QR.

4. Si hace falta, cancelás con Cancelar CFDI o consultás el estatus con Consultar estatus.

Timbrar un CFDI

Nodo: SAT: Timbrar CFDI 4.0. El comprobante se toma del campo cfdi (JSON) o de los datos de entrada. Ejemplo de una factura (Ingreso):

{
  "serie": "F", "folio": "123",
  "tipoDeComprobante": "I", "formaPago": "01", "metodoPago": "PUE",
  "receptor": { "rfc": "XEXX010101000", "nombre": "Cliente SA", "codigoPostal": "64000", "regimenFiscal": "601", "usoCFDI": "G03" },
  "conceptos": [
    { "claveProdServ": "50111500", "claveUnidad": "H87", "cantidad": 1, "descripcion": "Producto", "valorUnitario": 1000, "iva": 0.16, "objetoImp": "02" }
  ]
}

Floogos calcula el IVA (16%) y los totales. La salida incluye el uuid, el XML timbrado y el estado.

Tipos de comprobante (tipoDeComprobante)

Tipo	Comprobante	Notas
I	Ingreso (factura)	—
E	Egreso (nota de crédito)	cfdiRelacionados con los UUID del CFDI original
P	Pago (complemento)	Para cobros con método PPD; lleva el complemento de Pagos

Complemento de Pagos (PPD)

Cuando facturás con método de pago PPD (parcialidades o diferido), al cobrar emitís un CFDI de tipo P con el complemento de Pagos, que referencia los comprobantes que se están pagando:

{
  "tipoDeComprobante": "P",
  "receptor": { "rfc": "XEXX010101000", "codigoPostal": "64000", "regimenFiscal": "601" },
  "pago": {
    "fechaPago": "2026-07-29T12:00:00", "formaDePago": "03", "moneda": "MXN",
    "documentos": [ { "uuid": "AAAA1111-2222-3333-4444-555566667777", "numParcialidad": 1, "saldoAnterior": 1160, "pagado": 1160 } ]
  }
}

Cancelar un CFDI

Cancelar CFDI cancela por UUID con un motivo: 01 (errores con relación → requiere el UUID de la factura sustituta), 02 (errores sin relación), 03 (no se llevó a cabo), 04 (nominativa en factura global). Según el caso, el receptor debe aceptar la cancelación.

Consultar estatus

Consultar estatus consulta directamente el servicio del SAT y devuelve si el comprobante está Vigente o Cancelado, si es cancelable y el estatus de cancelación. Los RFCs y el total se completan desde el CFDI guardado.

Representación impresa (QR)

Representación / QR genera el comprobante imprimible en HTML (exportable a PDF), con el UUID, los sellos y el QR de verificación del SAT (que lleva el UUID y los últimos 8 caracteres del sello).

Manejo de errores

Situación	Reintentable	Qué hacer
Rechazo del PAC	No	El nodo devuelve el error del PAC (catálogo inválido, sello, etc.). Corregí el comprobante.
Catálogos inválidos	No	Floogos valida antes de timbrar (RFC, CP, ClaveProdServ, UsoCFDI…) para no gastar un timbrado.
CSD vencido	No	Renová el CSD y actualizá la credencial.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Cadena original y sandbox del PAC

La cadena original sigue las reglas del Anexo 20; un error de formato rompe el sello y el PAC rechaza. Probá siempre en el sandbox del PAC antes de producción, y validá la cadena contra el XSLT oficial del SAT.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.