CFDI 4.0: guía técnica completa para desarrolladores

Desde enero de 2023, el CFDI 4.0 es la única versión que el SAT acepta para timbrar comprobantes fiscales en México. Si llevas tiempo integrando sistemas de facturación, recordarás el caos que fue la migración desde la versión 3.3. Campos nuevos, validaciones más estrictas, y un receptor que de pronto necesitaba datos que nadie recopilaba. Han pasado tres años y todavía me encuentro con integraciones que arrastran parches de la migración como si fueran deuda técnica heredada.

Si estás construyendo algo que toca facturación electrónica en México, necesitas entender el CFDI 4.0 a nivel de campos, validaciones y flujos. No a nivel de "qué botón presiono en el portal del SAT", sino a nivel de "qué campos manda mi API al PAC y por qué me lo rechaza". Eso es lo que cubre esta guía.

Qué es CFDI 4.0

CFDI significa Comprobante Fiscal Digital por Internet. Es un documento electrónico en formato XML que registra transacciones económicas con validez fiscal en México. Cada CFDI lleva una firma digital del emisor y un sello digital (timbre fiscal) que genera un Proveedor Autorizado de Certificación (PAC).

El CFDI 4.0 es la cuarta versión mayor de este estándar, publicada por el SAT en 2022 y obligatoria desde el 1 de enero de 2023. Reemplazó por completo a la versión 3.3 que llevaba vigente desde 2017. Si quieres entender los fundamentos del CFDI desde cero, tengo una guía que los cubre: qué es CFDI y cómo funciona.

La diferencia fundamental entre CFDI 4.0 y su predecesor no es un cambio cosmético de versión. El SAT decidió que quería saber más sobre el receptor de cada comprobante, endureció las validaciones de datos fiscales, y cambió las reglas de cancelación para que no pudieras borrar facturas sin que la otra parte se enterara. En la práctica, esto significó que el XML pasó de ser un formato relativamente flexible a uno donde un punto, una coma o un espacio de más hace que el PAC te rechace el timbrado.

Cambios principales de CFDI 3.3 a 4.0

Antes de entrar a la estructura campo por campo, vale la pena ver el panorama general de qué cambió. Si migraste desde 3.3, esta tabla te va a resultar familiar. Si estás empezando directo con 4.0, te sirve para entender por qué ciertos campos existen y son tan estrictos.

Lo que más dolió en producción fue el nombre del receptor. Parece trivial, pero "EMPRESA SA DE CV" no es lo mismo que "EMPRESA, S.A. DE C.V." para el timbrado. Miles de integraciones se rompieron por algo que a nivel de código es un string comparison.

Estructura del CFDI 4.0

Un CFDI 4.0 es un archivo XML con una estructura jerárquica definida por el SAT. Tiene docenas de campos, pero estos son los nodos principales y sus campos más relevantes.

Tipos de CFDI 4.0

El campo TipoDeComprobante define la naturaleza del CFDI. Cada tipo tiene reglas propias sobre qué campos son obligatorios y cuáles no aplican.

Campos obligatorios a detalle: emisor, receptor y conceptos

Estos tres nodos concentran el 80% de los errores de timbrado que he visto en producción. No por ser difíciles, sino porque requieren datos que no siempre están disponibles en el momento de facturar.

Ciclo de vida del CFDI 4.0

Un CFDI no es solo crearlo y olvidarlo. Tiene un ciclo de vida que va desde su creación hasta su cancelación, y cada etapa tiene reglas y tiempos específicos.

El cambio más significativo en el ciclo de vida con CFDI 4.0 fue la cancelación. Ya no puedes cancelar unilateralmente después de 24 horas. El receptor tiene que aprobar la cancelación, y si no responde en 72 horas, se aprueba automáticamente. Las excepciones son CFDIs con monto menor a $1,000 MXN, CFDIs de nómina, CFDIs de Egreso, y CFDIs de Traslado.

Además, al cancelar necesitas indicar un motivo:

• 01 Comprobante emitido con errores con relación (debes indicar el UUID del CFDI que lo sustituye)
• 02 Comprobante emitido con errores sin relación
• 03 No se llevó a cabo la operación
• 04 Operación nominativa relacionada en una factura global

Complementos disponibles para CFDI 4.0

Los complementos son nodos XML adicionales que se insertan dentro del CFDI para casos específicos. Cada complemento tiene su propio esquema XSD y versión.

Cómo generar un CFDI 4.0 con la API de Fiscalapi

Construir el XML de un CFDI 4.0 a mano es una receta para el sufrimiento. Son docenas de campos con validaciones cruzadas, catálogos con miles de claves, y un esquema XSD que no perdona un atributo fuera de orden. La forma práctica es usar una API que se encargue de armar el XML, validarlo, enviarlo al PAC, y devolverte el CFDI timbrado listo para entregar.

Con Fiscalapi, la emisión de un CFDI 4.0 se reduce a una llamada a la API con los datos de la transacción. El SDK se encarga del resto.

var fiscalapi = FiscalApiClient.Create(settings => {
    settings.ApiUrl = "https://test.fiscalapi.com";
    settings.ApiKey = "TU_API_KEY";
    settings.Tenant = "TU_TENANT";
});

var invoice = await fiscalapi.Invoices.CreateAsync(new Invoice {
    VersionCode = "4.0",
    Series = "F",
    TypeCode = "I",
    PaymentFormCode = "03",
    PaymentMethodCode = "PUE",
    CurrencyCode = "MXN",
    ExportCode = "01",
    ExpeditionZipCode = "42501",
    Issuer = new InvoiceIssuer { Id = "ID_DEL_EMISOR" },
    Recipient = new InvoiceRecipient {
        Id = "ID_DEL_RECEPTOR",
        CfdiUseCode = "G03"
    },
    Items = new List<InvoiceItem> {
        new InvoiceItem {
            Id = "ID_DEL_PRODUCTO",
            Quantity = 1,
            Taxes = new List<InvoiceItemTax> {
                new InvoiceItemTax {
                    TaxCode = "002",
                    TaxRate = 0.16m,
                    TaxTypeCode = "Tasa",
                    IsFederalTax = true
                }
            }
        }
    }
});

// invoice.Data.Id contiene el UUID del CFDI timbrado
Console.WriteLine($"UUID: {invoice.Data.Id}");

Fiscalapi se encarga del timbrado, la generación del PDF, y el almacenamiento del XML. En el ambiente de pruebas (test.fiscalapi.com) puedes timbrar sin costo y sin consecuencias fiscales. El sandbox simula las validaciones del SAT completas, incluyendo RFC, régimen fiscal, y nombre del receptor. La documentación completa de la API cubre todos los endpoints.

Lo que distingue a este enfoque es que no necesitas conocer la estructura interna del XML. Fiscalapi mapea los campos de la API a los nodos del CFDI 4.0, calcula impuestos, valida catálogos, y maneja los complementos automáticamente. Tú te preocupas por la lógica de negocio; la API se preocupa por el SAT.

Migración de CFDI 3.3 a 4.0

Si por alguna razón todavía tienes código que referencia la versión 3.3 (integraciones legadas, scripts de generación de XML, templates), esto es lo que necesitas corregir.

Preguntas frecuentes sobre CFDI 4.0