Kema Invoice
Facturación electrónica conforme (Factur-X, EN 16931) que los agentes de IA operan mediante MCP: crear, emitir, enviar y rastrear facturas, presupuestos y anticipos en lenguaje natural. Servidor remoto, OAuth 2.1, e-facturas transmitidas a través de una plataforma acreditada.
GitHubPrueba este MCPPatrocinado
Servidor MCP alojado
npx add-mcp 'https://mcp.kema-studio.com/api/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Conector MCP de Kema Invoice
Kema Invoice es un software de facturación electrónica conforme que los agentes de IA pueden operar a través del Protocolo de Contexto de Modelo. Conecta el servidor MCP remoto a Claude, Cursor o cualquier cliente MCP, autoriza una vez con OAuth 2.1, y tu agente puede crear, emitir, enviar y rastrear facturas, presupuestos y anticipos en lenguaje natural. Las facturas se generan como Factur-X (EN 16931) y se transmiten a través de una plataforma acreditada. Nada que instalar: el servidor se ejecuta en https://mcp.kema-studio.com/api/mcp.
Sitio web · Documentación · Conecta tu agente · Entrada en el Registro MCP · Versión francesa
Qué contiene este repositorio
El conector es un servidor MCP remoto (HTTP Streamable + OAuth 2.1). No hay paquete que instalar y el código del servidor no se publica aquí. Este repositorio contiene lo que un integrador o un directorio necesita:
| Archivo | Propósito |
|---|---|
tools.json | Las 41 herramientas con título, descripción, grupo e indicaciones de acceso. Generado a partir del código del servidor, nunca editado a mano. |
server.json | La declaración publicada en el Registro MCP oficial (com.kema-studio/invoice). |
examples/ | Configuraciones de cliente listas para pegar y un manual de indicaciones. |
scripts/verify-connection.ts | Un pequeño script de código abierto que ejecuta el flujo OAuth y lista las herramientas, para verificar una conexión de extremo a extremo. |
CHANGELOG.md | Versiones del conector. |
Conéctate en dos minutos
| Cliente | Cómo |
|---|---|
| claude.ai / Claude Desktop | Configuración › Conectores › Añadir conector personalizado, pega https://mcp.kema-studio.com/api/mcp, autoriza una vez. |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | Añade examples/cursor-mcp.json a .cursor/mcp.json. |
| Cualquier cliente MCP | Transporte HTTP Streamable, URL anterior, OAuth 2.1 con PKCE y registro dinámico de clientes (RFC 7591). Los metadatos del servidor de autorización se descubren desde /.well-known/oauth-protected-resource. |
La primera llamada abre una página de consentimiento en auth.kema-studio.com. Inicias sesión con tu cuenta de Kema Invoice, apruebas y el cliente almacena el token. El acceso se puede revocar en cualquier momento desde la aplicación o desde el cliente.
¿Aún no tienes cuenta? Crea una: prueba de 14 días con 10 facturas incluidas, un usuario, sin tarjeta de crédito. Luego un único plan a 10 € por usuario al mes sin IVA, todas las funciones incluidas, cancela cuando quieras.
Qué puede hacer tu agente
Facturas (16)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_invoice | Crea una nueva factura en estado Borrador para una empresa, con líneas de detalle. La factura NO se envía ni se certifica: una persona la emite desde la aplicación (o usa issue_invoice). El IVA se calcula automáticamente mediante reglas fiscales estrictas del lado del servidor (escenario + valores predeterminados): nunca preguntes al usuario por una tasa de IVA. El escenario fiscal y la instantánea del cliente se congelan en la creación. | escritura |
issue_invoice | Emite una factura en Borrador: el acto legal de CREAR la factura (el producto lo llama 'Créer la facture'; el antiguo concepto de 'enviar' está obsoleto). El borrador se convierte en una factura certificada e inmutable (estado Enviada, mostrada como 'Créée') y se envía INMEDIATAMENTE para certificación fiscal. IRREVERSIBLE y legalmente vinculante según la ley francesa: solo se deshace con una nota de crédito. MUESTRA SIEMPRE al usuario los detalles de la factura y obtén su aprobación explícita antes de llamar con confirm:true. Sin confirm, devuelve una vista previa de lo que se certificará. | escritura, destructiva |
list_invoices | Lista las facturas del inquilino autenticado, las más recientes primero. Admite filtrado por estado, tipo de documento y búsqueda de texto libre por número de factura o nombre de cliente, además de paginación. | lectura |
get_invoice | Obtiene una sola factura por id, incluyendo sus líneas de detalle, cliente y totales. Devuelve un error con forma de null si la factura no es visible para quien llama. | lectura |
get_invoice_pdf | Devuelve una URL de descarga firmada temporal (1 hora) para el PDF de una factura. Funciona para cualquier documento visible para quien llama: las facturas importadas devuelven su archivo subido; las facturas emitidas en Kema Invoice (por la aplicación o un agente) se renderizan del lado del servidor con la marca del espacio de trabajo y, una vez certificadas, incorporan el XML Factur-X. Los borradores también se renderizan (marcados is_draft: true) pero aún no son documentos legales. | lectura |
update_invoice | Actualiza campos de una factura en Borrador (fechas, condiciones de pago, notas o reasignación de la empresa). Solo las facturas en Borrador se pueden modificar: una factura Enviada/certificada es inmutable. | escritura |
delete_invoice | Elimina de forma suave una factura en Borrador. Irreversible desde la vista del usuario. Llama con confirm:true para eliminar realmente; sin ello, devuelve una vista previa de lo que se eliminaría. | escritura, destructiva |
cancel_invoice | Cancela una factura no pagada (estado → Cancelada). Irreversible. Para una factura certificada (Enviada), la ley francesa generalmente exige una nota de crédito (create_credit_note) en lugar de una cancelación simple. Llama con confirm:true para actuar; de lo contrario, devuelve una vista previa. | escritura, destructiva |
mark_invoice_paid | Marca una factura Enviada o Vencida como Pagada. Opcionalmente, establece la fecha de pago (por defecto, ahora). | escritura |
add_invoice_item | Añade una línea de detalle a una factura en Borrador. Los totales se recalculan automáticamente. | escritura |
update_invoice_item | Actualiza una línea de detalle en una factura en Borrador. Los totales se recalculan automáticamente. Los ids de los artículos provienen de get_invoice o add_invoice_item. | escritura |
delete_invoice_item | Elimina una línea de detalle de una factura en Borrador. Los totales se recalculan automáticamente. Los ids de los artículos provienen de get_invoice o add_invoice_item. Llama con confirm:true para eliminar; sin ello, devuelve una vista previa del artículo. | escritura, destructiva |
reorder_invoice_items | Establece el orden de visualización de las líneas de detalle de una factura. Pasa el orden completo deseado: cada id de artículo con su display_order basado en 0. Los ids de los artículos provienen de get_invoice o add_invoice_item. | escritura |
update_invoice_matter | Adjunta o desadjunta el asunto (dossier) en una factura. Puramente organizativo: permitido incluso después de que la factura esté Enviada, pero no en una factura Cancelada. Pasa matter_id null para desadjuntar. | escritura |
check_certification_status | Actualiza el estado de certificación fiscal de una factura emitida consultando al proveedor de certificación y conciliándolo en la base de datos. Úsalo después de issue_invoice cuando certification_status esté en 'processing' o parezca desactualizado. | escritura |
create_credit_note | Cancela una factura Enviada o Pagada emitiendo una nota de crédito (avoir). La nota de crédito es un documento fiscal legal (certificada fiscalmente cuando el original estaba certificado) y es INMUTABLE una vez creada. IRREVERSIBLE. OBTÉN SIEMPRE la aprobación explícita del usuario antes de llamar con confirm:true. Sin confirm, devuelve una vista previa. | escritura, destructiva |
Rectificación e importación (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
rectify_invoice | Crea una factura rectificativa (facture rectificative) para una factura Enviada o Pagada: una NUEVA factura en Borrador precargada desde el original (mismo cliente, líneas de detalle copiadas a menos que se sobrescriban) y legalmente vinculada a él. El original se marca como Rectificada solo cuando se emite la rectificativa. Llama con confirm:true para crear; sin ello, devuelve una vista previa. | escritura |
get_rectification_links | Para una factura, devuelve la cadena de rectificación: el original que reemplaza (si es una rectificativa) y/o la rectificativa que lo reemplazó (si fue rectificado). Ambos null cuando la factura no forma parte de una cadena. | lectura |
import_external_invoice | Importa una factura histórica/externa con su PROPIO número de factura (conservado textualmente), totales y estado, sin líneas de detalle. Úsalo para migrar facturas pasadas emitidas fuera de Kema Invoice; NO para crear nuevas facturas (usa create_invoice). | escritura |
Presupuestos (5)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_quote | Crea un presupuesto en Borrador (devis) para una empresa. Los presupuestos no son documentos fiscales: no hay certificación. Las fechas se establecen por defecto del lado del servidor (emisión hoy, vencimiento/válido +30 días). Requiere un id de asunto (dossier) al que pertenece el presupuesto. | escritura |
send_quote | Transiciona un presupuesto en Borrador a Enviado (el estado orientado al cliente). No implica certificación: los presupuestos son documentos comerciales. La validación B2B francesa (SIREN/IVA) se aplica cuando el inquilino es francés. | escritura, destructiva |
accept_quote | Marca un presupuesto Enviado como Aceptado por el cliente. Continúa con convert_quote_to_invoice para facturarlo. | escritura, destructiva |
reject_quote | Marca un presupuesto Enviado como Rechazado por el cliente. Esto termina el ciclo de vida del presupuesto. Llama con confirm:true para aplicar; sin ello, devuelve una vista previa. | escritura, destructiva |
convert_quote_to_invoice | Crea una nueva factura en Borrador a partir de un presupuesto Aceptado (líneas de detalle copiadas, source_quote_id establecido para trazabilidad). La factura sigue entonces el ciclo de vida normal (issue_invoice para hacerla legalmente vinculante). Llama con confirm:true para aplicar; sin ello, devuelve una vista previa. | escritura |
Anticipos (6)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_provision | Crea un documento de provisión (avance sur honoraires, anticipo) en estado Borrador para una empresa, opcionalmente vinculado a un asunto. NO se emite ni se certifica: usa send_provision para la emisión legal. El IVA se calcula automáticamente mediante reglas fiscales estrictas del lado del servidor: nunca preguntes al usuario por una tasa de IVA. Las provisiones usan su propia serie de numeración PROV y, una vez pagadas, se convierten en un crédito del cliente deducible de la factura final (apply_provisions_to_invoice). | escritura |
send_provision | Emite una provisión en Borrador: el acto legal de crearla. El borrador se convierte en un documento certificado (estado Enviada) y se envía INMEDIATAMENTE para certificación fiscal (serie PROV). IRREVERSIBLE y legalmente vinculante según la ley francesa. MUESTRA SIEMPRE al usuario los detalles de la provisión y obtén su aprobación explícita antes de llamar con confirm:true. Sin confirm, devuelve una vista previa de lo que se certificará. | escritura, destructiva |
mark_provision_paid | Marca una provisión emitida (estado Enviada/Vencida) como Pagada. Una provisión pagada se convierte en un crédito del cliente que se puede deducir de la factura final de ese cliente con apply_provisions_to_invoice. | escritura |
list_available_provisions | Lista las provisiones PAGADAS (avances sur honoraires, anticipos) que aún no se han aplicado a una factura final: el crédito del cliente deducible. Sin matter_id, lista los anticipos independientes (sin asunto), que es el caso normal en Kema Invoice; con matter_id, lista los anticipos de ese asunto. Úsalo antes de apply_provisions_to_invoice. | lectura |
apply_provisions_to_invoice | Deduce una o más provisiones PAGADAS de una factura final en BORRADOR del mismo cliente (y del mismo asunto cuando hay uno vinculado). Actualiza advances_total y amount_due de la factura. Reversible mientras la factura siga en Borrador (remove_provision_from_invoice). | escritura |
remove_provision_from_invoice | Desvincula una provisión de una factura final en BORRADOR y recalcula su advances_total / amount_due. La provisión vuelve a estar disponible para ese asunto. | escritura |
Clientes (5)
| Herramienta | Qué hace | Acceso |
|---|---|---|
list_companies | Lista las empresas clientes del inquilino autenticado (nombre, correo electrónico, IVA/identificación fiscal, país). Útil para resolver un id de empresa antes de otras búsquedas. | lectura |
get_company | Obtiene una empresa cliente con el registro completo relevante para facturación: identidad legal, IVA/SIREN, dirección, datos de contacto y clasificación del perfil del cliente. | lectura |
create_company | Crea una empresa cliente para el inquilino. Se requiere un IVA/identificación fiscal más adelante para facturarla como B2B. | escritura |
update_company | Actualiza campos de una empresa cliente existente (nombre, información de contacto, dirección, número de IVA, SIREN). Solo cambian los campos proporcionados. Corregir el número de IVA / SIREN / dirección aquí suele ser necesario antes de que una factura para este cliente pueda certificarse. | escritura |
delete_company | Elimina de forma suave una empresa cliente. Bloqueado cuando aún hay contactos vinculados a ella. Llama con confirm:true para eliminar; sin ello, devuelve una vista previa. | escritura, destructiva |
Perfiles de cliente (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
get_invoice_client_profile | Valores predeterminados de facturación por empresa (condiciones de pago, canal de entrega, prefijo de factura personalizado). Devuelve {profile: null} cuando la empresa no tiene ninguno: los perfiles se crean de forma diferida. | lectura |
upsert_invoice_client_profile | Crear o actualizar los valores predeterminados de facturación de una empresa (condiciones de pago, canal de entrega, prefijo de factura). Estos valores predeterminados rellenan previamente futuras facturas para ese cliente. | escritura |
delete_invoice_client_profile | Eliminar los valores predeterminados de facturación de una empresa (la empresa en sí no se modifica). Llame con confirm:true para eliminar realmente; sin él, devuelve una vista previa. | escritura, destructivo |
Informes (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
get_revenue_summary | Agregar cifras de ingresos: cobrado en el período (por fecha de pago), pendiente actual y vencido (en un momento dado), documentos emitidos en el período, número de borradores y efecto neto de notas de crédito. Por defecto, el mes actual. | lectura |
get_settings | Instantánea de solo lectura de la configuración de facturación del inquilino: identidad legal, país y régimen fiscal, tipo de IVA y condiciones de pago predeterminados, correo de facturación e idioma de interfaz del llamante. La configuración solo se puede CAMBIAR desde la aplicación. | lectura |
list_mcp_activity | Registro de actividad de agente reciente del inquilino: una entrada por cada llamada exitosa a una herramienta MCP (nombre de la herramienta, número de factura relacionado cuando se conoce, marca de tiempo). Más recientes primero. | lectura |
Reglas de diseño que sigue el servidor: un título por herramienta, readOnlyHint en lecturas y un destructiveHint explícito en escrituras, una descripción en cada parámetro, un outputSchema y structuredContent en cada resultado. Los nombres de las herramientas están congelados: sus indicaciones y automatizaciones siguen funcionando entre versiones.
Una llamada rechazada (sin suscripción activa, cuota alcanzada) se devuelve como un resultado de herramienta escrito para el modelo, no como un error de transporte: el conector permanece conectado y sigue listando sus herramientas.
Pruébelo
Pídale a su agente, en su idioma:
- "Factura 3 días de consultoría a Dupont SARL a 800 € por día."
- "Lista mis facturas impagadas y marca FAC-2026-0412 como pagada."
- "Convierte el presupuesto DEV-2026-0031 en una factura y envíala."
Más en examples/prompts.md.
Cumplimiento y datos
- Las facturas se generan como Factur-X (PDF/A-3 con XML EN 16931 incrustado) y se transmiten a través de una plataforma acreditada, listas para el mandato de facturación electrónica francés.
- Los datos se alojan en la Unión Europea (base de datos y autenticación en AWS eu-north-1, Estocolmo; borde y almacenamiento en la UE). Los subprocesadores y los períodos de retención se enumeran en la política de privacidad.
- Cada llamada MCP se registra en la aplicación bajo Actividad del agente, para que siempre vea lo que hizo su agente.
- Términos · Aviso legal
Verificar una conexión
git clone https://github.com/Kema-Studio/kema-invoice-mcp && cd kema-invoice-mcp
npm install
npm run verify # opens the consent page, then lists the tools
Soporte
- Preguntas sobre su cuenta o sus facturas: soporte desde la aplicación (botón Ayuda) o hello@kema-studio.com.
- Errores del conector en sí (una herramienta que falla, un problema de esquema): abra un problema.
Licencia
El contenido de este repositorio (documentación, ejemplos, scripts) se publica bajo la Licencia MIT. El servicio Kema Invoice y su servidor son software propietario de Kema Studio.
Versión francesa
Kema Invoice es un software de facturación electrónica conforme que los agentes de IA controlan mediante el Model Context Protocol. Conecte el servidor MCP remoto a Claude, Cursor o cualquier cliente MCP, autorice una vez con OAuth 2.1, y su agente crea, emite, envía y sigue facturas, presupuestos y provisiones en lenguaje natural. Las facturas se producen en Factur-X (EN 16931) y se transmiten a través de una plataforma acreditada. Nada que instalar: el servidor responde en https://mcp.kema-studio.com/api/mcp.
Conectarse
| Cliente | Cómo |
|---|---|
| claude.ai / Claude Desktop | Configuración › Conectores › Añadir conector personalizado, pegar https://mcp.kema-studio.com/api/mcp, autorizar una vez. |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | Añadir examples/cursor-mcp.json a .cursor/mcp.json. |
| Otro cliente MCP | Transporte Streamable HTTP, OAuth 2.1 con PKCE y registro dinámico de cliente (RFC 7591). |
¿Aún no tiene cuenta? Cree una: prueba de 14 días con 10 facturas incluidas, un usuario, sin tarjeta bancaria. Luego una oferta única a 10 € sin IVA por usuario y mes, todas las funciones incluidas, sin compromiso.
Lo que su agente sabe hacer
Facturas (16)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_invoice | Crear una nueva factura en estado Borrador para una empresa, con líneas de detalle. La factura NO se envía ni se certifica: una persona la emite desde la aplicación (o use issue_invoice). El IVA se calcula automáticamente mediante reglas fiscales estrictas del lado del servidor (escenario + valores predeterminados): nunca pida al usuario una tasa de IVA. El escenario fiscal y la instantánea del cliente se congelan en la creación. | escritura |
issue_invoice | Emitir una factura en Borrador: el acto legal de CREAR la factura (el producto lo llama 'Créer la facture'; el antiguo concepto de 'enviar' está obsoleto). El borrador se convierte en una factura certificada e inmutable (estado Enviado, mostrado como 'Créée') y se envía INMEDIATAMENTE para certificación fiscal. IRREVERSIBLE y legalmente vinculante según la ley francesa: solo se anula con una nota de crédito. SIEMPRE muestre al usuario los detalles de la factura y obtenga su aprobación explícita antes de llamar con confirm:true. Sin confirm, devuelve una vista previa de lo que se certificará. | escritura, destructivo |
list_invoices | Listar las facturas del inquilino autenticado, más recientes primero. Admite filtrado por estado, tipo de documento y búsqueda de texto libre por número de factura o nombre de cliente, además de paginación. | lectura |
get_invoice | Obtener una sola factura por id, incluidas sus líneas de detalle, cliente y totales. Devuelve un error con forma de null si la factura no es visible para el llamante. | lectura |
get_invoice_pdf | Devolver una URL de descarga firmada temporal (1 hora) para el PDF de una factura. Funciona para cualquier documento visible para el llamante: las facturas importadas devuelven su archivo subido; las facturas emitidas en Kema Invoice (por la aplicación o un agente) se renderizan en el servidor con la marca del espacio de trabajo y, una vez certificadas, incrustan el XML Factur-X. Los borradores también se renderizan (marcados is_draft: true) pero aún no son documentos legales. | lectura |
update_invoice | Actualizar campos de una factura en Borrador (fechas, condiciones de pago, notas o reasignar la empresa). Solo las facturas en Borrador se pueden modificar: una factura Enviada/certificada es inmutable. | escritura |
delete_invoice | Eliminación suave de una factura en Borrador. Irreversible desde la vista del usuario. Llame con confirm:true para eliminar realmente; sin él, devuelve una vista previa de lo que se eliminaría. | escritura, destructivo |
cancel_invoice | Cancelar una factura no pagada (estado → Cancelada). Irreversible. Para una factura certificada (Enviada), la ley francesa generalmente requiere una nota de crédito (create_credit_note) en lugar de una cancelación simple. Llame con confirm:true para actuar; de lo contrario, devuelve una vista previa. | escritura, destructivo |
mark_invoice_paid | Marcar una factura Enviada o Vencida como Pagada. Opcionalmente, establezca la fecha de pago (por defecto, ahora). | escritura |
add_invoice_item | Añadir una línea de detalle a una factura en Borrador. Los totales se recalculan automáticamente. | escritura |
update_invoice_item | Actualizar una línea de detalle en una factura en Borrador. Los totales se recalculan automáticamente. Los ids de los artículos provienen de get_invoice o add_invoice_item. | escritura |
delete_invoice_item | Eliminar una línea de detalle de una factura en Borrador. Los totales se recalculan automáticamente. Los ids de los artículos provienen de get_invoice o add_invoice_item. Llame con confirm:true para eliminar; sin él, devuelve una vista previa del artículo. | escritura, destructivo |
reorder_invoice_items | Establecer el orden de visualización de las líneas de detalle de una factura. Pase el orden completo deseado: cada id de artículo con su display_order basado en 0. Los ids de los artículos provienen de get_invoice o add_invoice_item. | escritura |
update_invoice_matter | Adjuntar o desadjuntar el asunto (dossier) en una factura. Puramente organizativo: permitido incluso después de que la factura esté Enviada, pero no en una factura Cancelada. Pase matter_id null para desadjuntar. | escritura |
check_certification_status | Actualizar el estado de certificación fiscal de una factura emitida consultando al proveedor de certificación y conciliándolo en la base de datos. Use después de issue_invoice cuando certification_status sea 'processing' o parezca desactualizado. | escritura |
create_credit_note | Cancelar una factura Enviada o Pagada emitiendo una nota de crédito (avoir). La nota de crédito es un documento fiscal legal (certificado fiscalmente cuando el original fue certificado) y es INMUTABLE una vez creada. IRREVERSIBLE. SIEMPRE obtenga la aprobación explícita del usuario antes de llamar con confirm:true. Sin confirm, devuelve una vista previa. | escritura, destructivo |
Rectificación e importación (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
rectify_invoice | Crear una factura rectificativa (facture rectificative) para una factura Enviada o Pagada: una NUEVA factura en Borrador prellenada desde la original (mismo cliente, líneas de detalle copiadas a menos que se anulen) y legalmente vinculada a ella. La original se marca como Rectificada solo cuando se emite la rectificativa. Llame con confirm:true para crear; sin él, devuelve una vista previa. | escritura |
get_rectification_links | Para una factura, devolver la cadena de rectificación: la original que reemplaza (si es una rectificativa) y/o la rectificativa que la reemplazó (si fue rectificada). Ambos null cuando la factura no forma parte de una cadena. | lectura |
import_external_invoice | Importar una factura histórica/externa con su PROPIO número de factura (conservado textualmente), totales y estado, sin líneas de detalle. Use para migrar facturas pasadas emitidas fuera de Kema Invoice; NO para crear nuevas facturas (use create_invoice). | escritura |
Presupuestos (5)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_quote | Crear un presupuesto en Borrador (devis) para una empresa. Los presupuestos no son documentos fiscales: no hay certificación. Las fechas se establecen por defecto en el servidor (emisión hoy, vencimiento/válido +30 días). Requiere un id de asunto (dossier) al que pertenece el presupuesto. | escritura |
send_quote | Transicionar un presupuesto en Borrador a Enviado (el estado orientado al cliente). No hay certificación involucrada: los presupuestos son documentos comerciales. La validación B2B francesa (SIREN/IVA) se aplica cuando el inquilino es francés. | escritura, destructivo |
accept_quote | Marcar un presupuesto Enviado como Aceptado por el cliente. Continúe con convert_quote_to_invoice para facturarlo. | escritura, destructivo |
reject_quote | Marcar un presupuesto Enviado como Rechazado por el cliente. Esto termina el ciclo de vida del presupuesto. Llame con confirm:true para aplicar; sin él, devuelve una vista previa. | escritura, destructivo |
convert_quote_to_invoice | Crear una nueva factura en Borrador a partir de un presupuesto Aceptado (líneas de detalle copiadas, source_quote_id establecido para trazabilidad). La factura luego sigue el ciclo de vida normal (issue_invoice para hacerla legalmente vinculante). Llame con confirm:true para aplicar; sin él, devuelve una vista previa. | escritura |
Provisiones (6)
| Herramienta | Qué hace | Acceso |
|---|---|---|
create_provision | Crea un documento de provisión (avance sobre honorarios, retainer) en estado Borrador para una empresa, opcionalmente vinculado a un asunto. NO emitido ni certificado: use send_provision para la emisión legal. El IVA se calcula automáticamente mediante reglas fiscales estrictas del servidor: nunca pida al usuario una tasa de IVA. Las provisiones usan su propia serie de numeración PROV y, una vez pagadas, se convierten en un crédito del cliente deducible de la factura final (apply_provisions_to_invoice). | escritura |
send_provision | Emite una provisión en Borrador: el acto legal de crearla. El borrador se convierte en un documento certificado (estado Enviado) y se envía INMEDIATAMENTE para certificación fiscal (serie PROV). IRREVERSIBLE y legalmente vinculante según la ley francesa. SIEMPRE muestre al usuario los detalles de la provisión y obtenga su aprobación explícita antes de llamar con confirm:true. Sin confirm, devuelve una vista previa de lo que se certificará. | escritura, destructivo |
mark_provision_paid | Marca una provisión emitida (estado Enviado/Vencida) como Pagada. Una provisión pagada se convierte en un crédito del cliente que puede deducirse de la factura final de ese cliente con apply_provisions_to_invoice. | escritura |
list_available_provisions | Lista las provisiones PAGADAS (avances sobre honorarios, retainers) que aún no se han aplicado a una factura final: el crédito del cliente deducible. Sin matter_id, lista los retainers independientes (sin asunto), que es el caso normal en Kema Invoice; con matter_id, lista los retainers de ese asunto. Use antes de apply_provisions_to_invoice. | lectura |
apply_provisions_to_invoice | Deduce una o más provisiones PAGADAS de una factura final en BORRADOR del mismo cliente (y del mismo asunto cuando hay uno vinculado). Actualiza advances_total y amount_due de la factura. Reversible mientras la factura siga en Borrador (remove_provision_from_invoice). | escritura |
remove_provision_from_invoice | Desvincula una provisión de una factura final en BORRADOR y recalcula su advances_total / amount_due. La provisión vuelve a estar disponible para ese asunto. | escritura |
Clientes (5)
| Herramienta | Qué hace | Acceso |
|---|---|---|
list_companies | Lista las empresas clientes del tenant autenticado (nombre, correo, IVA/ID fiscal, país). Útil para resolver un ID de empresa antes de otras búsquedas. | lectura |
get_company | Obtiene una empresa cliente con el registro completo relevante para facturación: identidad legal, IVA/SIREN, dirección, datos de contacto y clasificación del perfil del cliente. | lectura |
create_company | Crea una empresa cliente para el tenant. Se requiere un ID de IVA/fiscal más adelante para facturarla como B2B. | escritura |
update_company | Actualiza campos de una empresa cliente existente (nombre, datos de contacto, dirección, número de IVA, SIREN). Solo cambian los campos proporcionados. Corregir el número de IVA / SIREN / dirección aquí suele ser necesario antes de que una factura para este cliente pueda certificarse. | escritura |
delete_company | Eliminación suave de una empresa cliente. Bloqueada cuando aún hay contactos vinculados a ella. Llame con confirm:true para eliminar; sin ello, devuelve una vista previa. | escritura, destructivo |
Perfiles de cliente (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
get_invoice_client_profile | Valores predeterminados de facturación por empresa (condiciones de pago, canal de entrega, prefijo de factura personalizado). Devuelve {profile: null} cuando la empresa no tiene ninguno: los perfiles se crean de forma diferida. | lectura |
upsert_invoice_client_profile | Crea o actualiza los valores predeterminados de facturación de una empresa (condiciones de pago, canal de entrega, prefijo de factura). Estos valores rellenan previamente futuras facturas para ese cliente. | escritura |
delete_invoice_client_profile | Elimina los valores predeterminados de facturación de una empresa (la empresa en sí no se modifica). Llame con confirm:true para eliminar realmente; sin ello, devuelve una vista previa. | escritura, destructivo |
Supervisión (3)
| Herramienta | Qué hace | Acceso |
|---|---|---|
get_revenue_summary | Agrega cifras de ingresos: cobrado en el período (por fecha de pago), pendiente actual y vencido (en un momento dado), documentos emitidos en el período, número de borradores y efecto neto de notas de crédito. Por defecto, el mes actual. | lectura |
get_settings | Instantánea de solo lectura de la configuración de facturación del tenant: identidad legal, país y régimen fiscal, tasa de IVA predeterminada y condiciones de pago, correo de facturación e idioma de interfaz del llamante. La configuración solo puede CAMBIARSE desde la aplicación. | lectura |
list_mcp_activity | Registro de actividad reciente del agente del tenant: una entrada por cada llamada exitosa de herramienta MCP (nombre de la herramienta, número de factura relacionado cuando se conoce, marca de tiempo). Más recientes primero. | lectura |
Cumplimiento y datos
Facturas Factur-X (PDF/A-3 con XML EN 16931) transmitidas a través de una plataforma aprobada; datos alojados en la Unión Europea (base y autenticación en AWS eu-north-1, Estocolmo); cada llamada MCP se registra en la aplicación, sección Actividad del agente. Política de privacidad · CGU · Aviso legal.
Soporte
Cuenta y facturas: desde la aplicación (botón Ayuda) o hello@kema-studio.com. Error del conector: abrir un issue.