Herramientas del servidor MCP

Acciones

• create_invoice_facturae Generar la factura en formato facturae PUT /{companyId}/invoices/{id}/facturae
• create_invoice_pdf Generar la factura en formato PDF PUT /{companyId}/invoices/{id}/pdf
• get_invoice Obtener una factura GET /{companyId}/invoices/{id}
• get_invoice_attachments Listar adjuntos de una factura de venta GET /{companyId}/invoices/{id}/attachments
• get_invoice_version Versión de la factura GET /{companyId}/invoices/{id}/versions/{versionId}
• list_invoice_versions Versiones de la factura GET /{companyId}/invoices/{id}/versions
• list_invoices Lista de facturas GET /{companyId}/invoices

Permisos

invoices:read

Descripción que recibe el modelo

Facturas de venta: listar, consultar, crear, modificar, registrar cobros, enviar por email, PDF, Facturae, sustitutivas de simplificadas, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_invoices_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_invoice_facturae (RO): Generar la factura en formato facturae - create_invoice_pdf (RO): Generar la factura en formato PDF - get_invoice (RO): Obtener una factura - get_invoice_attachments (RO): Listar adjuntos de una factura de venta - get_invoice_version (RO): Versión de la factura - list_invoice_versions (RO, paginada): Versiones de la factura - list_invoices (RO, paginada): Lista de facturas

Acciones

• add_invoice_attachments Vincular adjuntos a una factura POST /{companyId}/invoices/{id}/attachments
• create_invoice Crear factura POST /{companyId}/invoices
• create_invoice_payments Crear pagos para una factura POST /{companyId}/invoices/{id}/payments
• create_substitution_invoice Crear factura sustitutiva de simplificadas POST /{companyId}/invoices/substitution
• send_invoice Enviar factura por correo electrónico PUT /{companyId}/invoices/{id}/send
• update_invoice Actualizar factura PUT /{companyId}/invoices/{id}
• update_invoice_tags Actualizar etiquetas de factura PUT /{companyId}/invoices/{id}/tags

Permisos

invoices:write

Descripción que recibe el modelo

Facturas de venta: listar, consultar, crear, modificar, registrar cobros, enviar por email, PDF, Facturae, sustitutivas de simplificadas, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_invoices. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Emitir una factura (main.draft false), anularla (main.voided true) o subsanarla es un acto fiscal: con VeriFactu o TicketBAI activos se registra y se envía a Hacienda al momento y no se deshace. Crea siempre con draft true y emite solo si el usuario lo pide para esa factura, avisándole antes; anular no corrige ni borra. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_invoice_attachments: Vincular adjuntos a una factura - create_invoice: Crear factura - create_invoice_payments: Crear pagos para una factura - create_substitution_invoice: Crear factura sustitutiva de simplificadas - send_invoice: Enviar factura por correo electrónico - update_invoice: Actualizar factura - update_invoice_tags: Actualizar etiquetas de factura

Acciones

• create_estimate_pdf Generar el presupuesto en formato PDF PUT /{companyId}/estimates/{id}/pdf
• get_estimate Obtener un presupuesto GET /{companyId}/estimates/{id}
• get_estimate_attachments Listar adjuntos de un presupuesto GET /{companyId}/estimates/{id}/attachments
• get_estimate_version Versión de el presupuesto GET /{companyId}/estimates/{id}/versions/{versionId}
• list_estimate_versions Versiones de el presupuesto GET /{companyId}/estimates/{id}/versions
• list_estimates Lista de presupuestos GET /{companyId}/estimates

Permisos

estimates:read

Descripción que recibe el modelo

Presupuestos (también las facturas proforma, que son presupuestos con isProforma): listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_estimates_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_estimate_pdf (RO): Generar el presupuesto en formato PDF - get_estimate (RO): Obtener un presupuesto - get_estimate_attachments (RO): Listar adjuntos de un presupuesto - get_estimate_version (RO): Versión de el presupuesto - list_estimate_versions (RO, paginada): Versiones de el presupuesto - list_estimates (RO, paginada): Lista de presupuestos

Acciones

• add_estimate_attachments Vincular adjuntos a un presupuesto POST /{companyId}/estimates/{id}/attachments
• create_estimate Crear presupuesto POST /{companyId}/estimates
• send_estimate Enviar presupuesto por correo electrónico PUT /{companyId}/estimates/{id}/send
• update_estimate Actualizar presupuesto PUT /{companyId}/estimates/{id}
• update_estimate_tags Actualizar etiquetas de presupuesto PUT /{companyId}/estimates/{id}/tags

Permisos

estimates:write

Descripción que recibe el modelo

Presupuestos (también las facturas proforma, que son presupuestos con isProforma): listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_estimates. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_estimate_attachments: Vincular adjuntos a un presupuesto - create_estimate: Crear presupuesto - send_estimate: Enviar presupuesto por correo electrónico - update_estimate: Actualizar presupuesto - update_estimate_tags: Actualizar etiquetas de presupuesto

