Timbrix API · CFDI 4.0 · MCP Server nativo

Timbra facturas con una llamada

REST API documentada, SDK oficial en TypeScript y sandbox ilimitado. La única API CFDI 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. Sin wrappers, sin adaptadores — el único CFDI API con esta integración.

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 ilimitado

Mismos endpoints y respuestas que producción, sin timbres reales ni límite de transacciones.

Diseñada API-first, para integrarse en horas

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_... — 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/organizations/{organizationId}/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/organizations/{organizationId}/customers

Clientes y catálogo de productos con claves oficiales del SAT

POST/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(organizationId, {
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, sin límite de transacciones.

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