Tool catalog
All 457 Factuarea MCP tools grouped by domain, with the scope each one requires and its rate-limit category.
The Factuarea MCP server publishes 457 tools across 29 domains. This page is
the canonical list; each tool's input schema is discoverable at runtime via
tools/list. Every tool maps to the same operation in the
REST API Reference.
How to read this catalog
- Tool — the MCP tool name your agent calls.
- Scope — the fine-grained scope the credential must hold for the tool to
appear in
tools/listand to be invocable. See Scopes & permissions. - Category — the rate-limit bucket the tool falls into:
read,write,destructive,sendorgenerate. See Errors & rate limits.
A credential only sees the tools its scopes cover. An API key with the
super-scope * sees all 457; a narrower key or an OAuth token sees a subset.
¹ OAuth-restricted (API key only). 89 tools are reachable only with an
API key, never through a third-party OAuth app: the 8 verifactu:write tools,
forget_delivery_note_signature (delivery_notes:gdpr_forget), the 13 Payments & gateways tools (the
stripe_autoinvoicing:*, payouts:read and integration_events:* scopes are
fine-grained, API-key-only scopes), the 3 Emails tools and the 2 API-request-log
tools (emails:read and developers:read inspect your own integration's
traffic — first-party scopes, never granted by third-party consent), the 17
Managed-companies tools (companies:* and
api_keys:* are first-party only, never granted by third-party consent —
this includes get_consolidated_workforce), the 4 account-write self-service
tools (account:write — creating, rotating or revoking API keys and updating
account personalization), the 33 workforce control-horario tools whose
write/transition scopes (time_entries:write, absences:write,
absences:transition, work_schedules:write) are fine-grained, API-key-only
scopes not in the OAuth consent catalog (their read counterparts and
employees:write are OAuth-grantable) and delete_automation_rule
(automations:delete is deliberately kept out of the OAuth consent catalog;
the automation engine's other three scopes — automations:read,
automations:write and automation_runs:read — are grantable). OAuth apps therefore reach
368 of the 457 tools. See the
channel policy.
² Batch size limit — 200 ids per call. bulk_send_invoices,
bulk_send_quotes, bulk_send_proformas and bulk_send_delivery_notes
accept at most 200 ids per call — the same limit as their REST
counterparts (POST /v1/{resource}/bulk-send). A larger batch is rejected
before anything is sent: no email goes out and no job is queued. Split the
batch into blocks of 200 and repeat the call. The error message is returned in
Spanish, like every other API message, and names two numbers and nothing
else — the limit and what you sent — so no id of the batch is echoed back:
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.
Domains
Invoices
Sales invoices: search, CRUD, correctives, partial-payment ledger, transitions (paid/sent/void/annul), scheduling, bulk operations, reminders, public links, PDFs and Excel export. (44 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Contacts
(26 tools)
Fiscal contacts with cumulative customer, supplier and lead roles. This is the only public MCP surface for third-party identities. The CSV template remains a REST download. See Contacts.
| Tool | Scope | Category |
|---|---|---|
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 |
Products
Catalog: search, CRUD, configurable options/combinations, stock ledger, presentations, variants, supplier offers, bulk actions, analytics and media. (38 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Price lists
Customer and document pricing: manage active/retired items, compact selector options and resolve configurable catalog selections. (13 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Quotes
Quotes: search, CRUD, accept/reject, send, convert to invoice, bulk operations, lookup by external ID, public links and PDFs. (20 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Pro-forma invoices
Pro-formas: search, CRUD, accept/reject, send, convert, bulk operations, lookup by external ID, public links and PDFs. (20 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Delivery notes
Delivery notes: search, CRUD, deliver/cancel/sign, convert, send, bulk operations, lookup by external ID, public links, PDFs and GDPR signature erasure. (22 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Purchase invoices
Vendor bills: search, CRUD, mark paid, partial-payment ledger, bulk operations, pending/overdue lists, lookup by external ID, file attachments and payment receipts. (18 tools)
create_purchase_invoice and update_purchase_invoice accept the measured-line contract (purchase_measurement, discount_percent, price_source, source_line_index); duplicating from source_purchase_invoice_id also requires purchase_invoices:read. See Measured purchase lines.
| Tool | Scope | Category |
|---|---|---|
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 |
Recurring invoices
Recurring templates: search, CRUD, create from an invoice, activate/pause/resume/cancel/skip, preview, lookup by external ID, logs and activity. (17 tools)
| Tool | Scope | Category |
|---|---|---|
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
Numbering series (immutable for fiscal continuity): search, create, archive/unarchive, set default, bootstrap the four default series of a brand-new company, stats and activity. (12 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Taxes
Tax rates (global catalog): search, CRUD-lite, defaults, in-use checks, tax/total calculations and the read-only AEAT tax catalog (regimes, exemption causes, IRPF rates and the legal VAT ↔ equivalence-surcharge pairs). (16 tools)
| Tool | Scope | Category |
|---|---|---|
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
AEAT SIF: records, events, chain validation, retry, subsanación of rejected records, certificates, settings, responsible declaration and AEAT access log. (27 tools)
| Tool | Scope | Category |
|---|---|---|
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)
B2G electronic invoicing: download the FacturaE 3.2.2 XML of an invoice and manage its FACe submissions (submit, track, cancel). (5 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Tax reports
AEAT filings computed from your own invoicing data: generate Modelo 303, 347 and 130 as the official positional file, a PDF or a review workbook; preview the breakdown without persisting anything; and read the generation history, stats, activity and files. (9 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Only txt_aeat is filed with the AEAT; the PDF and the workbook are review
material built from the same calculation. See
Tax reports.
Webhooks & events
Webhook endpoints, deliveries, secret rotation, ping/replay, test events, and the published event catalog. (13 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Automations
The automation engine: rules in the when → if → do shape, the immutable versions of each rule's definition, the dry run that reports what a rule would do without doing it, the run history with its steps and their typed discard reasons, replay of a parked step or of a whole run, the trigger/action catalog with the fields each trigger exposes, and the monthly execution quota. Gated by the automations module. (18 tools)
replay_automation_run and replay_automation_run_step run the steps for
real: they send emails, deliver webhooks and call third parties. This is not
a harmless retry — confirm with the user before calling them. The work is
queued, so the response confirms it was accepted, not that it finished: check
the outcome with get_automation_run or list_automation_run_steps.
| Tool | Scope | Category |
|---|---|---|
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 |
Account
Account fiscal identity and personalization: verify the company's registered name + NIF against the AEAT census, read personalization templates and update account personalization. (4 tools)
| Tool | Scope | Category |
|---|---|---|
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
Self-service API keys for your own tenant: list, create, get, rotate the secret and revoke. The secret is returned once, at creation and rotation. (5 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Managed companies
Accountant (gestoría) mode: manage the master tenant's child companies and their child API keys — create/list/show/update/delete, activate/deactivate, seat-charge preview, provisioning status, per-company API keys, and a consolidated workforce-compliance summary across the child companies. (17 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Payments & gateways
Payment and store integrations: Stripe auto-invoicing, connected accounts, payouts, the integration event inbox, WooCommerce and Shopify store management and diagnostics. These tools are API-key-only. Availability also depends on the company’s modules and provider configuration. (20 tools)
replay_integrations_event has a real fiscal effect. If the cause that blocked
invoicing is now resolved, replaying a parked event can issue an actual
invoice, with its series number and its VeriFactu submission. It is not a
harmless retry: confirm with the user before calling it. It does not duplicate
invoices — the replay goes through the same idempotency check as the original
attempt.
| Tool | Scope | Category |
|---|---|---|
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 |
Emails
Sent-email log: list the emails Factuarea sent on the company's behalf (invoices, quotes, delivery notes, payment reminders), read one by its id, and summarise the outcome for a batch of up to 100 documents in a single call. Use it to answer "did the email for this invoice go out?" and to investigate failed sends. (3 tools)
The status describes the hand-off to the outgoing SMTP server, not actual
delivery. sent means the outgoing mail server accepted the message — it can
still bounce or land in spam without Factuarea ever knowing. There is no
delivered, bounced or opened state: queued, sending, sent and
failed are the only ones. Never state that the recipient received, opened or
read the message.
| Tool | Scope | Category |
|---|---|---|
get_emails | emails:read ¹ | read |
get_emails_indicators | emails:read ¹ | read |
list_emails | emails:read ¹ | read |
API request logs
Your own integration's traffic against the public v1 API over the last 30 days: list the calls with their method, path, status code, duration, API-key prefix and environment, filtering by errors only or by any of those fields, and read a single one by its request_id — the opaque identifier every response returns in its header. Use it to debug an integration: what it called, when, with which status and how long it took. Headers, body and query string are not stored and are never returned. (2 tools)
| Tool | Scope | Category |
|---|---|---|
get_developers_request_logs | developers:read ¹ | read |
list_developers_request_logs | developers:read ¹ | read |
Employees
Workforce roster: search, CRUD-lite (create/update/deactivate/reactivate), stats and the invitation lifecycle (send/resend/cancel and list employee invitations). Gated by the control_horario module. (12 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Employee seats
Employee-seat add-on billing: the per-contract seat subscription — preview and read the seat charge and billing, subscribe, change the seat quantity and cancel the add-on. Gated by the control_horario module. (5 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Work schedules
Weekly work schedules and their assignments: search, CRUD, archive/unarchive, assign/unassign to employees, and read an employee's effective schedule. Gated by the control_horario module. (11 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Time tracking
Time clock (RD-ley 8/2019): clock in/out with pauses, manual entries, the time-correction workflow, balances and monthly time sheets, the tamper-evident monthly register close (close/reopen/seal, signature, chain validation) and its exports, plus payroll exports. Gated by the control_horario module. (29 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Absences
Absences: types, policies (with carryover configuration and assignments), requests (create/approve/reject/cancel), balances and the team absence calendar. Gated by the control_horario module. (25 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Presence
Presence: the live presence board and per-employee / daily presence state. Gated by the control_horario module. (3 tools)
| Tool | Scope | Category |
|---|---|---|
get_employee_presence | presence:read | read |
get_live_presence | presence:read | read |
list_daily_presence | presence:read | read |
Holidays
Holidays: read the company holiday calendar and resolve the holidays applicable to an employee's region (CCAA). Gated by the control_horario module. (3 tools)
| Tool | Scope | Category |
|---|---|---|
get_holiday | holidays:read | read |
list_holidays | holidays:read | read |
resolve_applicable_holidays | holidays:read | read |