Acciones

• create_client_order_pdf Generar el pedido en formato PDF PUT /{companyId}/clientOrders/{id}/pdf
• get_client_order Obtener un pedido GET /{companyId}/clientOrders/{id}
• get_client_order_attachments Listar adjuntos de un pedido GET /{companyId}/clientOrders/{id}/attachments
• get_client_order_version Versión de el pedido GET /{companyId}/clientOrders/{id}/versions/{versionId}
• list_client_order_versions Versiones de el pedido GET /{companyId}/clientOrders/{id}/versions
• list_client_orders Lista de pedidos GET /{companyId}/clientOrders

Permisos

clientOrders:read

Descripción que recibe el modelo

Pedidos de cliente: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_client_orders_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_client_order_pdf (RO): Generar el pedido en formato PDF - get_client_order (RO): Obtener un pedido - get_client_order_attachments (RO): Listar adjuntos de un pedido - get_client_order_version (RO): Versión de el pedido - list_client_order_versions (RO, paginada): Versiones de el pedido - list_client_orders (RO, paginada): Lista de pedidos

Acciones

• add_client_order_attachments Vincular adjuntos a un pedido POST /{companyId}/clientOrders/{id}/attachments
• create_client_order Crear pedido POST /{companyId}/clientOrders
• send_client_order Enviar pedido por correo electrónico PUT /{companyId}/clientOrders/{id}/send
• update_client_order Actualizar pedido PUT /{companyId}/clientOrders/{id}
• update_client_order_tags Actualizar etiquetas de pedido PUT /{companyId}/clientOrders/{id}/tags

Permisos

clientOrders:write

Descripción que recibe el modelo

Pedidos de cliente: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_client_orders. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_client_order_attachments: Vincular adjuntos a un pedido - create_client_order: Crear pedido - send_client_order: Enviar pedido por correo electrónico - update_client_order: Actualizar pedido - update_client_order_tags: Actualizar etiquetas de pedido

Acciones

• create_delivery_note_pdf Generar el albarán en formato PDF PUT /{companyId}/deliveryNotes/{id}/pdf
• get_delivery_note Obtener un albarán GET /{companyId}/deliveryNotes/{id}
• get_delivery_note_attachments Listar adjuntos de un albarán GET /{companyId}/deliveryNotes/{id}/attachments
• get_delivery_note_version Versión de el albarán GET /{companyId}/deliveryNotes/{id}/versions/{versionId}
• list_delivery_note_versions Versiones de el albarán GET /{companyId}/deliveryNotes/{id}/versions
• list_delivery_notes Lista de albaranes GET /{companyId}/deliveryNotes

Permisos

deliveryNotes:read

Descripción que recibe el modelo

Albaranes: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_delivery_notes_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_delivery_note_pdf (RO): Generar el albarán en formato PDF - get_delivery_note (RO): Obtener un albarán - get_delivery_note_attachments (RO): Listar adjuntos de un albarán - get_delivery_note_version (RO): Versión de el albarán - list_delivery_note_versions (RO, paginada): Versiones de el albarán - list_delivery_notes (RO, paginada): Lista de albaranes

Acciones

• add_delivery_note_attachments Vincular adjuntos a un albarán POST /{companyId}/deliveryNotes/{id}/attachments
• create_delivery_note Crear albarán POST /{companyId}/deliveryNotes
• send_delivery_note Enviar albarán por correo electrónico PUT /{companyId}/deliveryNotes/{id}/send
• update_delivery_note Actualizar albarán PUT /{companyId}/deliveryNotes/{id}
• update_delivery_note_tags Actualizar etiquetas de albarán PUT /{companyId}/deliveryNotes/{id}/tags

Permisos

deliveryNotes:write

Descripción que recibe el modelo

Albaranes: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_delivery_notes. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_delivery_note_attachments: Vincular adjuntos a un albarán - create_delivery_note: Crear albarán - send_delivery_note: Enviar albarán por correo electrónico - update_delivery_note: Actualizar albarán - update_delivery_note_tags: Actualizar etiquetas de albarán

Acciones

• create_recurring_invoice_pdf Generar muestra de la factura de venta recurrente en formato PDF PUT /{companyId}/recurring/invoices/{id}/pdf
• get_recurring_invoice Obtener una factura de venta recurrente GET /{companyId}/recurring/invoices/{id}
• get_recurring_invoice_attachments Listar adjuntos de una factura recurrente GET /{companyId}/recurring/invoices/{id}/attachments
• list_recurring_invoices Lista de facturas de venta recurrentes GET /{companyId}/recurring/invoices

Permisos

invoices:read recurring:read

Descripción que recibe el modelo

