API y Webhooks

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 con 81 herramientas, todo detrás de una sola clave de API.

Plan Business en adelanteComparar planes
Ilustración de una clave de API, corchetes de código, flechas de webhook y un servidor intercambiando documentos de factura

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 y crear facturas 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 desbloquea el servidor MCP, así que Claude, un IDE o cualquier cliente de Model Context Protocol puede usar el conjunto completo de herramientas: facturas, clientes, propuestas, órdenes de compra, seguimiento de tiempo y más. Las claves se crean en Configuración, luego Desarrollador, con una caducidad opcional de hasta 365 días.

  • Endpoints REST v1 para facturas, clientes y avisos de remesa.
  • 25 eventos de webhook con firmas HMAC-SHA256 y reintentos.
  • Servidor MCP con 81 herramientas sobre HTTP transmitible.
  • 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

Genera claves en Configuración, sección Desarrollador. Cada clave se muestra una sola vez, se guarda como hash, puede tener caducidad y se revoca sin afectar a las demás.

Webhooks

Suscribe un endpoint HTTPS a cualquiera de los 25 eventos de facturas, pagos, clientes, avisos de remesa y facturas recurrentes, o a todos con un comodín.

Servidor MCP

Conéctate en https://mcp.invoicemyclients.com/mcp con tu clave y un cliente de IA obtiene 81 herramientas, desde crear una factura hasta registrar tiempo y enviar una propuesta.

Firmado y con reintentos

Cada entrega lleva X-Webhook-Event, X-Webhook-Timestamp y una firma HMAC-SHA256 en X-Webhook-Signature. Las entregas fallidas se reintentan a los 5 y 25 segundos y quedan registradas para revisión.

Límites de uso

El servidor MCP permite 300 solicitudes por minuto por cliente. La creación de claves se limita a cinco claves por minuto por cuenta.

Documentación para desarrolladores en la app

La sección Desarrollador en Configuración documenta cada endpoint con ejemplos de curl y el fragmento de conexión MCP para Claude Desktop y Claude Code.

03 / Proceso

Cómo conectarte

01

Crea una clave de API

En Configuración, abre Desarrollador y genera una clave. Cópiala en ese momento: después solo se muestra una versión enmascarada.

02

Llama a la API REST

Envía solicitudes con Authorization: Bearer imc_live_... a /v1/invoices, /v1/clients o /v1/remittance-advice. Crea, lista, actualiza y envía desde tu propio código o una plataforma de automatización.

03

Registra un webhook

Agrega tu endpoint HTTPS y elige los eventos. Verifica la firma HMAC al recibir y responde en menos de 10 segundos.

04

Apunta un cliente de IA al servidor MCP

Pega el fragmento mcpServers de la sección Desarrollador en Claude Desktop, o ejecuta claude mcp add con el transporte HTTP, y las herramientas quedan activas.

04 / FAQ

Preguntas frecuentes sobre la API

¿Qué recursos cubre la API REST?

Facturas (listar, crear, enviar como factura electrónica), clientes (listar, crear) y avisos de remesa (listar, crear, actualizar, enviar). Pagos, propuestas y registros de tiempo están disponibles mediante las herramientas del servidor MCP.

¿A qué eventos de webhook puedo suscribirme?

Veinticinco eventos en cinco grupos: factura (creada, enviada, vista, pagada, vencida y más), pago (iniciado, exitoso, fallido, registrado), cliente (creado, actualizado), aviso de remesa (creado, enviado, confirmado) y facturas recurrentes. Un comodín se suscribe a todos.

¿Cómo se protegen los webhooks?

Cada solicitud se firma con HMAC-SHA256 sobre la marca de tiempo y el cuerpo usando el secreto de tu endpoint, enviada en el encabezado X-Webhook-Signature junto con el nombre del evento y la marca de tiempo. Las entregas fallidas se reintentan y se registran.

¿Qué planes incluyen acceso a la API?

Las claves de API, los webhooks y el servidor MCP forman parte del plan Business en adelante. Los planes Enterprise y White Label agregan asignaciones de IA compartidas y, en White Label, derechos de integración embebida.

¿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. Las apps nativas en ambos directorios están en beta; pide acceso a soporte.

Publica tu primera integración esta tarde

Una clave para la API REST, los webhooks y el servidor MCP.

No se requiere tarjeta de crédito para empezar.