Documentación de la API v5
Con la API v5 tu sistema timbra, consulta, envía y cancela CFDI 4.0 con una sola llave. Cada página trae la petición, la respuesta y los errores que puede devolver, revisados contra el código que corre en producción.
URL base
Todas las rutas de esta documentación se escriben a partir de una de estas dos URL. El sandbox es gratis y timbra con un proveedor de pruebas: los CFDI que salen de ahí no tienen validez fiscal.
| Ambiente | URL base |
|---|---|
| Producción | https://app.facturadigital.com.mx/api/v5 |
| Sandbox | https://sandbox-app.facturadigital.com.mx/api/v5 |
Empieza
- Inicio rápidoTu primer CFDI en el sandbox con curl: la llave, la petición y la respuesta.
- Llave y ambientesCómo se manda la X-Api-Key, las URL de producción y sandbox, y por qué cada ambiente tiene su llave.
- Respuestas y erroresCómo leer code y message, qué errores se reintentan y cuáles se corrigen antes.
- Todos los endpointsTodos los endpoints de la API v5 en una tabla.
Timbrar
- Crear un CFDITimbra una factura, nota de crédito, REP o nómina enviando el comprobante en JSON.
- Timbrar XML selladoSi tu sistema ya arma y sella el XML, mándalo en Base64 o como archivo y solo lo timbramos.
- RetencionesConstancias de retenciones e información de pagos 2.0, y su cancelación.
- Complemento de pagoGuía del recibo electrónico de pago (Pagos 2.0) con parcialidades y varias facturas.
- Carta Porte 3.1Guía de CFDI de ingreso y traslado con el complemento Carta Porte 3.1.
Después de timbrar
Autofactura y catálogos
Errores
Herramientas
- Validador de JSONPega tu JSON y revisa antes de timbrar si cumple lo que pide el SAT.
- Ejemplos por lenguajeTimbrar un CFDI en curl, PHP, Node.js, Python, C# y Java.
- Colección de PostmanImporta la colección oficial con cada endpoint listo para probar.
- SandboxEl ambiente de pruebas gratuito, con la misma API que producción.
Revisado contra la API v5 en producción el 2026-11-03.