Tareas recurrentes: facturas de venta recurrentes (plantillas que generan facturas periódicamente): listar, consultar, crear, modificar, PDF de muestra, etiquetas y adjuntos. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_automation_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_recurring_invoice_pdf (RO): Generar muestra de la factura de venta recurrente en formato PDF - get_recurring_invoice (RO): Obtener una factura de venta recurrente - get_recurring_invoice_attachments (RO): Listar adjuntos de una factura recurrente - list_recurring_invoices (RO, paginada): Lista de facturas de venta recurrentes

Acciones

• add_recurring_invoice_attachments Vincular adjuntos a una factura recurrente POST /{companyId}/recurring/invoices/{id}/attachments
• create_recurring_invoice Crea factura de venta recurrente POST /{companyId}/recurring/invoices
• update_recurring_invoice Actualizar factura recurrente PUT /{companyId}/recurring/invoices/{id}
• update_recurring_invoice_tags Actualizar etiquetas de factura de venta recurrente PUT /{companyId}/recurring/invoices/{id}/tags

Permisos

invoices:write recurring:write

Descripción que recibe el modelo

Tareas recurrentes: facturas de venta recurrentes (plantillas que generan facturas periódicamente): listar, consultar, crear, modificar, PDF de muestra, etiquetas y adjuntos. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_automation. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_recurring_invoice_attachments: Vincular adjuntos a una factura recurrente - create_recurring_invoice: Crea factura de venta recurrente - update_recurring_invoice: Actualizar factura recurrente - update_recurring_invoice_tags: Actualizar etiquetas de factura de venta recurrente

Parámetros

• companyId string

  Empresa sobre la que operar (ver whoami). Obligatorio si el usuario tiene más de una empresa; con una sola se resuelve automáticamente.

• url string obligatorio

  Enlace https público y directo al fichero (sin sesión ni contraseña), o URL data: con el contenido en base64 (data:application/pdf;base64,…; hasta 300 KB).

• filename string

  Nombre del fichero con extensión (factura-marzo.pdf). Obligatorio con data:; con https se toma del origen o del último segmento del enlace.

• contentType string

  Tipo MIME del fichero (application/pdf, image/jpeg…), solo si el origen no lo indica.

• title string

  Título del item en la bandeja; por defecto, el nombre del fichero.

• idempotencyKey string

  Clave de idempotencia (UUID recomendado): un reintento con la misma clave devuelve el mismo item en vez de crear otro, mientras siga en la bandeja.

Permisos

inbox:write

Operaciones de la API

POST /{companyId}/inbox

Descripción que recibe el modelo

Sube un fichero (factura de un proveedor, ticket o nómina: PDF, imagen JPEG, PNG, HEIC, WebP o TIFF, o XML; hasta 10 MB) a la bandeja de entrada de FacturaDirecta, que extrae sus datos en segundo plano. En url indica un enlace https público y directo al fichero (portales de proveedores, enlaces de descarga, carpetas públicas) o el contenido en una URL data: en base64 (hasta 300 KB; entonces filename es obligatorio). No sirven los enlaces privados de Drive, Dropbox o OneDrive ni las páginas que exigen sesión: la tool devuelve un error explicándolo. Un fichero adjuntado al chat no tiene enlace público: no inventes una URL ni una ruta local; pide un enlace público y directo o, como con uno grande o sin enlace, que el usuario lo suba a la bandeja de entrada (por web o por email) y sigue con list_inbox_items. Antes de llamar, muestra al usuario qué fichero vas a subir (enlace o nombre) y a qué empresa, y pide su confirmación explícita; envía idempotencyKey para que un reintento no cree dos items. Devuelve el item creado (id tas_…, status, title y el adjunto con su url pública) y el siguiente paso: consultar get_inbox_item hasta que status sea scanned, preparar el gasto con propose_bill o propose_ticket y crearlo con create_bill, o vincular el fichero a una factura de compra existente con add_bill_attachments e inboxIds.

Acciones

• get_bill Obtener una factura de compra o ticket GET /{companyId}/bills/{id}
• get_bill_attachments Listar adjuntos de una factura de compra o ticket GET /{companyId}/bills/{id}/attachments
• get_bill_version Versión de la factura de compra o el ticket GET /{companyId}/bills/{id}/versions/{versionId}
• list_bill_versions Versiones de la factura de compra o el ticket GET /{companyId}/bills/{id}/versions
• list_bills Lista de facturas de compra o tickets GET /{companyId}/bills

Permisos

bills:read

Descripción que recibe el modelo

Compras: facturas de compra y tickets de gasto: listar, consultar, crear, modificar, registrar pagos, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_bills_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_bill (RO): Obtener una factura de compra o ticket - get_bill_attachments (RO): Listar adjuntos de una factura de compra o ticket - get_bill_version (RO): Versión de la factura de compra o el ticket - list_bill_versions (RO, paginada): Versiones de la factura de compra o el ticket - list_bills (RO, paginada): Lista de facturas de compra o tickets

