Facturación que puedes programar, suscribir y entregar a un agente
Una API REST para facturas, clientes y avisos de remesa, webhooks firmados para los eventos que importan y un servidor MCP para tu cliente de IA. Las claves de API, la API REST y el servidor MCP están incluidos en el plan Professional y superiores.
01 / API y Webhooks
¿Qué es la API de Invoice My Clients?
La API es el lado programable de tu cuenta. Con una clave Bearer puedes listar facturas y clientes, crear facturas en borrador y clientes, gestionar avisos de remesa y disparar el envío de una factura electrónica, desde tu propio código, Zapier o Make. Los webhooks salientes envían eventos a tu endpoint en el momento en que algo cambia.
La misma clave conecta el servidor MCP, así que Claude, un IDE o cualquier cliente de Model Context Protocol puede usar las herramientas del asistente de la aplicación: facturas, clientes, pagos, propuestas, seguimiento de tiempo, reportes y más. Las claves se crean en Configuración, luego Desarrollador, en el plan Professional y superiores. Las cuentas Free y Starter no tienen acceso de ningún tipo a la API ni a MCP.
- Plan Professional y superiores: claves de API, API REST y servidor MCP.
- Endpoints REST v1 para facturas, clientes y avisos de remesa.
- Eventos de webhook con firmas HMAC-SHA256 y reintentos.
- Claves con prefijo imc_live_, almacenadas como hash y revocables en cualquier momento.
02 / Capacidades
Hecha para automatizar, no solo para integrar
La API cubre los objetos que una automatización realmente toca, y los webhooks te dicen cuándo actuar.
Claves de API
En Professional y superiores, genera claves en Configuración, sección Desarrollador. Cada clave se muestra una sola vez, se guarda como hash y se revoca sin afectar a las demás. Una clave actúa solo sobre tu propia cuenta, y los registros de clientes que devuelve nunca incluyen un número de seguro social ni un número de cuenta bancaria.
Webhooks
Suscribe un endpoint HTTPS a eventos de facturas, pagos, clientes, avisos de remesa y facturas recurrentes, o a todos a la vez.
Servidor MCP
Conéctate en https://mcp.invoicemyclients.com/mcp iniciando sesión cuando tu cliente de IA lo admita, o con una clave de API. Ambas formas requieren el plan Professional o superior. El cliente obtiene herramientas para facturas, clientes, pagos, propuestas, tiempo, reportes y cobranza; las llamadas que contactarían a tus clientes se rechazan en cuentas en producción, así que el envío se hace en la aplicación.
Firmado y con reintentos
Cada entrega lleva en sus encabezados el nombre del evento, una marca de tiempo y una firma HMAC-SHA256. Las entregas fallidas se reintentan a los 5 y 25 segundos y quedan registradas para revisión.
Límites de uso
El servidor MCP tiene límite de uso, 300 solicitudes por minuto de forma predeterminada. La creación de claves se limita a cinco claves por minuto por cuenta. Los endpoints de lista devuelven 50 registros de forma predeterminada y 100 como máximo.
Documentación para desarrolladores en la app
La sección Desarrollador en Configuración muestra tu URL base, documenta cada endpoint y sus parámetros con ejemplos de curl, y tiene los fragmentos de conexión MCP para Cursor y Claude Code.
03 / Proceso
Cómo conectarte
Ten Professional o superior y crea una clave
Las claves de API, la API REST y el servidor MCP están incluidos en Professional, Business y Enterprise. Abre Configuración, luego Desarrollador, y genera una clave de API. Cópiala en ese momento: después solo se muestra una versión enmascarada. Los clientes MCP interactivos pueden iniciar sesión en lugar de usar una clave.
Llama a la API REST
Envía la clave como token bearer para listar y crear facturas y clientes y para gestionar avisos de remesa, desde tu propio código o una plataforma de automatización. Las facturas nuevas se crean como borrador; el envío de una factura al cliente se hace en la aplicación.
curl -H "Authorization: Bearer $IMC_API_KEY" \
"$IMC_API_BASE/v1/invoices?status=SENT&limit=10"Registra un webhook
En Configuración, luego Integraciones, agrega tu endpoint HTTPS y elige los eventos. Verifica la firma HMAC al recibir y responde en menos de 10 segundos.
Apunta un cliente de IA al servidor MCP
Agrega la URL del servidor con HTTP transmisible. Los clientes que admiten el inicio de sesión de MCP descubren el flujo automáticamente; los demás envían la clave de API como token bearer.
export IMC_API_KEY="imc_live_your_api_key"
claude mcp add --transport http invoice-my-clients https://mcp.invoicemyclients.com/mcp \
--header "Authorization: Bearer $IMC_API_KEY"04 / FAQ
Preguntas frecuentes sobre la API
¿Qué recursos cubre la API REST?
Facturas (listar, crear como borrador, enviar como factura electrónica por Peppol o DBNA), clientes (listar, crear) y avisos de remesa (listar, crear, consultar, actualizar, marcar como enviado). No hay un endpoint que envíe una factura por correo a un cliente. Pagos, propuestas y registros de tiempo están disponibles mediante las herramientas del servidor MCP.
GET /v1/invoices
POST /v1/invoices
POST /v1/invoices/:id/send-einvoice
GET /v1/clients
POST /v1/clients
GET /v1/remittance-advice
POST /v1/remittance-advice
GET /v1/remittance-advice/:id
PATCH /v1/remittance-advice/:id
POST /v1/remittance-advice/:id/send¿A qué eventos de webhook puedo suscribirme?
Eventos en cinco grupos: factura (creada, actualizada, enviada, vista, anulada, vencida y más), pago (iniciado, exitoso, fallido, registrado), cliente (creado, actualizado), aviso de remesa (creado, enviado, confirmado) y facturas recurrentes (programada, cancelada). Puedes suscribirte a todos a la vez.
¿Cómo se protegen los webhooks?
Cada solicitud se firma con HMAC-SHA256 sobre la marca de tiempo, un punto y el cuerpo usando el secreto de tu endpoint, enviada en hexadecimal en el encabezado de firma junto con el nombre del evento y la marca de tiempo. Las entregas fallidas se reintentan a los 5 y 25 segundos y se registran.
X-Webhook-Event: invoice.sent
X-Webhook-Timestamp: 2026-10-11T15:04:05.000Z
X-Webhook-Signature: <hex HMAC-SHA256 of "timestamp.body">¿Qué planes incluyen acceso a la API?
Las claves de API, la API REST y el servidor MCP están incluidos en el plan Professional y superiores: Professional, Business, Enterprise y White Label. Free y Starter no tienen acceso de ningún tipo a la API ni a MCP, ni con clave de API ni iniciando sesión desde un cliente de IA, y no existen claves de solo lectura. Los webhooks se configuran aparte en Configuración, luego Integraciones.
¿Hay integración con Zapier o Make?
La API REST se construyó pensando en Zapier y Make y funciona hoy con sus módulos HTTP y de webhooks (beta). Todavía no hay una app nativa en ninguno de los dos directorios. Como se conectan con una clave de API, requieren el plan Professional o superior.
Publica tu primera integración esta tarde
Una clave para la API REST y el servidor MCP, más webhooks firmados. Plan Professional y superiores.
No se requiere tarjeta de crédito para empezar.