Timbrix API · CFDI 4.0 · MCP Server nativo

Timbra facturas con una llamada

REST API documentada, SDK oficial en TypeScript y sandbox sin costo. Con servidor MCP nativo — integra timbrado directo en Claude, Cursor o el agente de IA que ya usa tu equipo.

crear-cfdi.sh
curl -X POST https://api.timbrix.mx/invoices \
-H "X-API-Key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"series": "A",
"folioNumber": "1043",
"date": "2026-09-11T10:32:00",
"paymentForm": "01",
"use": "G03",
"customer": {
"legalName": "Comercializadora del Valle SA de CV",
"taxId": "CVA170203XXX",
"taxSystem": "601"
},
"items": [
{ "quantity": 1, "amount": 12500, "productKey": "81112101", "unitKey": "E48", "description": "Servicios de consultoría", "unitPrice": 12500 }
]
}'

Construye con el stack completo

SDK, CLI, MCP y sandbox listos desde el día uno

MCP Server nativo

Conecta Claude, Cursor o cualquier cliente MCP a Timbrix y deja que timbre facturas directamente con el paquete oficial @timbrix/mcp.

SDK TypeScript

@timbrix/sdk con tipos completos para cada endpoint.

CLI

@timbrix/cli para automatizar organizaciones, webhooks y API keys desde scripts o CI/CD.

Webhooks

Eventos de timbrado, cancelación y error entregados en tiempo real.

Sandbox sin costo

Mismos endpoints y respuestas que producción, sin validez fiscal. Hasta 300 CFDI de prueba por día.

Diseñada API-first, para integrarse a tu sistema

Timbrix expone toda la operación de facturación como una API REST documentada sobre https://api.timbrix.mx. Emite CFDI 4.0 de Ingreso, Egreso y Traslado, cancela comprobantes ante el SAT, gestiona clientes y catálogo de productos, y descarga XML/PDF — todo con respuestas JSON predecibles y códigos de error claros. No necesitas la interfaz web para nada: cada flujo que existe en el dashboard existe también como endpoint.

Autenticación: API key u OAuth 2.0

API key

X-API-Key: sk_test_... — recomendado para integraciones servidor-a-servidor. Se crea desde la configuración de tu organización.

OAuth 2.0

Client Credentials para acceso máquina-a-máquina, o Authorization Code cuando tu aplicación actúa en nombre de un usuario de Timbrix.

Endpoints principales

POST/invoices
Emisión de CFDI (Ingreso, Egreso, Traslado)
POST/invoices/{uuid}/cancel
Cancelación ante el SAT, con los 4 motivos que exige CFDI 4.0
GET/invoices/{uuid}/xml /pdf
Descarga de XML y PDF de cada comprobante timbrado
GET/customers
Clientes y catálogo de productos con claves oficiales del SAT
POST/organizations/{organizationId}/webhooks
Suscripción a eventos de timbrado, cancelación y error, en tiempo real

Ejemplo: timbrar un CFDI de Ingreso

POST /organizations/{organizationId}/invoices
const invoice = await timbrix.invoices.create({
series: "A",
folioNumber: "1",
date: "2026-08-23T10:00:00",
paymentForm: "01",
paymentMethod: "PUE",
use: "G03",
customerId: "590ce6c56d04f840aa8438af",
items: [{ quantity: 1, amount: 12500, productId: "60f1c3e-prod-8421"}],
})
console.log(invoice.uuid) // folio fiscal, listo para el SAT
@timbrix/sdk

SDK TypeScript/JavaScript con tipado completo para organizaciones, clientes, productos, invoices y webhooks.

@timbrix/cli

Automatiza flujos de organizaciones, webhooks y API keys desde scripts o pipelines CI/CD.

Sandbox sin costo, incluido en todos los planes

Prueba el flujo completo de timbrado sin generar timbres reales: mismos endpoints, mismos formatos de respuesta, mismos webhooks que producción. Sin validez fiscal ante el SAT, con hasta 300 CFDI de prueba por día.

Rate limits por plan

Plan
Rate limit
Starter
30 req/min
Pro
120 req/min
Business
300 req/min
Enterprise
Custom

¿Listo para timbrar desde tu API?

Probar 14 días gratis