Acciones

• add_bill_attachments Vincular adjuntos a una factura de compra o ticket POST /{companyId}/bills/{id}/attachments
• create_bill Crear factura de compra o ticket POST /{companyId}/bills
• create_bill_payments Crear pagos para una factura de compra o ticket POST /{companyId}/bills/{id}/payments
• update_bill Actualizar factura de compra o ticket PUT /{companyId}/bills/{id}
• update_bill_tags Actualizar etiquetas de factura de compra o ticket PUT /{companyId}/bills/{id}/tags

Permisos

bills:write

Descripción que recibe el modelo

Compras: facturas de compra y tickets de gasto: listar, consultar, crear, modificar, registrar pagos, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_bills. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_bill_attachments: Vincular adjuntos a una factura de compra o ticket - create_bill: Crear factura de compra o ticket - create_bill_payments: Crear pagos para una factura de compra o ticket - update_bill: Actualizar factura de compra o ticket - update_bill_tags: Actualizar etiquetas de factura de compra o ticket

Acciones

• create_purchase_order_pdf Generar la orden de compra en formato PDF PUT /{companyId}/purchaseOrders/{id}/pdf
• get_purchase_order Obtener una orden de compra GET /{companyId}/purchaseOrders/{id}
• get_purchase_order_attachments Listar adjuntos de una orden de compra GET /{companyId}/purchaseOrders/{id}/attachments
• get_purchase_order_version Versión de la orden de compra GET /{companyId}/purchaseOrders/{id}/versions/{versionId}
• list_purchase_order_versions Versiones de la orden de compra GET /{companyId}/purchaseOrders/{id}/versions
• list_purchase_orders Lista de órdenes de compra GET /{companyId}/purchaseOrders

Permisos

purchaseOrders:read

Descripción que recibe el modelo

Órdenes de compra a proveedores: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_purchase_orders_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_purchase_order_pdf (RO): Generar la orden de compra en formato PDF - get_purchase_order (RO): Obtener una orden de compra - get_purchase_order_attachments (RO): Listar adjuntos de una orden de compra - get_purchase_order_version (RO): Versión de la orden de compra - list_purchase_order_versions (RO, paginada): Versiones de la orden de compra - list_purchase_orders (RO, paginada): Lista de órdenes de compra

Acciones

• add_purchase_order_attachments Vincular adjuntos a una orden de compra POST /{companyId}/purchaseOrders/{id}/attachments
• create_purchase_order Crear orden de compra POST /{companyId}/purchaseOrders
• send_purchase_order Enviar orden de compra por correo electrónico PUT /{companyId}/purchaseOrders/{id}/send
• update_purchase_order Actualizar orden de compra PUT /{companyId}/purchaseOrders/{id}
• update_purchase_order_tags Actualizar etiquetas de orden de compra PUT /{companyId}/purchaseOrders/{id}/tags

Permisos

purchaseOrders:write

Descripción que recibe el modelo

Órdenes de compra a proveedores: listar, consultar, crear, modificar, enviar por email, PDF, etiquetas, adjuntos y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_purchase_orders. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_purchase_order_attachments: Vincular adjuntos a una orden de compra - create_purchase_order: Crear orden de compra - send_purchase_order: Enviar orden de compra por correo electrónico - update_purchase_order: Actualizar orden de compra - update_purchase_order_tags: Actualizar etiquetas de orden de compra

Acciones

• get_inbox_item Detalle de un item de la bandeja GET /{companyId}/inbox/{id}
• list_inbox_items Lista de items en la bandeja de entrada GET /{companyId}/inbox
• propose_bill Propuesta de factura de compra desde un item de la bandeja POST /{companyId}/inbox/{id}/proposeBill
• propose_payroll Propuesta de nómina desde un item de la bandeja POST /{companyId}/inbox/{id}/proposePayroll
• propose_ticket Propuesta de ticket de compra desde un item de la bandeja POST /{companyId}/inbox/{id}/proposeTicket

Permisos

inbox:read

Descripción que recibe el modelo

Escaneos: la bandeja de entrada de documentos pendientes de procesar (OCR) y la subida de ficheros: listar, consultar, proponer gasto, ticket o nómina a partir de un documento, archivar. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool solo lee; las escrituras del dominio están en facturadirecta_inbox_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_inbox_item (RO): Detalle de un item de la bandeja - list_inbox_items (RO, paginada): Lista de items en la bandeja de entrada - propose_bill (RO): Propuesta de factura de compra desde un item de la bandeja - propose_payroll (RO): Propuesta de nómina desde un item de la bandeja - propose_ticket (RO): Propuesta de ticket de compra desde un item de la bandeja

Acciones

