Catálogo de tools
Las 457 tools del MCP de Factuarea agrupadas por dominio, con el scope que requiere cada una y su categoría de límite de peticiones.
El servidor MCP de Factuarea publica 457 tools en 29 dominios. Esta página es
la lista canónica; el esquema de entrada de cada tool se descubre en tiempo de
ejecución mediante tools/list. Cada tool se corresponde con la misma operación en la
Referencia de la REST API.
Cómo leer este catálogo
- Tool — el nombre de la tool MCP que invoca tu agente.
- Scope — el scope granular que debe tener la credencial para que la tool
aparezca en
tools/listy sea invocable. Consulta Scopes y permisos. - Category — el bucket de límite de peticiones al que pertenece la tool:
read,write,destructive,sendogenerate. Consulta Errores y límites de peticiones.
Una credencial solo ve las tools que cubren sus scopes. Una API key con el
super-scope * las ve las 457; una key más restringida o un token OAuth ve un subconjunto.
¹ Restringidas en OAuth (solo API key). 89 tools son accesibles únicamente con una
API key, nunca a través de una app OAuth de terceros: las 8 tools verifactu:write,
forget_delivery_note_signature (delivery_notes:gdpr_forget), las 20 tools de Pagos y pasarelas (los scopes
stripe_autoinvoicing:*, payouts:read e integration_events:* son scopes
granulares, solo API key), las 3 tools de Correos enviados y las 2 de registro de
peticiones (emails:read y developers:read inspeccionan el tráfico de tu
propia integración: son scopes de primera parte, nunca se conceden por
consentimiento de terceros), las 17 tools de Gestoría (companies:* y api_keys:*: gestionar sub-cuentas y
credenciales nunca se concede a terceros por consentimiento OAuth — incluye
get_consolidated_workforce), las 4 tools de escritura de cuenta
(account:write: crear, rotar o revocar API keys y actualizar la
personalización de la cuenta), las 33 tools de control horario cuyos scopes de
escritura/transición (time_entries:write, absences:write,
absences:transition, work_schedules:write) son granulares y solo API key,
fuera del catálogo de consentimiento OAuth (sus lecturas y employees:write sí
se conceden por OAuth) y delete_automation_rule (automations:delete se deja
fuera del catálogo de consentimiento OAuth a propósito; los otros tres scopes
del motor de automatizaciones —automations:read, automations:write y
automation_runs:read— sí se conceden). Por tanto, las apps OAuth alcanzan
368 de las 457 tools. Consulta la política de canales.
² Tope por lote — 200 ids por llamada. bulk_send_invoices,
bulk_send_quotes, bulk_send_proformas y bulk_send_delivery_notes admiten
como máximo 200 ids por llamada, el mismo tope que sus rutas REST hermanas
(POST /v1/{recurso}/bulk-send). Un lote mayor se rechaza antes de enviar
nada: no sale ningún correo ni se encola ningún trabajo. Divide el lote en
bloques de 200 y repite la llamada. El mensaje de error cita dos cifras y nada
más —el tope y lo que enviaste—, así que no devuelve ningún id del lote:
No puedes enviar más de 200 facturas por lote. Has enviado 201. Divide el lote en bloques de 200 como máximo y repite la llamada.
Dominios
Facturas
Facturas de venta: búsqueda, CRUD, rectificativas, ledger de pagos parciales, transiciones (paid/sent/void/annul), programación, operaciones masivas, recordatorios, enlaces públicos, PDFs y exportación a Excel. (44 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
can_annul_invoice | invoices:read | read |
check_invoice_simplified_eligibility | invoices:read | read |
export_invoices_excel | invoices:read | read |
find_invoice_by_external_id | invoices:read | read |
find_invoice_by_number | invoices:read | read |
get_available_quarters | invoices:read | read |
get_invoice | invoices:read | read |
get_invoice_activities | invoices:read | read |
get_invoice_correctives | invoices:read | read |
get_invoice_payment_receipt | pdfs:read | read |
get_invoice_pdf | pdfs:read | read |
get_invoice_public_link | invoices:read | read |
get_invoice_stats | invoices:read | read |
get_invoice_statuses | invoices:read | read |
list_invoice_payments | invoices:read | read |
list_payment_methods | invoices:read | read |
preview_invoice_reminder | invoices:read | read |
search_invoices | invoices:read | read |
annul_invoice | invoices:void | write |
assign_invoice_real_number | invoices:write | write |
bulk_change_invoice_status | invoices:write | write |
bulk_create_invoices | invoices:write | write |
bulk_delete_invoices | invoices:delete | destructive |
bulk_invoices_pdf_link | pdfs:read | generate |
bulk_send_invoices ² | invoices:send | send |
create_corrective_invoice | invoices:write | write |
create_invoice | invoices:write | write |
delete_invoice | invoices:delete | destructive |
duplicate_invoice | invoices:write | write |
mark_invoice_as_paid | invoices:write | write |
mark_invoice_as_sent | invoices:write | write |
mark_invoice_unsent | invoices:write | write |
quarterly_send_email | invoices:send | send |
register_invoice_payment | invoices:write | write |
reschedule_invoice | invoices:write | write |
revert_invoice_payment | invoices:write | write |
schedule_invoice | invoices:write | write |
send_invoice | invoices:send | send |
send_invoice_reminder | invoices:send | send |
substitute_simplified_invoice | invoices:write | write |
unschedule_invoice | invoices:write | write |
update_invoice | invoices:write | write |
update_invoice_public_link | invoices:write | write |
void_invoice | invoices:void | write |
Contactos
(26 tools)
Contactos fiscales con roles acumulables de cliente, proveedor y lead. Es la única superficie MCP pública para identidades de terceros. La plantilla CSV sigue siendo una descarga REST. Consulta Contactos.
| Tool | Scope | Categoría |
|---|---|---|
archive_contact | contacts:delete | destructive |
assign_contact_role | contacts:write | write |
bulk_archive_contacts | contacts:delete | destructive |
bulk_create_contacts | contacts:write | write |
bulk_change_contact_role_status | contacts:write | write |
bulk_delete_contacts | contacts:delete | destructive |
change_contact_role_status | contacts:write | write |
create_contact | contacts:write | write |
delete_contact | contacts:delete | destructive |
find_contact_by_external_id | contacts:read | read |
find_contact_by_tax_id | contacts:read | read |
get_contact | contacts:read | read |
get_contact_activities | contacts:read | read |
get_contact_stats | contacts:read | read |
get_contact_options | contacts:read | read |
import_contacts | contacts:write | write |
list_contacts | contacts:read | read |
preview_contacts_import | contacts:write | write |
remove_contact_role | contacts:delete | destructive |
restore_contact | contacts:write | destructive |
search_contacts | contacts:read | read |
update_bank_accounts | contacts:write | write |
update_contact | contacts:write | write |
update_customer_profile | contacts:write | write |
update_supplier_profile | contacts:write | write |
verify_contact_census | contacts:read | read |
Productos
Catálogo: búsqueda, CRUD, opciones/combinaciones configurables, ledger de stock, presentaciones, variantes, ofertas de proveedor, acciones masivas, analítica y media. (38 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
download_product_gallery_image | products:read | read |
download_product_video | products:read | read |
find_product_by_external_id | products:read | read |
find_product_by_sku | products:read | read |
get_product | products:read | read |
get_product_activities | products:read | read |
get_product_sales_analytics | products:read | read |
get_product_stats | products:read | read |
low_stock_report | products:read | read |
list_product_configurations | products:read | read |
list_product_options | products:read | read |
list_product_presentations | products:read | read |
list_product_stock_movements | products:read | read |
list_product_variants | products:read | read |
resolve_catalog_selection | products:read | read |
list_supplier_product_offers | products:read | read |
search_products | products:read | read |
bulk_change_product_status | products:write | write |
bulk_delete_products | products:delete | destructive |
bulk_update_stock | products:write | write |
create_product | products:write | write |
create_product_presentation | products:write | write |
create_product_variant | products:write | write |
create_supplier_product_offer | products:write | write |
delete_product | products:delete | destructive |
delete_product_gallery_image | products:delete | destructive |
delete_product_presentation | products:write | destructive |
delete_product_variant | products:write | destructive |
delete_product_video | products:delete | destructive |
delete_supplier_product_offer | products:write | destructive |
set_preferred_supplier_product_offer | products:write | write |
toggle_product_active | products:write | write |
update_product | products:write | write |
update_product_presentation | products:write | write |
update_product_variant | products:write | write |
update_supplier_product_offer | products:write | write |
upload_product_gallery_image | products:write | write |
upload_product_video | products:write | write |
Tarifas
Precios por cliente y documento: gestionar ítems activos/retirados, opciones compactas y resolver selecciones de catálogo configurable. (13 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_price_list | price_lists:read | read |
get_price_list_options | price_lists:read | read |
list_price_list_items | price_lists:read | read |
list_price_lists | price_lists:read | read |
resolve_catalog_price | price_lists:read | read |
resolve_many_catalog_prices | price_lists:read | read |
create_price_list | price_lists:write | write |
delete_price_list | price_lists:write | destructive |
delete_price_list_item | price_lists:write | destructive |
purge_retired_price_list_item | price_lists:write | destructive |
reassign_retired_price_list_item | price_lists:write | write |
update_price_list | price_lists:write | write |
upsert_price_list_item | price_lists:write | write |
Presupuestos
Presupuestos: búsqueda, CRUD, aceptar/rechazar, enviar, convertir a factura, operaciones masivas, búsqueda por ID externo, enlaces públicos y PDFs. (20 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_quote_by_external_id | quotes:read | read |
get_quote | quotes:read | read |
get_quote_pdf | pdfs:read | read |
get_quote_public_link | quotes:read | read |
get_quote_stats | quotes:read | read |
get_quote_statuses | quotes:read | read |
search_quotes | quotes:read | read |
accept_quote | quotes:transition | write |
bulk_change_quote_status | quotes:transition | write |
bulk_delete_quotes | quotes:delete | destructive |
bulk_quotes_pdf_link | pdfs:read | generate |
bulk_send_quotes ² | quotes:send | send |
convert_quote | quotes:transition | write |
create_quote | quotes:write | write |
delete_quote | quotes:delete | destructive |
duplicate_quote | quotes:write | write |
reject_quote | quotes:transition | write |
send_quote | quotes:send | send |
update_quote | quotes:write | write |
update_quote_public_link | quotes:write | write |
Facturas proforma
Proformas: búsqueda, CRUD, aceptar/rechazar, enviar, convertir, operaciones masivas, búsqueda por ID externo, enlaces públicos y PDFs. (20 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_proforma_by_external_id | proformas:read | read |
get_proforma | proformas:read | read |
get_proforma_pdf | pdfs:read | read |
get_proforma_public_link | proformas:read | read |
get_proforma_stats | proformas:read | read |
get_proforma_statuses | proformas:read | read |
search_proformas | proformas:read | read |
accept_proforma | proformas:transition | write |
bulk_change_proforma_status | proformas:transition | write |
bulk_delete_proformas | proformas:delete | destructive |
bulk_proformas_pdf_link | pdfs:read | generate |
bulk_send_proformas ² | proformas:send | send |
convert_proforma | proformas:transition | write |
create_proforma | proformas:write | write |
delete_proforma | proformas:delete | destructive |
duplicate_proforma | proformas:write | write |
reject_proforma | proformas:transition | write |
send_proforma | proformas:send | send |
update_proforma | proformas:write | write |
update_proforma_public_link | proformas:write | write |
Albaranes
Albaranes: búsqueda, CRUD, entregar/cancelar/firmar, convertir, enviar, operaciones masivas, búsqueda por ID externo, enlaces públicos, PDFs y borrado GDPR de la firma. (22 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_delivery_note_by_external_id | delivery_notes:read | read |
get_delivery_note | delivery_notes:read | read |
get_delivery_note_pdf | pdfs:read | read |
get_delivery_note_public_link | delivery_notes:read | read |
get_delivery_note_stats | delivery_notes:read | read |
get_delivery_note_statuses | delivery_notes:read | read |
search_delivery_notes | delivery_notes:read | read |
bulk_change_delivery_note_status | delivery_notes:transition | write |
bulk_delete_delivery_notes | delivery_notes:delete | destructive |
bulk_delivery_notes_pdf_link | pdfs:read | generate |
bulk_send_delivery_notes ² | delivery_notes:write | send |
cancel_delivery_note | delivery_notes:transition | write |
convert_delivery_note | delivery_notes:transition | write |
create_delivery_note | delivery_notes:write | write |
delete_delivery_note | delivery_notes:delete | destructive |
duplicate_delivery_note | delivery_notes:write | write |
forget_delivery_note_signature | delivery_notes:gdpr_forget ¹ | destructive |
mark_delivery_note_delivered | delivery_notes:transition | write |
send_delivery_note | delivery_notes:write | send |
sign_delivery_note | delivery_notes:transition | write |
update_delivery_note | delivery_notes:write | write |
update_delivery_note_public_link | delivery_notes:write | write |
Facturas de compra
Facturas de compra: búsqueda, CRUD, marcar como pagada, ledger de pagos parciales, operaciones masivas, listas de pendientes/vencidas, búsqueda por ID externo, adjuntos de archivo y recibos de pago. (18 tools)
create_purchase_invoice y update_purchase_invoice aceptan el contrato de línea medida (purchase_measurement, discount_percent, price_source, source_line_index); duplicar desde source_purchase_invoice_id exige además purchase_invoices:read. Consulta Líneas de compra medidas.
| Herramienta | Scope | Categoría |
|---|---|---|
download_purchase_invoice_file | purchase_invoices:read | read |
find_purchase_invoice_by_external_id | purchase_invoices:read | read |
get_purchase_invoice | purchase_invoices:read | read |
get_purchase_invoice_payment_receipt | pdfs:read | read |
get_purchase_invoice_stats | purchase_invoices:read | read |
list_overdue_purchase_invoices | purchase_invoices:read | read |
list_pending_purchase_invoices | purchase_invoices:read | read |
list_purchase_invoice_payments | purchase_invoices:read | read |
search_purchase_invoices | purchase_invoices:read | read |
attach_purchase_invoice_file | purchase_invoices:write | write |
bulk_change_purchase_invoice_status | purchase_invoices:transition | write |
bulk_delete_purchase_invoices | purchase_invoices:delete | destructive |
create_purchase_invoice | purchase_invoices:write | write |
delete_purchase_invoice | purchase_invoices:delete | destructive |
delete_purchase_invoice_file | purchase_invoices:write | write |
mark_purchase_invoice_paid | purchase_invoices:transition | write |
register_purchase_invoice_payment | purchase_invoices:transition | write |
update_purchase_invoice | purchase_invoices:write | write |
Facturas recurrentes
Plantillas recurrentes: búsqueda, CRUD, crear desde una factura, activar/pausar/reanudar/cancelar/saltar, previsualización, búsqueda por ID externo, logs y actividad. (17 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_recurring_invoice_by_external_id | recurring_invoices:read | read |
get_recurring_invoice | recurring_invoices:read | read |
get_recurring_invoice_stats | recurring_invoices:read | read |
list_recurring_invoice_activities | recurring_invoices:read | read |
list_recurring_invoice_logs | recurring_invoices:read | read |
preview_recurring_invoice | recurring_invoices:read | read |
search_recurring_invoices | recurring_invoices:read | read |
activate_recurring_invoice | recurring_invoices:transition | write |
bulk_delete_recurring_invoices | recurring_invoices:delete | destructive |
cancel_recurring_invoice | recurring_invoices:transition | write |
create_recurring_invoice | recurring_invoices:write | write |
create_recurring_invoice_from_invoice | recurring_invoices:write | write |
delete_recurring_invoice | recurring_invoices:delete | destructive |
pause_recurring_invoice | recurring_invoices:transition | write |
resume_recurring_invoice | recurring_invoices:transition | write |
skip_recurring_invoice | recurring_invoices:write | write |
update_recurring_invoice | recurring_invoices:write | write |
Series
Series de numeración (inmutables por continuidad fiscal): búsqueda, crear, archivar/desarchivar, marcar por defecto, arrancar las cuatro series por defecto de una empresa recién dada de alta, estadísticas y actividad. (12 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_series_by_code | series:read | read |
get_default_series_for_type | series:read | read |
get_series | series:read | read |
get_series_activities | series:read | read |
get_series_stats | series:read | read |
list_active_series | series:read | read |
search_series | series:read | read |
archive_series | series:write | write |
bootstrap_series | series:write | write |
create_series | series:write | write |
mark_series_as_default | series:write | write |
unarchive_series | series:write | write |
Impuestos
Tipos impositivos (catálogo global): búsqueda, CRUD-lite, valores por defecto, comprobaciones de uso, cálculos de impuesto/totales y el catálogo fiscal AEAT de solo lectura (regímenes, causas de exención, tipos de IRPF y los pares legales IVA ↔ recargo de equivalencia). (16 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
calculate_tax | taxes:read | read |
calculate_totals | taxes:read | read |
check_tax_in_use | taxes:read | read |
get_active_taxes | taxes:read | read |
get_tax | taxes:read | read |
get_tax_catalog | taxes:read | read |
get_tax_defaults_for_document | taxes:read | read |
get_tax_stats | taxes:read | read |
get_taxes_by_type | taxes:read | read |
get_taxes_for_purchases | taxes:read | read |
get_taxes_for_sales | taxes:read | read |
search_taxes | taxes:read | read |
create_tax | taxes:write | write |
set_tax_as_default | taxes:write | write |
set_tax_default_for_document | taxes:write | write |
toggle_tax_active | taxes:write | write |
VeriFactu
SIF de la AEAT: registros, eventos, validación de cadena, reintento, subsanación de registros rechazados, certificados, ajustes, declaración responsable y log de acceso a la AEAT. (27 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_verifactu_record_by_csv | verifactu:read | read |
find_verifactu_record_by_huella | verifactu:read | read |
find_verifactu_record_by_invoice_number | verifactu:read | read |
get_active_company_certificate | verifactu:read | read |
get_aeat_access_record | verifactu:read | read |
get_declaracion_responsable | verifactu:read | read |
get_declaracion_responsable_history | verifactu:read | read |
get_invoice_verifactu | verifactu:read | read |
get_verifactu_activities | verifactu:read | read |
get_verifactu_config | verifactu:read | read |
get_verifactu_event | verifactu:read | read |
get_verifactu_event_summary | verifactu:read | read |
get_verifactu_record | verifactu:read | read |
get_verifactu_stats | verifactu:read | read |
list_aeat_access_records | verifactu:read | read |
list_company_certificates | verifactu:read | read |
list_verifactu_events | verifactu:read | read |
search_verifactu_records | verifactu:read | read |
validate_verifactu_chain | verifactu:read | read |
activate_company_certificate | verifactu:write ¹ | write |
create_invoice_verifactu | verifactu:write ¹ | write |
retry_verifactu_event | verifactu:write ¹ | write |
retry_verifactu_record | verifactu:write ¹ | write |
revoke_company_certificate | verifactu:write ¹ | write |
subsanar_verifactu_record | verifactu:write ¹ | write |
update_verifactu_settings | verifactu:write ¹ | write |
upload_company_certificate | verifactu:write ¹ | write |
FacturaE (FACe)
Facturación electrónica B2G: descarga el XML FacturaE 3.2.2 de una factura y gestiona sus presentaciones a FACe (enviar, seguir, cancelar). (5 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_face_submission | facturae:read | read |
list_invoice_face_submissions | facturae:read | read |
cancel_face_submission | facturae:write | write |
get_invoice_facturae_link | facturae:read | generate |
send_invoice_to_face | facturae:write | write |
Informes fiscales
Declaraciones ante la AEAT calculadas a partir de tus propios datos de facturación: genera el Modelo 303, el 347 y el 130 como fichero posicional oficial, PDF o libro de revisión; previsualiza el desglose sin persistir nada; y lee el histórico de generaciones, sus estadísticas, su actividad y sus ficheros. (9 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
download_tax_report | tax_reports:read | read |
find_tax_report_by_period | tax_reports:read | read |
get_tax_report_activities | tax_reports:read | read |
get_tax_report_history | tax_reports:read | read |
get_tax_report_stats | tax_reports:read | read |
preview_tax_report | tax_reports:read | read |
generate_tax_report_130 | tax_reports:write | generate |
generate_tax_report_303 | tax_reports:write | generate |
generate_tax_report_347 | tax_reports:write | generate |
Ante la AEAT solo se presenta el txt_aeat; el PDF y el libro son material de
revisión construido con el mismo cálculo. Consulta
Informes fiscales.
Webhooks y eventos
Endpoints de webhook, entregas, rotación de secreto, ping/replay, eventos de prueba y el catálogo de eventos publicados. (13 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_event | events:read | read |
get_webhook_delivery | webhooks:read | read |
get_webhook_endpoint | webhooks:read | read |
list_events | events:read | read |
list_webhook_deliveries | webhooks:read | read |
search_webhook_endpoints | webhooks:read | read |
create_webhook_endpoint | webhooks:write | write |
delete_webhook_endpoint | webhooks:delete | write |
ping_webhook_endpoint | webhooks:write | write |
replay_webhook_delivery | webhooks:write | write |
rotate_webhook_secret | webhooks:write | write |
test_webhook_endpoint | webhooks:write | write |
update_webhook_endpoint | webhooks:write | write |
Automatizaciones
El motor de automatizaciones: reglas con la forma cuando → si → haz, las versiones inmutables de la definición de cada regla, el ensayo que dice qué haría una regla sin llegar a hacerlo, el historial de ejecuciones con sus pasos y sus motivos de descarte tipificados, el relanzamiento de un paso aparcado o de una ejecución entera, el catálogo de disparadores y acciones con los campos que expone cada disparador, y la cuota mensual de ejecuciones. Requiere el módulo automations. (18 tools)
replay_automation_run y replay_automation_run_step vuelven a ejecutar los
pasos de verdad: envían correos, entregan webhooks y llaman a terceros. No es
un reintento inocuo: confírmalo con la persona usuaria antes de invocarlas. El
trabajo se encola, así que la respuesta confirma que se aceptó, no que haya
terminado; comprueba el desenlace con get_automation_run o
list_automation_run_steps.
| Herramienta | Scope | Categoría |
|---|---|---|
dry_run_automation_rule | automations:read | read |
get_automation_catalog | automations:read | read |
get_automation_rule | automations:read | read |
get_automation_rule_version | automations:read | read |
get_automation_run | automation_runs:read | read |
get_automation_trigger_fields | automations:read | read |
get_automation_usage | automations:read | read |
list_automation_rule_versions | automations:read | read |
list_automation_rules | automations:read | read |
list_automation_run_steps | automation_runs:read | read |
list_automation_runs | automation_runs:read | read |
activate_automation_rule | automations:write | write |
create_automation_rule | automations:write | write |
delete_automation_rule | automations:delete ¹ | destructive |
pause_automation_rule | automations:write | write |
replay_automation_run | automations:write | write |
replay_automation_run_step | automations:write | write |
update_automation_rule | automations:write | write |
Cuenta
Identidad fiscal y personalización de la cuenta: verifica el par nombre + NIF registrado de la empresa contra el censo de la AEAT, consulta plantillas de personalización y actualiza la personalización de la cuenta. (4 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_account_billing | account:read | read |
get_account_personalization_templates | account:read | read |
update_account_personalization | account:write ¹ | write |
verify_account_census | account:read | write |
API keys
API keys self-service de tu propio tenant: listar, crear, consultar, rotar el secreto y revocar. El secreto se devuelve una sola vez, al crear y al rotar. (5 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_api_key | account:read | read |
list_api_keys | account:read | read |
create_api_key | account:write ¹ | write |
revoke_api_key | account:write ¹ | write |
rotate_api_key_secret | account:write ¹ | write |
Gestoría
Modo gestoría: gestiona las empresas hijas del tenant maestro y sus child API keys — crear/listar/consultar/actualizar/eliminar, activar/desactivar, previsualización del coste por asiento, estado de aprovisionamiento, API keys por empresa y un resumen consolidado del cumplimiento horario de las empresas hijas. (17 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_company | companies:read ¹ | read |
get_company_api_key | api_keys:read ¹ | read |
get_company_creation_status | companies:read ¹ | read |
get_company_seat_charge_preview | companies:read ¹ | read |
get_consolidated_workforce | companies:read ¹ | read |
list_companies | companies:read ¹ | read |
list_company_api_keys | api_keys:read ¹ | read |
activate_companies | companies:write ¹ | write |
activate_company | companies:write ¹ | write |
create_company | companies:write ¹ | write |
create_company_api_key | api_keys:write ¹ | write |
deactivate_company | companies:write ¹ | write |
delete_company | companies:delete ¹ | write |
revoke_company_api_key | api_keys:write ¹ | write |
rotate_company_api_key_secret | api_keys:write ¹ | write |
update_company | companies:write ¹ | write |
verify_company_creation | companies:write ¹ | write |
Pagos y pasarelas
Integraciones de pagos y tiendas: facturación automática de Stripe, cuentas conectadas, liquidaciones, bandeja de eventos, gestión y diagnóstico de tiendas WooCommerce y Shopify. Estas herramientas solo admiten API key. La disponibilidad también depende de los módulos de la empresa y de la configuración del proveedor. (20 tools)
replay_integrations_event tiene efecto fiscal real. Si la causa que impidió
facturar ya está resuelta, reprocesar un evento parqueado puede emitir una
factura de verdad, con su número de serie y su alta en VeriFactu. No es un
reintento inocuo: confírmalo con la persona usuaria antes de invocarla. No
duplica facturas: el reproceso vuelve a pasar por la misma comprobación de
idempotencia del intento original.
| Herramienta | Scope | Categoría |
|---|---|---|
get_integrations_event | integration_events:read ¹ | read |
get_payout | payouts:read ¹ | read |
get_stripe_autoinvoicing_config | stripe_autoinvoicing:read ¹ | read |
get_stripe_connected_account | stripe_autoinvoicing:read ¹ | read |
list_integrations_events | integration_events:read ¹ | read |
list_stripe_autoinvoiced_correctives | stripe_autoinvoicing:read ¹ | read |
list_stripe_autoinvoiced_payments | stripe_autoinvoicing:read ¹ | read |
list_stripe_connected_accounts | stripe_autoinvoicing:read ¹ | read |
search_payouts | payouts:read ¹ | read |
disconnect_stripe_connected_account | stripe_autoinvoicing:write ¹ | write |
replay_integrations_event | integration_events:write ¹ | write |
update_stripe_autoinvoicing_config | stripe_autoinvoicing:write ¹ | write |
update_stripe_connected_account | stripe_autoinvoicing:write ¹ | write |
list_stores | stores:read ¹ | read |
get_store | stores:read ¹ | read |
connect_store | stores:write ¹ | write |
update_store | stores:write ¹ | write |
disconnect_store | stores:write ¹ | write |
test_woocommerce_store_connection | woocommerce_store:write ¹ | write |
test_shopify_store_connection | shopify_store:write ¹ | write |
Correos enviados
Registro de correos enviados: lista los correos que Factuarea ha enviado en nombre de la empresa (facturas, presupuestos, albaranes, recordatorios de pago), consulta uno por su id y resume de una sola vez cómo acabó el envío de un lote de hasta 100 documentos. Úsalo para responder «¿se envió el correo de esta factura?» y para investigar envíos fallidos. (3 tools)
El estado describe la entrega al servidor SMTP saliente, no la entrega
real. sent significa que el servidor de correo saliente aceptó el mensaje:
aun así puede rebotar o acabar en spam sin que Factuarea se entere. No existen
los estados delivered, bounced ni opened; queued, sending, sent y
failed son los únicos. Nunca afirmes que la persona destinataria lo recibió,
lo abrió o lo leyó.
| Herramienta | Scope | Categoría |
|---|---|---|
get_emails | emails:read ¹ | read |
get_emails_indicators | emails:read ¹ | read |
list_emails | emails:read ¹ | read |
Registro de peticiones a la API
El tráfico de tu propia integración contra la API pública v1 en los últimos 30 días: lista las llamadas con su método, ruta, código de estado, duración, prefijo de API key y entorno, con filtros por solo errores o por cualquiera de esos campos, y consulta una concreta por su request_id, el identificador opaco que la API devuelve en la cabecera de cada respuesta. Úsalo para depurar una integración: qué llamó, cuándo, con qué código de estado y cuánto tardó. Las cabeceras, el cuerpo y la query string no se almacenan y nunca se devuelven. (2 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_developers_request_logs | developers:read ¹ | read |
list_developers_request_logs | developers:read ¹ | read |
Empleados
Plantilla de personal: búsqueda, alta/edición/baja/reactivación, estadísticas y el ciclo de invitaciones (enviar/reenviar/cancelar y listar invitaciones de empleado). Requiere el módulo control_horario. (12 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_employee_by_external_id | employees:read | read |
get_employee | employees:read | read |
get_employee_stats | employees:read | read |
list_employee_invitations | employees:read | read |
search_employees | employees:read | read |
cancel_employee_invitation | employees:write | write |
create_employee | employees:write | write |
deactivate_employee | employees:write | write |
reactivate_employee | employees:write | write |
resend_employee_invitation | employees:write | write |
send_employee_invitation | employees:write | write |
update_employee | employees:write | write |
Asientos de empleado
Facturación del add-on de asientos: la suscripción de asientos por contrato — previsualizar y consultar el cargo y la facturación del asiento, suscribir, cambiar la cantidad de asientos y cancelar el add-on. Requiere el módulo control_horario. (5 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_employee_seat_billing | employees:read | read |
preview_employee_seat_charge | employees:read | read |
cancel_employee_seat_addon | employees:write | write |
change_employee_seat_quantity | employees:write | write |
subscribe_employee_seat_addon | employees:write | write |
Horarios de trabajo
Horarios de trabajo semanales y sus asignaciones: búsqueda, CRUD, archivar/desarchivar, asignar/desasignar a empleados y consultar el horario efectivo de un empleado. Requiere el módulo control_horario. (11 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_employee_work_schedule | work_schedules:read | read |
get_work_schedule | work_schedules:read | read |
get_work_schedule_stats | work_schedules:read | read |
list_work_schedule_assignments | work_schedules:read | read |
search_work_schedules | work_schedules:read | read |
archive_work_schedule | work_schedules:write ¹ | write |
assign_work_schedule | work_schedules:write ¹ | write |
create_work_schedule | work_schedules:write ¹ | write |
unarchive_work_schedule | work_schedules:write ¹ | write |
unassign_work_schedule | work_schedules:write ¹ | write |
update_work_schedule | work_schedules:write ¹ | write |
Control horario
Registro de jornada (RD-ley 8/2019): fichar entrada/salida con pausas, entradas manuales, el flujo de correcciones de fichaje, saldos y hojas de horas mensuales, el cierre mensual inalterable del registro (cerrar/reabrir/sellar, firma, validación de cadena) y sus exportaciones, además de las exportaciones de nómina. Requiere el módulo control_horario. (29 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
export_closed_register | time_entries:read | read |
get_current_time_entry_session | time_entries:read | read |
get_employee_time_balance | time_entries:read | read |
get_monthly_close_report | time_entries:read | read |
get_monthly_register_signature | time_entries:read | read |
get_monthly_time_record_close | time_entries:read | read |
get_monthly_time_sheet | time_entries:read | read |
get_team_time_balance_summary | time_entries:read | read |
get_time_correction | time_entries:read | read |
get_time_entry | time_entries:read | read |
get_time_tracking_settings | time_entries:read | read |
search_monthly_time_record_closes | time_entries:read | read |
search_time_corrections | time_entries:read | read |
search_time_entries | time_entries:read | read |
validate_time_record_chain | time_entries:read | read |
export_payroll | payroll_exports:read | read |
list_payroll_export_formats | payroll_exports:read | read |
approve_time_correction | time_entries:write ¹ | write |
clock_in | time_entries:write ¹ | write |
clock_out | time_entries:write ¹ | write |
close_monthly_time_record | time_entries:write ¹ | write |
pause_time_entry | time_entries:write ¹ | write |
record_manual_time_entry | time_entries:write ¹ | write |
reject_time_correction | time_entries:write ¹ | write |
reopen_monthly_time_record | time_entries:write ¹ | write |
request_time_correction | time_entries:write ¹ | write |
resume_time_entry | time_entries:write ¹ | write |
seal_monthly_time_record | time_entries:write ¹ | write |
update_time_tracking_settings | time_entries:write ¹ | write |
Ausencias
Ausencias: tipos, políticas (con configuración de carryover y asignaciones), solicitudes (crear/aprobar/rechazar/cancelar), saldos y el calendario de ausencias del equipo. Requiere el módulo control_horario. (25 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_absence_balance | absences:read | read |
get_absence_calendar | absences:read | read |
get_absence_policy | absences:read | read |
get_absence_request | absences:read | read |
get_absence_type | absences:read | read |
list_absence_policy_assignments | absences:read | read |
search_absence_balances | absences:read | read |
search_absence_policies | absences:read | read |
search_absence_requests | absences:read | read |
search_absence_types | absences:read | read |
archive_absence_policy | absences:write ¹ | write |
archive_absence_type | absences:write ¹ | write |
assign_absence_policy | absences:write ¹ | write |
configure_absence_policy_carryover | absences:write ¹ | write |
create_absence_policy | absences:write ¹ | write |
create_absence_request | absences:write ¹ | write |
create_absence_type | absences:write ¹ | write |
unarchive_absence_policy | absences:write ¹ | write |
unarchive_absence_type | absences:write ¹ | write |
unassign_absence_policy | absences:write ¹ | write |
update_absence_policy | absences:write ¹ | write |
update_absence_type | absences:write ¹ | write |
approve_absence_request | absences:transition ¹ | write |
cancel_absence_request | absences:transition ¹ | write |
reject_absence_request | absences:transition ¹ | write |
Presencia
Presencia: el panel de presencia en vivo y el estado de presencia por empleado y diario. Requiere el módulo control_horario. (3 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_employee_presence | presence:read | read |
get_live_presence | presence:read | read |
list_daily_presence | presence:read | read |
Festivos
Festivos: consultar el calendario de festivos de la empresa y resolver los festivos aplicables a la región (CCAA) de un empleado. Requiere el módulo control_horario. (3 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_holiday | holidays:read | read |
list_holidays | holidays:read | read |
resolve_applicable_holidays | holidays:read | read |