Documentación de la API de facturación electrónica
Integra el timbrado de CFDI 4.0 a tu ERP o sistema con una API REST simple. Guías, ejemplos en Python, Node.js y PHP, sandbox gratis y referencia de errores.
TimbraMX ofrece una API REST con JSON para timbrar facturas, complementos de pago, nómina y retenciones desde tu ERP, e-commerce o sistema propio. Sin SDK que instalar: son peticiones HTTP que funcionan en cualquier lenguaje.
Ejemplo
POST https://app.timbra-mx.com/api/v1/facturas
X-Api-Key: TU_API_KEY
Content-Type: application/json
{ "xml": "PHNmZGk6Q29tcHJvYmFudGU..." }Cómo timbrar tu primera factura por API
Timbra un CFDI 4.0 con una sola petición HTTP: configuración, solicitud en curl, Node.js y Python, y cómo leer la respuesta. Prueba gratis en sandbox.
Leer →
Timbrar CFDI con Python, Node.js y PHP
Ejemplos listos para copiar para timbrar facturas por API en Node.js, Python, PHP y C#, en modo relay (tu XML) o modo sellar (en JSON).
Leer →
Autenticación y ambientes de la API
Cómo autenticarte con el header X-Api-Key, la diferencia entre sandbox y producción, los límites por minuto y cómo proteger tu API key.
Leer →
Errores y reintentos de la API
Qué significa cada código HTTP de la API de timbrado, cuándo reintentar, cómo usar Idempotency-Key para no timbrar dos veces y qué hacer con cada estado.
Leer →
Complemento de pago y notas de crédito por API
Cómo timbrar un complemento de pago (CFDI tipo P) y una nota de crédito por API: campos que mandas, lo que calcula TimbraMX, errores y ejemplos en curl, Node.js y Python.
Leer →
Endpoints disponibles
| Recurso | Qué puedes hacer |
|---|---|
| Facturas | Validar, timbrar (relay o sellar), listar, consultar, descargar XML y PDF, cancelar, consultar estatus ante el SAT, notas de crédito y saldo de timbres. |
| Complementos de pago | Timbrar CFDI tipo P para una o varias facturas PPD, listar, consultar, descargar XML y PDF y cancelar. |
| Nómina | Armar, sellar y timbrar recibos de nómina 1.2 en un paso, listar, consultar, descargar y cancelar. |
| Retenciones | Timbrar CFDI de retenciones (dividendos, enajenación de acciones y pagos al extranjero), listar, consultar, descargar y cancelar. |
La URL base es https://app.timbra-mx.com/api/v1. La referencia completa de cada ruta está en la documentación técnica completa.
Antes de integrar
- Tu cuenta necesita el módulo de API. Consulta los precios por volumen de la API.
- Empieza en sandbox: timbra de verdad contra el ambiente de pruebas, sin consumir timbres.
- Para producción, tu cuenta se certifica con soporte una vez que la integración funciona.
Preguntas frecuentes
¿TimbraMX tiene API?
Sí. Es una API REST con JSON para timbrar facturas, complementos de pago, nómina y retenciones, con API key por empresa.
¿Necesito instalar un SDK?
No. Son peticiones HTTP, así que funciona con Node.js, Python, PHP, Java, .NET o cualquier lenguaje.
¿Puedo probar sin gastar timbres?
Sí. El ambiente de sandbox timbra contra el ambiente de pruebas, sin valor fiscal y sin consumir tu saldo.
¿Listo para integrar?
Crea tu cuenta gratis, genera tu API key de sandbox y prueba el timbrado de punta a punta sin consumir timbres.
Crear cuenta gratis Ver precios de la APIDocumentación de la API de TimbraMX, versión v1. Actualizada el 27 de octubre de 2026. Todos los ejemplos usan claves de ejemplo: nunca publiques tu API key real.