• delete_inbox_item Archivar un item de la bandeja DELETE /{companyId}/inbox/{id}

Permisos

inbox:write

Descripción que recibe el modelo

Escaneos: la bandeja de entrada de documentos pendientes de procesar (OCR) y la subida de ficheros: listar, consultar, proponer gasto, ticket o nómina a partir de un documento, archivar. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool escribe; las lecturas del dominio están en facturadirecta_inbox. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - delete_inbox_item: Archivar un item de la bandeja

Acciones

• get_contact Obtener un contacto GET /{companyId}/contacts/{id}
• get_contact_version Versión de el contacto GET /{companyId}/contacts/{id}/versions/{versionId}
• list_contact_versions Versiones de el contacto GET /{companyId}/contacts/{id}/versions
• list_contacts Lista de contactos GET /{companyId}/contacts

Permisos

contacts:read

Descripción que recibe el modelo

Contactos: clientes, proveedores y empleados: listar (con búsqueda por nombre, NIF o email), consultar, crear, modificar, etiquetas y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_contacts_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_contact (RO): Obtener un contacto - get_contact_version (RO): Versión de el contacto - list_contact_versions (RO, paginada): Versiones de el contacto - list_contacts (RO, paginada): Lista de contactos

Acciones

• create_contact Crear contacto POST /{companyId}/contacts
• update_contact Actualizar contacto PUT /{companyId}/contacts/{id}
• update_contact_tags Actualizar etiquetas de contacto PUT /{companyId}/contacts/{id}/tags

Permisos

contacts:write

Descripción que recibe el modelo

Contactos: clientes, proveedores y empleados: listar (con búsqueda por nombre, NIF o email), consultar, crear, modificar, etiquetas y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_contacts. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_contact: Crear contacto - update_contact: Actualizar contacto - update_contact_tags: Actualizar etiquetas de contacto

Acciones

• get_product Obtener un producto GET /{companyId}/products/{id}
• get_product_stock Stock de un producto GET /{companyId}/products/{id}/stock
• get_product_version Versión de el producto GET /{companyId}/products/{id}/versions/{versionId}
• list_product_stock_movements Movimientos de stock de un producto GET /{companyId}/products/{id}/stockMovements
• list_product_versions Versiones de el producto GET /{companyId}/products/{id}/versions
• list_products Lista de productos GET /{companyId}/products

Permisos

products:read

Descripción que recibe el modelo

Productos y servicios, con su stock y movimientos: listar (con búsqueda por nombre), consultar, crear, modificar, ajustar stock y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_products_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_product (RO): Obtener un producto - get_product_stock (RO): Stock de un producto - get_product_version (RO): Versión de el producto - list_product_stock_movements (RO, paginada): Movimientos de stock de un producto - list_product_versions (RO, paginada): Versiones de el producto - list_products (RO, paginada): Lista de productos

Acciones

• adjust_product_stock Ajuste manual de stock POST /{companyId}/products/{id}/stockAdjustments
• create_product Crear producto POST /{companyId}/products
• update_product Actualizar producto PUT /{companyId}/products/{id}

Permisos

products:write

Descripción que recibe el modelo

Productos y servicios, con su stock y movimientos: listar (con búsqueda por nombre), consultar, crear, modificar, ajustar stock y versiones. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_products. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - adjust_product_stock: Ajuste manual de stock - create_product: Crear producto - update_product: Actualizar producto

Acciones

• create_custom_field Crear campo personalizado POST /{companyId}/customFields
• create_payment_method Crear método de pago POST /{companyId}/paymentMethods
• delete_custom_field Borrar campo personalizado DELETE /{companyId}/customFields/{id}
• restore_custom_field Recuperar campo personalizado POST /{companyId}/customFields/{id}/restore
• update_custom_field Actualizar campo personalizado PUT /{companyId}/customFields/{id}
• update_payment_method Actualizar método de pago PUT /{companyId}/paymentMethods/{id}

Permisos

customFields:write paymentMethods:write

Descripción que recibe el modelo

Configuración de la empresa: su ficha y forma de trabajar (datos fiscales, moneda, borrador o definitivo, VeriFactu y TicketBAI, bloqueo contable, buzón de la bandeja y módulos del plan), series de numeración, impuestos de venta y de compra, plantillas de documento, campos personalizados y métodos de pago (los genéricos de la empresa y, con el filtro contact, los de cada cliente o proveedor). Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_settings. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_custom_field: Crear campo personalizado - create_payment_method: Crear método de pago - delete_custom_field: Borrar campo personalizado - restore_custom_field: Recuperar campo personalizado - update_custom_field: Actualizar campo personalizado - update_payment_method: Actualizar método de pago

Acciones

