COMPLEMENTOS DE CFDI POR API

Cómo funcionan los complementos

Un complemento es un bloque de datos que se adjunta al CFDI para cubrir requisitos de una operación concreta. El SAT no quiere una factura distinta por cada caso: quiere la misma factura con información adicional cuando aplica.

En la práctica eso significa que la mayoría se emiten por el mismo endpoint, añadiendo el nodo correspondiente:

La excepción son las retenciones, que tienen recurso propio porque no son un CFDI de ingreso sino un tipo de comprobante distinto:

Los complementos disponibles

Los que casi todos necesitan

• Complemento de pago (REP) — obligatorio cuando facturas a crédito y luego te pagan. El más común de todos.
• CFDI de retenciones e información de pagos — cuando retienes ISR o IVA a alguien.

Por tipo de operación

• Carta Porte 3.1 — traslado de mercancía por territorio nacional.
• Comercio exterior — exportaciones definitivas, con fracción arancelaria e Incoterm.
• Leyendas fiscales — textos legales que ciertas disposiciones te obligan a incluir.

Por sector

• IEDU — colegiaturas deducibles, para instituciones educativas.
• Donativos — recibos deducibles de donatarias autorizadas.
• Intereses — constancias anuales de bancos, fintechs y casas de bolsa.
• Plataformas tecnológicas — retenciones a repartidores, conductores y anfitriones.

Otros tipos de comprobante

• Factura global — ventas al público en general.
• Nota de crédito — devoluciones y descuentos posteriores.
• Cuenta de terceros — cobras tú, el ingreso es de otro.
• Impuestos locales — cedular, ISH y retenciones estatales.
• Nómina electrónica — recibos de pago de tu plantilla.

Qué revisar antes de elegir uno

Tres cosas que ahorran tiempo si se miran al principio del proyecto:

• Si el complemento tiene versión propia. Carta Porte va por la 3.1 y retenciones por la 2.0. Integrar contra una versión que está por retirarse significa rehacer el trabajo en meses.
• Si depende de catálogos del SAT. Carta Porte y comercio exterior usan muchos. Resuélvelos por API en vez de mantener copias que se desactualizan sin avisar.
• Si aplica a tu modalidad. El de comercio exterior está limitado a API Web según la documentación. Si tu arquitectura contempla varios RFC emisores, verifícalo antes de diseñar.

Un endpoint, un ciclo de vida

La ventaja de que casi todo pase por el mismo recurso es que las operaciones posteriores son idénticas para todos: consultar por Id, descargar XML y PDF, enviar por correo y cancelar. Aprendes el flujo una vez y lo reutilizas.

Librerías oficiales en PHP, Python, JavaScript, Java, Ruby y .NET (4.5+), con repositorio en GitHub.

¿No necesitas integrar?

Todos estos complementos también se emiten desde la plataforma web, llenando un formulario. Si tu volumen es bajo, esa ruta te evita el desarrollo.

Ver los complementos en la plataforma web