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.

· Gabriel Paredes· Actualizado

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

  1. 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”.
  2. 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.
  3. 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.
  4. 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”.
  5. Sandbox gratuito y separado. Llaves de prueba, documentos sin validez fiscal y el mismo contrato que producción. Sin esto, cada prueba cuesta dinero.
  6. 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.
  7. 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.
  8. 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.
  9. 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

Relacionado: qué es un PAC y cómo elegir uno, MCP de gigstack vs API REST.