• get_bank Obtener un banco GET /{companyId}/banks/{id}
• get_bank_version Versión de el banco GET /{companyId}/banks/{id}/versions/{versionId}
• get_statement Obtener un extracto bancario GET /{companyId}/statements/{id}
• list_bank_versions Versiones de el banco GET /{companyId}/banks/{id}/versions
• list_banks Lista de bancos GET /{companyId}/banks
• list_statements Lista de extractos bancarios GET /{companyId}/statements

Permisos

banks:read statements:read

Descripción que recibe el modelo

Bancos y cuentas de tesorería, con su saldo contable, el saldo según la entidad, el estado del enlace y los movimientos pendientes (related), extractos bancarios y su conciliación con asientos contables. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_banks_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_bank (RO): Obtener un banco - get_bank_version (RO): Versión de el banco - get_statement (RO): Obtener un extracto bancario - list_bank_versions (RO, paginada): Versiones de el banco - list_banks (RO, paginada): Lista de bancos - list_statements (RO, paginada): Lista de extractos bancarios

Acciones

• reconcile_statement Conciliar extracto bancario con asiento contable existente PUT /{companyId}/statements/{id}/reconciliation
• reconcile_statement_with_new_transaction Conciliar extracto bancario creando un nuevo asiento contable POST /{companyId}/statements/{id}/reconciliation
• unreconcile_statement Desconciliar extracto bancario DELETE /{companyId}/statements/{id}/reconciliation

Permisos

statements:write

Descripción que recibe el modelo

Bancos y cuentas de tesorería, con su saldo contable, el saldo según la entidad, el estado del enlace y los movimientos pendientes (related), extractos bancarios y su conciliación con asientos contables. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_banks. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - reconcile_statement: Conciliar extracto bancario con asiento contable existente - reconcile_statement_with_new_transaction: Conciliar extracto bancario creando un nuevo asiento contable - unreconcile_statement: Desconciliar extracto bancario

Acciones

• get_payroll Obtener una nómina GET /{companyId}/payrolls/{id}
• get_payroll_attachments Listar adjuntos de una nómina GET /{companyId}/payrolls/{id}/attachments
• get_payroll_version Versión de la nómina GET /{companyId}/payrolls/{id}/versions/{versionId}
• list_payroll_versions Versiones de la nómina GET /{companyId}/payrolls/{id}/versions
• list_payrolls Lista de nóminas GET /{companyId}/payrolls

Permisos

payrolls:read

Descripción que recibe el modelo

Nóminas: listar, consultar, crear, modificar, registrar pagos, etiquetas, adjuntos y versiones. Contienen datos personales de los empleados: muéstralos solo si el usuario los pide. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_payrolls_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_payroll (RO): Obtener una nómina - get_payroll_attachments (RO): Listar adjuntos de una nómina - get_payroll_version (RO): Versión de la nómina - list_payroll_versions (RO, paginada): Versiones de la nómina - list_payrolls (RO, paginada): Lista de nóminas

Acciones

• add_payroll_attachments Vincular adjuntos a una nómina POST /{companyId}/payrolls/{id}/attachments
• create_payroll Crear nómina POST /{companyId}/payrolls
• create_payroll_payments Crear pagos para una nómina POST /{companyId}/payrolls/{id}/payments
• update_payroll Actualizar nómina PUT /{companyId}/payrolls/{id}
• update_payroll_tags Actualizar etiquetas de nómina PUT /{companyId}/payrolls/{id}/tags

Permisos

payrolls:write

Descripción que recibe el modelo

Nóminas: listar, consultar, crear, modificar, registrar pagos, etiquetas, adjuntos y versiones. Contienen datos personales de los empleados: muéstralos solo si el usuario los pide. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Esta tool escribe; las lecturas del dominio están en facturadirecta_payrolls. Antes de llamar a cualquier acción de esta tool, muestra al usuario un resumen de lo que vas a crear, modificar, enviar o borrar, incluida la empresa, y pide su confirmación explícita. Crea los documentos como borrador salvo que el usuario pida lo contrario. Envía idempotencyKey para que un reintento no repita la operación. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - add_payroll_attachments: Vincular adjuntos a una nómina - create_payroll: Crear nómina - create_payroll_payments: Crear pagos para una nómina - update_payroll: Actualizar nómina - update_payroll_tags: Actualizar etiquetas de nómina

Acciones

• list_journal Diario contable GET /{companyId}/journal

Permisos

accounting:read

Descripción que recibe el modelo

Asientos contables: el diario con filtros por fechas, cuenta y documento. Solo con el módulo de Contabilidad; para totales de ingresos, gastos y beneficio usa los informes. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - list_journal (RO, paginada): Diario contable

Acciones

