Facturación electrónica en México para cualquier sistema: facturas PUE, PPD y globales, recibos de nómina, complementos de pago, cancelaciones, PDF del SAT y webhooks. Llaves estilo Stripe, sandbox con sk_test_, $1 MXN por timbre y sin mensualidad. La skill escribe la integración; el MCP factura en el chat.
$ npx skills add CFDI-Express/skillsLa skill oficial para Claude Code, Cursor, Codex y OpenCode.
Skill para agentes · Página de la skill · Referencia de la API · Docs Scalar · Guías · Agendar una demo
# Timbra una factura PUE $ curl https://api.cfdi.express/v1/invoices \ -H "Authorization: Bearer sk_test_…" \ -H "Idempotency-Key: orden-1042" \ -d '{ "merchantId": "mer_…", "receptor": { "rfc": "XAXX010101000", … }, "conceptos": [ … ] }' # ← 201 Created { "id": "inv_9f2…", "status": "stamped", "uuid": "A1B2C3…", "pdfUrl": "https://…", "xmlUrl": "https://…" }
De la factura de ingreso al recibo de nómina, el complemento de pago y el webhook. Sin portales, sin Excel, sin calcular impuestos a mano.
Timbrado CFDI 4.0 nominativo y global (público en general) con las reglas del SAT validadas del lado del servidor. Motor de impuestos incluido: tú no calculas nada.
Desde la v1.28.0, cada concepto de POST /v1/invoices y POST /v1/credit_notes acepta pedimentos: los números de pedimento de la mercancía importada que vendes de primera mano. Hasta 100, es opcional. Lo emitimos en InformacionAduanera (21 caracteres del SAT) y sale en el XML y en el PDF. Funciona igual por el servidor MCP: un agente puede timbrar la factura o la nota de crédito con el pedimento de cada concepto.
CFDI 4.0 con complemento Nómina 1.2 en POST /v1/nominas: un recibo por empleado y periodo. La API deriva los totales del SAT; tú mandas fechas, empleado, percepciones y deducciones. Mismo precio por timbre.
Avisos cuando una factura, un complemento de pago o un recibo de nómina se timbra, falla o se cancela. Firma CFDI-Signature y secreto whsec_. Tu ERP deja de hacer polling.
Pagos 2.0 con numParcialidad y saldos calculados en servidor. Sobrepagos, pagos fuera de secuencia y facturas liquidadas se rechazan solos.
Motivos 01–04, folioSustitucion cuando aplica y el acuse XML del SAT guardado con URL firmada. Cancelar un REP restaura el saldo de la factura.
PDF Anexo 20 con QR, sellos y cadena original, generado por nosotros. XML, PDF y ZIP servidos como URLs firmadas de 15 minutos.
52,513 claves de producto (con sinónimos), 2,418 unidades, usos CFDI, regímenes fiscales y formas de pago. Sin lookups externos.
Varios emisores por cuenta, cada uno con su CSD validado (vigencia, llave↔cert, RFC) y encriptado con AES-256-GCM. Todos activos a la vez.
Idempotency-Key persistente por cuenta y modo: un replay devuelve la respuesta original, duplicados concurrentes reciben 409 y misma llave con otro body, 422.
npx skills add CFDI-Express/skills y tu agente de código ya conoce la autenticación, la idempotencia, los errores y el mapa de endpoints. Cero adivinanzas con los campos del SAT.
Llaves sk_test_/sk_live_, livemode en cada recurso, errores problem+json, IDs opacos y paginación por cursor. Si usaste Stripe, ya sabes usar esto.
Spec OpenAPI generada del código con docs interactivas para probar cada endpoint desde el navegador. Errores con subcódigos específicos.
Regístrate en dash.cfdi.express y obtén tu llave sk_test_ al instante, con saldo de prueba para el sandbox.
POST /v1/merchants con tus archivos .cer y .key. Validamos vigencia, llave↔cert y RFC antes de guardarlos encriptados.
POST /v1/invoices con emisor, receptor y conceptos. El motor de impuestos calcula todo por ti.
Recibe URLs firmadas del XML, PDF y ZIP listas para enviar a tu cliente o guardar en tu sistema.
¿Vas a integrar con un agente de código? Empieza por npx skills add CFDI-Express/skills y deja que él haga los cuatro pasos — ver cómo funciona la skill
JSON en, JSON out. Errores problem+json con subcódigos específicos para que tu código sepa exactamente qué pasó.
{
"merchantId": "mer_8xk2…",
"tipoDeComprobante": "I",
"metodoPago": "PUE",
"formaPago": "03",
"receptor": {
"rfc": "EKU9003173C9",
"nombre": "ESCUELA KEMPER URGATE",
"regimenFiscal": "601",
"domicilioFiscal": "76000",
"usoCfdi": "G03"
},
"conceptos": [{
"claveProdServ": "01010101",
"claveUnidad": "E48",
"descripcion": "Desarrollo de software",
"cantidad": 1,
"valorUnitario": 1500.00,
"objetoImp": "02"
}]
}{
"id": "inv_9f2c41…",
"livemode": false,
"status": "stamped",
"uuid": "A1B2C3D4-…-000000000042",
"serie": "FA",
"folio": "1042",
"total": "1740.00",
"chargedCentavos": 100,
"pdfUrl": "https://files.cfdi.express/…?sig=…",
"xmlUrl": "https://files.cfdi.express/…?sig=…",
"zipUrl": "https://files.cfdi.express/…?sig=…",
"created": "2026-08-01T18:22:10.512Z"
}Estos son los más usados, incluidos nómina y webhooks. La referencia en el sitio trae ejemplos por endpoint; el OpenAPI en vivo está en las docs Scalar.
Publicamos la skill de CFDI Express en abierto. Instálala en tu agente de código y describe lo que necesitas: él escribe la integración con la autenticación, la idempotencia, el manejo de errores y los endpoints correctos, sin adivinar campos del SAT.
$ npx skills add CFDI-Express/skillsCompatible con Claude Code, Cursor, Codex, OpenCode y cualquier agente soportado por skills.
# La skill completa $ npx skills add CFDI-Express/skills # O sólo esta skill, para un agente en específico $ npx skills add CFDI-Express/skills \ --skill cfdi-express-api -a claude-code
Integra CFDI Express en este proyecto: cuando una orden se marque como pagada, timbra un CFDI PUE con el RFC del cliente y guarda el UUID, el XML y el PDF. Usa mi llave sk_test_ y manda un Idempotency-Key con el id de la orden.
URL base, llaves sk_test_/sk_live_, Idempotency-Key, paginación por cursor y errores problem+json con su código estable. El agente no tiene que inferirlas del ejemplo de un blog.
La skill lo manda al OpenAPI y a la referencia en markdown (llms.txt por endpoint) antes de escribir código. Menos campos alucinados, menos rechazos del SAT.
El mapa de endpoints: emisores y CSD, facturas PUE/PPD/globales, notas de crédito, complementos de pago REP, recibos de nómina, cancelaciones, catálogos del SAT y saldo.
La skill es para escribir la integración; el servidor MCP es para que el agente facture en vivo. Instala una, conecta el otro y tienes las dos mitades.
La skill es de código abierto en github.com/CFDI-Express/skills y se instala con skills, el gestor de skills de Vercel Labs. La página dedicada, con el detalle de instalación, está en /skill.
La otra mitad: si la skill hace que tu agente escriba la integración, el servidor MCP (Model Context Protocol) lo deja facturar en vivo. Conéctalo a claude.ai, ChatGPT, Claude Code, Cursor o a tu agente propio y pídele en lenguaje natural que timbre facturas o recibos de nómina, registre pagos o cancele CFDIs.
Grabamos el proceso completo sin cortes: desde una cuenta nueva hasta un CFDI 4.0 timbrado ante el SAT, pidiéndolo en español a Claude. Sin terminal, sin instalar nada, sin escribir código.
Todo el tutorial corre en modo de pruebas: puedes seguirlo paso a paso sin gastar un peso.
Agrégalo como conector personalizado con esta URL e inicia sesión con tu cuenta del dashboard. Sin llaves, sin configuración:
https://api.cfdi.express/mcp¿Solo quieres experimentar? Conecta https://api.cfdi.express/mcp/test y tu agente timbra contra el sandbox del SAT, gratis.
# Claude Code
claude mcp add --transport http cfdi \
https://api.cfdi.express/mcp \
--header "Authorization: Bearer sk_test_…"
// Cursor / Windsurf — mcp.json
{
"mcpServers": {
"cfdi": {
"url": "https://api.cfdi.express/mcp",
"headers": {
"Authorization": "Bearer sk_test_…"
}
}
}
}18 herramientas que cubren el ciclo CFDI completo:
Conecta /mcp/test (o usa tu llave sk_test_) y tu agente timbra contra el sandbox del SAT gratis, sin gastar saldo. Cambia a /mcp cuando estés listo para producción.
Cada error regresa el código estable del API (validation_error, insufficient_credits, sat_rejected…), punteros por campo y una pista de reintento — el agente se autocorrige solo.
Las herramientas que timbran aceptan idempotency_key: si el agente reintenta, recibe el documento original sin gastar otro timbre. Cero dobles timbres, también con IA.
El agente puede timbrar, cancelar y consultar, pero los CSDs no se administran por MCP: tus certificados solo se suben y validan desde el dashboard.
¿No eres developer y solo quieres pedirle facturas a ChatGPT o Claude? Hay una versión de esta página sin código: Factura desde tu agente
La misma infraestructura que timbra para las tiendas Shopify de CFDI Express, endurecida bajo pruebas de ráfaga.
Los timbres nunca se reintentan a ciegas: una falla ambigua con el PAC marca el documento para reconciliación manual y mantiene tu saldo reservado. Verificado con 35 timbres concurrentes: contabilidad exacta.
Cada timbre reserva saldo y lo confirma al timbrar. Si el SAT rechaza o el PAC falla, el reembolso es automático — con ledger completo para auditar cada centavo.
300 requests por minuto por llave con 429 + Retry-After, límite de body de 1 MB y un registro de auditoría en cada mutación. Predecible bajo carga.
Tus certificados se guardan con encriptación de sobre AES-256-GCM. La validación es local: vigencia, match llave↔certificado, RFC y rechazo de FIEL con subcódigos claros.
Sin mensualidad, sin mínimos, sin contratos. Saldo prepagado que recargas cuando lo necesitas.
Para cualquier volumen
¿Vendes en Shopify? La app tiene planes desde $15 USD/mes — ver planes de la app
Dos formas de contratar una API de facturación electrónica en México. Aquí está el modelo de CFDI Express. Las cifras de otras APIs están en el comparativo, no en esta página.
La app de Shopify es otro SKU, con mensualidad en USD. Esta página es solo la API. Ver planes de la app
La landing es el resumen. Cada tema largo vive en su guía, y la skill y el agente tienen página propia.
Pay-as-you-go frente a APIs con cuota mensual. Las cifras públicas del comparativo están en este post.
LeerEventos invoice.*, payment.* y nomina.*, firma CFDI-Signature y cómo dejar el polling.
LeerCFDI 4.0 con Nómina 1.2 en POST /v1/nominas: un recibo por empleado y totales derivados en el servidor.
Leeritems[].pedimentos en facturas y notas de crédito, por API y por el servidor MCP. Nosotros lo emitimos en los 21 caracteres del SAT.
LeerQué incluye la API pública: PUE, PPD, globales, REP, cancelaciones y $1 MXN por timbre.
LeerPide CFDIs en español desde ChatGPT o Claude. La página sin código, para quien no va a integrar REST.
Leernpx skills add CFDI-Express/skills. Tu agente escribe la integración en el proyecto.
LeerMapa de endpoints con ejemplos, en el sitio. Para probar cada llamada en vivo, abre las docs Scalar.
LeerSandbox gratis. Sin mensualidad. Llaves sk_test_ al instante.
Skill para agentes · Factura desde tu agente · Referencia de la API · Docs Scalar · Agendar una demo