API de facturación CFDI 4.0: qué debe tener y cómo elegirla
Checklist técnico para elegir una API de facturación CFDI 4.0 en México: cobertura de comprobantes, validaciones, cancelación, webhooks, sandbox, idempotencia y costos.
Una API de facturación CFDI 4.0 recibe los datos de una venta, arma el XML conforme al Anexo 20, lo sella con el CSD del emisor y lo manda a timbrar a un PAC autorizado por el SAT. Para elegir una, revisa siete cosas: qué comprobantes y complementos cubre, qué valida antes de timbrar, cómo cancela, si tiene sandbox gratuito, webhooks e idempotencia, cómo entrega y guarda XML y PDF, y cuánto cuesta por documento con tu volumen real.
Última actualización: noviembre 2026. Este artículo es neutral: sirve para comparar cualquier proveedor. Al final explicamos dónde encaja la API de gigstack.
Qué hace una API de facturación (y qué no)
| Pieza | Quién la hace |
|---|---|
| Datos de la venta (cliente, conceptos, impuestos) | Tu sistema |
| Armar el XML conforme al Anexo 20 | La API |
| Sellar con el CSD del emisor | La API, con el CSD que el emisor carga |
| Validar, asignar folio e incorporar el sello del SAT (timbrar) | Un PAC autorizado (regla 2.7.2.5 RMF 2026) |
| Entregar XML y PDF al cliente | La API o tu sistema (regla 2.7.1.33 permite correo o portal de descarga) |
| Conservar la contabilidad | El emisor, cinco años (artículo 30 del CFF) |
Algunas APIs son el propio PAC; otras son una capa encima de uno o varios PAC. Las dos son válidas: lo que importa es que el PAC esté en la lista de proveedores autorizados del SAT.
Checklist para elegir una API de facturación
- Cobertura de comprobantes. Ingreso (PUE y PPD), egreso (notas de crédito), complemento de pago 2.0, factura global con el nodo
InformacionGlobal, y los complementos de tu industria (Carta Porte, comercio exterior, nómina, retenciones). Pide la lista exacta, no “soportamos CFDI 4.0”. - Validación antes de timbrar. El CFDI 4.0 exige RFC, nombre, código postal y uso del CFDI del receptor (artículo 29-A, fracción IV del CFF) y su régimen fiscal. Una buena API valida esos datos contra el SAT y te devuelve errores legibles antes de gastar un timbre.
- Catálogos SAT. Búsqueda y validación de claves de producto, unidad, régimen y uso del CFDI, actualizadas cuando el SAT cambia catálogos.
- Cancelación completa. Motivo de cancelación, folio sustituto y el flujo de aceptación del receptor: la regla 2.7.1.34 le da tres días para responder. La API debe reportar el estado, no sólo “solicitud enviada”.
- Sandbox gratuito y separado. Llaves de prueba, documentos sin validez fiscal y el mismo contrato que producción. Sin esto, cada prueba cuesta dinero.
- Webhooks e idempotencia. Eventos firmados de timbrado, cancelación y pago; y una llave de idempotencia para reintentar sin duplicar facturas cuando se cae la red.
- Automatización del ciclo completo. Si cobras por Stripe, Mercado Pago u otro procesador, conviene que la API pueda facturar el cobro y emitir el complemento de pago solo, sin que tú programes cada caso.
- Precio predecible. Costo por documento por volumen, si los complementos y cancelaciones cuentan, cuotas fijas y si el acceso a la API tiene costo adicional.
- Documentación para humanos y para agentes. OpenAPI publicado, SDK o CLI, y cada vez más, un servidor MCP para que asistentes de IA operen la cuenta.
Preguntas para hacerle a cualquier proveedor
| Pregunta | Por qué importa |
|---|---|
| Quién es el PAC y qué pasa si lo revocan? | La regla 2.7.2.12 da 90 días de transición, de los cuales sólo 30 con timbrado |
| Puedo descargar todos mis XML en cualquier momento? | Tu contabilidad no puede depender de un proveedor |
| Cómo manejan errores del SAT o del PAC? | Reintentos, mensajes claros y sin duplicados |
| Qué límite de peticiones tiene la API? | Cierres de mes y facturas globales generan picos |
| Hay costo por usar la API o los webhooks? | Algunos lo cobran aparte |
Dónde encaja gigstack
gigstack es una de las opciones. Su API REST v2 está incluida sin costo: un POST /v2/invoices con tu llave y el CFDI sale timbrado, con el RFC del receptor y la lista de EFOS validados. Tiene webhooks firmados, un CLI en npm y un servidor MCP para que ChatGPT, Claude o Cursor facturen en nombre del negocio. Cubre facturas PUE y PPD, complementos de pago, notas de crédito y factura global, y se conecta con procesadores como Stripe, Mercado Pago, PayPal, Shopify, Clip y Conekta para facturar cada cobro en automático.
Un agente puede abrirte una cuenta de prueba por API (POST /v2/auth/sandbox) y emitir una factura de prueba sin tarjeta. En producción cuesta desde $199 MXN + IVA al mes por RFC, más uso; API, webhooks y MCP incluidos. Documentación en docs.gigstack.io y detalle en gigstack.pro/api-facturacion.
Preguntas frecuentes
Qué es una API de facturación electrónica?
Un servicio que recibe los datos de una venta por HTTP, genera el CFDI conforme al Anexo 20, lo sella con el CSD del emisor y lo timbra con un PAC autorizado por el SAT, para que tu sistema facture sin captura manual.
Una API de facturación es lo mismo que un PAC?
No siempre. El PAC es quien certifica el CFDI ante el SAT. Algunas APIs son el propio PAC y otras son una plataforma que timbra a través de uno o varios PAC autorizados.
Qué datos del receptor exige el CFDI 4.0?
RFC, nombre o razón social, código postal del domicilio fiscal y uso del CFDI, según el artículo 29-A, fracción IV del CFF, además del régimen fiscal del receptor que pide el Anexo 20.
Cuánto tiempo debo guardar los XML?
Forman parte de tu contabilidad, que el artículo 30 del CFF pide conservar durante cinco años.
Puedo probar una API de facturación sin pagar?
Depende del proveedor. Busca un modo de prueba gratuito con llaves separadas; los documentos de prueba no tienen validez fiscal.
Fuentes
- Resolución Miscelánea Fiscal 2026: reglas 2.7.1.33, 2.7.1.34, 2.7.2.5 y 2.7.2.12.
- Código Fiscal de la Federación: artículos 29, 29-A y 30.
- Anexo 20 del CFDI 4.0, SAT.
Relacionado: qué es un PAC y cómo elegir uno, MCP de gigstack vs API REST.