• create_tax_declaration_aeat_file Generar el fichero de presentación de un modelo de impuestos PUT /{companyId}/taxDeclarations/{id}/aeatFile
• create_tax_declaration_pdf Generar el PDF de un modelo de impuestos PUT /{companyId}/taxDeclarations/{id}/pdf
• get_tax_declaration Obtener un modelo de impuestos GET /{companyId}/taxDeclarations/{id}
• get_tax_declaration_attachments Listar adjuntos de un modelo de impuestos GET /{companyId}/taxDeclarations/{id}/attachments
• list_tax_declarations Lista de modelos de impuestos GET /{companyId}/taxDeclarations

Permisos

taxDeclarations:read

Descripción que recibe el modelo

Impuestos: los modelos de la AEAT que la empresa ha generado y guardado (303, 111, 115, 130, 202, 180, 190, 347, 349 y 390): listar por modelo, ejercicio y periodo con su resultado, consultar uno con sus casillas y, en las informativas, sus registros por tercero, y descargar su PDF y su fichero de presentación. Solo lectura: la API no genera ni presenta modelos. Los tipos de IVA e IRPF que se aplican a los documentos están en la configuración (get_sales_taxes, get_purchases_taxes). Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - create_tax_declaration_aeat_file (RO): Generar el fichero de presentación de un modelo de impuestos - create_tax_declaration_pdf (RO): Generar el PDF de un modelo de impuestos - get_tax_declaration (RO): Obtener un modelo de impuestos - get_tax_declaration_attachments (RO): Listar adjuntos de un modelo de impuestos - list_tax_declarations (RO, paginada): Lista de modelos de impuestos

Acciones

• get_balance_sheet Balance de situación GET /{companyId}/reports/balanceSheet
• get_profit_loss Pérdidas y ganancias GET /{companyId}/reports/profitLoss
• get_results_summary Resumen de resultados GET /{companyId}/reports/resultsSummary
• list_results_detail Detalle del resumen de resultados GET /{companyId}/reports/resultsDetail
• list_trial_balance Sumas y saldos GET /{companyId}/reports/trialBalance

Permisos

accounting:read

Descripción que recibe el modelo

Informes, calculados en el servidor con las mismas cifras que la web: resumen de resultados (ingresos, gastos y beneficio) y sus documentos, pérdidas y ganancias, balance de situación y sumas y saldos. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_balance_sheet (RO): Balance de situación - get_profit_loss (RO): Pérdidas y ganancias - get_results_summary (RO): Resumen de resultados - list_results_detail (RO, paginada): Detalle del resumen de resultados - list_trial_balance (RO, paginada): Sumas y saldos

Operaciones de la API

GET /profile

Descripción que recibe el modelo

Devuelve el email del usuario autenticado y las empresas a las que tiene acceso, con su identificador (companyId) y nombre. Úsala al inicio de la conversación. No existe empresa activa en el servidor: si el usuario tiene más de una empresa, pregúntale con cuál trabajar e indica su companyId en cada llamada posterior; con una sola empresa no hace falta indicarlo. Para saber cómo trabaja la empresa (moneda, borrador o definitivo, bloqueo contable, módulos del plan, buzón de la bandeja) llama después a get_company_settings de facturadirecta_settings.

Acciones

• list_activity Registro de actividad de la empresa GET /{companyId}/activity

Permisos

activity:read

Descripción que recibe el modelo

Actividad: el registro de altas, modificaciones, borrados, envíos por email, accesos y tareas automáticas de la empresa, con quién y cuándo; paginación por cursor. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - list_activity (RO, paginada): Registro de actividad de la empresa

Acciones

• get_company_settings Ficha y forma de trabajar de la empresa GET /{companyId}/settings/company
• get_custom_field Obtener campo personalizado GET /{companyId}/customFields/{id}
• get_payment_method Obtener un método de pago GET /{companyId}/paymentMethods/{id}
• get_payment_method_version Versión de el método de pago GET /{companyId}/paymentMethods/{id}/versions/{versionId}
• get_purchases_taxes Lista de impuestos de compra disponibles GET /{companyId}/settings/taxes/purchases
• get_sales_taxes Lista de impuestos de venta disponibles GET /{companyId}/settings/taxes/sales
• get_series Lista de series de numeración GET /{companyId}/settings/series/{documentType}
• get_themes Lista de plantillas de documentos disponibles GET /{companyId}/settings/themes
• list_custom_fields Lista de campos personalizados GET /{companyId}/customFields
• list_payment_method_versions Versiones de el método de pago GET /{companyId}/paymentMethods/{id}/versions
• list_payment_methods Lista de métodos de pago GET /{companyId}/paymentMethods

Permisos

customFields:read paymentMethods:read settings:read

Descripción que recibe el modelo

