Para desarrolladores
API de facturación CFDI 4.0 y MCP
Timbra facturas y crea tickets desde tu punto de venta, tu ERP o tu tienda en línea con una llamada HTTP. Prueba con claves de prueba y conecta a tu asistente de IA por MCP.
- Incluida en todos los planes
- Modo prueba sin timbrar facturas reales
- Documentación y OpenAPI públicas
API REST en español
JSON con los nombres del SAT. Una llamada a POST /api/v1/facturas timbra una factura y devuelve el folio fiscal.
Modo prueba con claves mf_test_
Integra contra el sandbox del PAC con el RFC de prueba del SAT, sin timbrar facturas reales.
MCP para agentes de IA
Tu asistente busca clientes, crea facturas y tickets, con tu confirmación antes de timbrar.
Incluida en todos los planes
No hay un cargo aparte por la API ni por el MCP, ni en el plan Gratis.
Cómo funciona
Así funciona, en tres pasos.
Paso 1
Crea una clave de prueba
Un administrador abre el menú de su organización, entra a API y crea una clave. La de prueba empieza con mf_test_.
Paso 2
Prueba tu integración
Envía tu primera factura con curl o desde tu código. En modo prueba se timbra en el sandbox con el RFC de prueba del SAT.
Paso 3
Cambia a tu clave mf_live_
Cuando todo funcione, crea una clave mf_live_ y úsala en lugar de la de prueba. Desde ahí tus facturas son reales.
Un ejemplo
Una llamada, una factura timbrada.
Así se ve una factura de prueba. Cambia la clave mf_test_ por tu clave y el ejemplo por tus datos.
curl https://magifactura.com/api/v1/facturas \
-H "Authorization: Bearer mf_test_…" \
-H "Content-Type: application/json" \
-d '{
"receptor": {
"rfc": "EKU9003173C9",
"nombre": "ESCUELA KEMPER URGATE",
"cp": "42501",
"regimen": "601",
"usoCfdi": "G03"
},
"conceptos": [
{
"descripcion": "Consultoría",
"claveProdServ": "80111600",
"precio": 1000
}
],
"formaPago": "03"
}'- Documentación y especificaciónTodos los endpoints, cuerpos y errores están en la documentación de la API, y la especificación OpenAPI 3.1 en /api/v1/openapi.json.
- Servidor MCPConecta tu asistente de IA a
https://magifactura.com/api/mcp. - OAuth 2.1Las aplicaciones y los agentes se conectan con OAuth 2.1, registro dinámico de clientes y PKCE.
Precios
Empieza gratis. Paga cuando crezcas.
Todos los planes incluyen tu portal de autofacturación, envío por WhatsApp y correo, facturas CFDI 4.0 con tu marca, y la API y MCP para conectar tus sistemas.
Gratis
Para probar tu portal.
$0al mes
- 5 facturas al mes
- Portal con tu logo
- API y MCP incluidos
Pyme
Para negocios en crecimiento.
$499+ IVA al mes
- 100 facturas al mes
- Soporte por WhatsApp
- API y MCP incluidos
Premium
Para negocios establecidos.
$999+ IVA al mes
- 300 facturas al mes
- Soporte prioritario
- API y MCP incluidos
A tu medida
Para alto volumen o necesidades especiales.
Personalizado
- Precio según tu volumen de facturas
- Te ayudamos a configurarlo
- API y MCP incluidos
Preguntas frecuentes
Lo que nos preguntan antes de empezar.
¿La API cuesta extra?
No. La API y el servidor MCP están incluidos en todos los planes, también en el Gratis.
¿Puedo probar sin timbrar facturas reales?
Sí. Con una clave mf_test_ las facturas se timbran en el sandbox del PAC con el RFC de prueba del SAT, así que no se emite ningún CFDI real. Ojo: los clientes, productos y preferencias que crees o cambies con una clave de prueba sí son los de tu organización.
¿Qué es el servidor MCP?
Es una conexión para que un asistente de IA, como Claude o ChatGPT, use tu cuenta de Magifactura: busca clientes, crea facturas y tickets, y las envía por correo. El asistente te pide confirmar antes de timbrar o cancelar. El servidor está en https://magifactura.com/api/mcp.
¿Cómo evito timbrar dos veces la misma factura?
Envía el encabezado Idempotency-Key en cada POST, por ejemplo con el número de pedido. Si se corta la conexión, repite la solicitud con la misma clave y el mismo cuerpo: recibes la respuesta original y no se timbra otra vez. La clave dura 24 horas.
¿Hay límites de uso?
Sí: 120 solicitudes por minuto y 30 timbrados o cancelaciones por minuto, por cada clave. Si te pasas, la API responde 429 con el encabezado Retry-After, que indica cuántos segundos esperar.
¿Puedo conectar una app con OAuth?
Sí. Magifactura es un servidor OAuth 2.1 con registro dinámico de clientes y PKCE, para que una aplicación o un agente se conecte a una organización sin que copies una clave. Quien autoriza debe ser administrador de la organización y puede desconectar la aplicación cuando quiera.
Más soluciones
También te puede interesar.
Conecta tu sistema hoy.
Crea tu cuenta gratis, genera una clave de prueba y timbra tu primera factura desde tu código.