Documentación de la API · v1

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

RecursoQué puedes hacer
FacturasValidar, 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 pagoTimbrar CFDI tipo P para una o varias facturas PPD, listar, consultar, descargar XML y PDF y cancelar.
NóminaArmar, sellar y timbrar recibos de nómina 1.2 en un paso, listar, consultar, descargar y cancelar.
RetencionesTimbrar 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

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 API

Documentació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.