Configuración de la empresa: su ficha y forma de trabajar (datos fiscales, moneda, borrador o definitivo, VeriFactu y TicketBAI, bloqueo contable, buzón de la bandeja y módulos del plan), series de numeración, impuestos de venta y de compra, plantillas de documento, campos personalizados y métodos de pago (los genéricos de la empresa y, con el filtro contact, los de cada cliente o proveedor). Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. Esta tool solo lee; las escrituras del dominio están en facturadirecta_settings_write. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - get_company_settings (RO): Ficha y forma de trabajar de la empresa - get_custom_field (RO): Obtener campo personalizado - get_payment_method (RO): Obtener un método de pago - get_payment_method_version (RO): Versión de el método de pago - get_purchases_taxes (RO): Lista de impuestos de compra disponibles - get_sales_taxes (RO): Lista de impuestos de venta disponibles - get_series (RO): Lista de series de numeración - get_themes (RO): Lista de plantillas de documentos disponibles - list_custom_fields (RO, paginada): Lista de campos personalizados - list_payment_method_versions (RO, paginada): Versiones de el método de pago - list_payment_methods (RO, paginada): Lista de métodos de pago

Parámetros

• query string obligatorio

  Texto a buscar (al menos dos caracteres): nombre, NIF o email de un contacto, número o referencia de un documento, concepto de una línea, nombre o referencia de un producto…

• companyId string

  Empresa sobre la que operar (ver whoami). Obligatorio si el usuario tiene más de una empresa; con una sola se resuelve automáticamente.

Permisos

bills:read clientOrders:read contacts:read deliveryNotes:read estimates:read invoices:read payrolls:read products:read purchaseOrders:read recurring:read

Operaciones de la API

GET /{companyId}/search

Descripción que recibe el modelo

Busca un texto en los datos de FacturaDirecta del usuario, con el mismo criterio que la búsqueda rápida de la aplicación, y devuelve resultados citables con su id, título y URL. Cubre contactos, facturas de venta, presupuestos, albaranes, pedidos, órdenes de compra, facturas de compra y tickets, nóminas, productos y facturas recurrentes, y busca por nombre, NIF o email del contacto, número o referencia del documento y texto de sus líneas y notas (todas las palabras, sin distinguir acentos ni mayúsculas; 'F-2026-12' encuentra 'F-2026-0012'). Úsala cuando el usuario mencione un cliente, proveedor, producto, concepto o número de documento y necesites localizarlo; después usa fetch con el id para leer el documento completo. Devuelve hasta 20 resultados repartidos entre tipos; para consultas por fechas, estados o importes, o para recorrer todos los resultados de un tipo, usa las acciones list_* con sus filtros (admiten el mismo parámetro search). Sin companyId busca en todas las empresas del usuario.

Parámetros

• id string obligatorio

  Identificador devuelto por search, con la forma tipo:empresa:id (p. ej. invoice:com_123:inv_456). Tipos: contact, invoice, estimate, deliveryNote, clientOrder, purchaseOrder, bill, payroll, product, recurring.

Permisos

bills:read clientOrders:read contacts:read deliveryNotes:read estimates:read invoices:read payrolls:read products:read purchaseOrders:read recurring:read

Operaciones de la API

GET /{companyId}/contacts/{id} GET /{companyId}/products/{id} GET /{companyId}/invoices/{id} GET /{companyId}/estimates/{id} GET /{companyId}/bills/{id} GET /{companyId}/deliveryNotes/{id} GET /{companyId}/clientOrders/{id} GET /{companyId}/purchaseOrders/{id} GET /{companyId}/payrolls/{id} GET /{companyId}/recurring/invoices/{id}

Descripción que recibe el modelo

Devuelve el contenido completo y legible de un resultado de search (contacto, factura de venta, presupuesto, albarán, pedido, orden de compra, factura de compra o ticket, nómina, producto o factura recurrente) junto con su URL para citarlo. Úsala después de search, con el id que devolvió; la empresa va codificada en el id.

Acciones

• query Consulta analítica POST /{companyId}/query

Permisos

accounting:read bills:read contacts:read invoices:read

Descripción que recibe el modelo

Consulta analítica: suma, cuenta y clasifica en una sola llamada las facturas de venta, las compras, sus líneas, los contactos o los apuntes del diario: mejores clientes o proveedores, productos más vendidos y su margen, facturas vencidas y cuánto suman, compras pendientes de pago, gastos por proveedor, ventas por provincia o país, días de cobro, comparativa con el periodo anterior y desglose por meses. Sustituye a paginar un listado y sumar. Llama antes a describe con la acción query: devuelve las fuentes, medidas, dimensiones y filtros admitidos y ejemplos. Tool gateway: llama con {"action": "...", "params": {...}}. Llama {"action": "describe", "params": {"action": "NOMBRE"}} para el contrato completo de una acción (parámetros, cuerpo, respuesta, ejemplos, permiso), o sin params para el índice del dominio. En las acciones con cuerpo, envía el objeto de describe.body.schema bajo params.body. Toda acción admite companyId (ver whoami); con una sola empresa se resuelve solo. ACCIONES (RO = solo lectura): - query (RO): Consulta analítica