Catàleg de tools
Les 457 tools del MCP de Factuarea agrupades per domini, amb el scope que requereix cadascuna i la seva categoria de límit de peticions.
El servidor MCP de Factuarea publica 457 tools en 29 dominis. Aquesta pàgina és
la llista canònica; l'esquema d'entrada de cada tool es descobreix en temps
d'execució mitjançant tools/list. Cada tool es correspon amb la mateixa operació a la
Referència de la REST API.
Com llegir aquest catàleg
- Tool — el nom de la tool MCP que invoca el teu agent.
- Scope — el scope granular que ha de tenir la credencial perquè la tool
aparegui a
tools/listi sigui invocable. Consulta Scopes i permisos. - Category — el bucket de límit de peticions al qual pertany la tool:
read,write,destructive,sendogenerate. Consulta Errors i límits de peticions.
Una credencial només veu les tools que cobreixen els seus scopes. Una API key amb el
super-scope * les veu totes 457; una key més restringida o un token OAuth en veu un subconjunt.
¹ Restringides a OAuth (només API key). 89 tools són accessibles únicament amb una
API key, mai a través d'una app OAuth de tercers: les 8 tools verifactu:write,
forget_delivery_note_signature (delivery_notes:gdpr_forget), les 20 tools de Pagaments i passarel·les (els scopes
stripe_autoinvoicing:*, payouts:read i integration_events:* són scopes
granulars, només API key), les 3 tools de Correus enviats i les 2 de registre de
peticions (emails:read i developers:read inspeccionen el trànsit de la
teva pròpia integració: són scopes de primera part, mai es concedeixen per
consentiment de tercers), les 17 tools de Gestoria (companies:* i api_keys:*: gestionar sub-comptes i
credencials mai es concedeix a tercers per consentiment OAuth — inclou
get_consolidated_workforce), les 4 tools d'escriptura de compte
(account:write: crear, rotar o revocar API keys i actualitzar la
personalització del compte), les 33 tools de control horari els scopes
d'escriptura/transició de les quals (time_entries:write, absences:write,
absences:transition, work_schedules:write) són granulars i només API key,
fora del catàleg de consentiment OAuth (les seves lectures i employees:write
sí es concedeixen per OAuth) i delete_automation_rule (automations:delete
es deixa fora del catàleg de consentiment OAuth a propòsit; els altres tres
scopes del motor d'automatitzacions —automations:read, automations:write i
automation_runs:read— sí es concedeixen). Per tant, les apps OAuth arriben a
368 de les 457 tools. Consulta la política de canals.
² Límit per lot — 200 ids per crida. bulk_send_invoices,
bulk_send_quotes, bulk_send_proformas i bulk_send_delivery_notes admeten
com a màxim 200 ids per crida, el mateix límit que les seves rutes REST
germanes (POST /v1/{recurs}/bulk-send). Un lot més gran es rebutja abans
d'enviar res: no s'envia cap correu ni es posa cap tasca a la cua. Divideix el
lot en blocs de 200 i repeteix la crida. El missatge d'error cita dues xifres i
res més —el límit i el que has enviat—, així que no retorna cap id del lot:
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.
Dominis
Factures
Factures de venda: cerca, CRUD, rectificatives, ledger de pagaments parcials, transicions (paid/sent/void/annul), programació, operacions massives, recordatoris, enllaços públics, PDFs i exportació a Excel. (44 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Contactes
(26 tools)
Contactes fiscals amb rols acumulables de client, proveïdor i lead. És l’única superfície MCP pública per a identitats de tercers. La plantilla CSV continua sent una descàrrega REST. Consulta Contactes.
| Tool | Scope | Categoria |
|---|---|---|
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 |
Productes
Catàleg: cerca, CRUD, opcions/combinacions configurables, ledger de stock, presentacions, variants, ofertes de proveïdor, accions massives, analítica i media. (38 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Tarifes
Preus per client i document: gestionar ítems actius/retirats, opcions compactes i resoldre seleccions de catàleg configurable. (13 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Pressupostos
Pressupostos: cerca, CRUD, acceptar/rebutjar, enviar, convertir a factura, operacions massives, cerca per ID extern, enllaços públics i PDFs. (20 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures proforma
Proformes: cerca, CRUD, acceptar/rebutjar, enviar, convertir, operacions massives, cerca per ID extern, enllaços públics i PDFs. (20 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Albarans
Albarans: cerca, CRUD, lliurar/cancel·lar/signar, convertir, enviar, operacions massives, cerca per ID extern, enllaços públics, PDFs i esborrat GDPR de la signatura. (22 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures de compra
Factures de compra: cerca, CRUD, marcar com a pagada, ledger de pagaments parcials, operacions massives, llistes de pendents/vençudes, cerca per ID extern, adjunts de fitxer i rebuts de pagament. (18 tools)
create_purchase_invoice i update_purchase_invoice accepten el contracte de línia mesurada (purchase_measurement, discount_percent, price_source, source_line_index); duplicar des de source_purchase_invoice_id exigeix a més purchase_invoices:read. Consulta Línies de compra mesurades.
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures recurrents
Plantilles recurrents: cerca, CRUD, crear des d'una factura, activar/pausar/reprendre/cancel·lar/ometre, previsualització, cerca per ID extern, logs i activitat. (17 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Sèries
Sèries de numeració (immutables per continuïtat fiscal): cerca, crear, arxivar/desarxivar, marcar per defecte, arrencar les quatre sèries per defecte d'una empresa acabada de donar d'alta, estadístiques i activitat. (12 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Impostos
Tipus impositius (catàleg global): cerca, CRUD-lite, valors per defecte, comprovacions d'ús, càlculs d'impost/totals i el catàleg fiscal AEAT de només lectura (règims, causes d'exempció, tipus d'IRPF i els parells legals IVA ↔ recàrrec d'equivalència). (16 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 l'AEAT: registres, esdeveniments, validació de cadena, reintent, subsanació de registres rebutjats, certificats, ajustos, declaració responsable i log d'accés a l'AEAT. (27 tools)
| Eina | Scope | Categoria |
|---|---|---|
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ó electrònica B2G: descarrega el XML FacturaE 3.2.2 d'una factura i gestiona les seves presentacions a FACe (enviar, seguir, cancel·lar). (5 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 fiscals
Declaracions davant l'AEAT calculades a partir de les teves pròpies dades de facturació: genera el Modelo 303, el 347 i el 130 com a fitxer posicional oficial, PDF o llibre de revisió; previsualitza el desglossament sense persistir res; i llegeix l'històric de generacions, les seves estadístiques, la seva activitat i els seus fitxers. (9 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Davant l'AEAT només es presenta el txt_aeat; el PDF i el llibre són material de
revisió construït amb el mateix càlcul. Consulta
Informes fiscals.
Webhooks i esdeveniments
Endpoints de webhook, lliuraments, rotació de secret, ping/replay, esdeveniments de prova i el catàleg d'esdeveniments publicats. (13 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Automatitzacions
El motor d'automatitzacions: regles amb la forma quan → si → fes, les versions immutables de la definició de cada regla, l'assaig que diu què faria una regla sense arribar a fer-ho, l'historial d'execucions amb els seus passos i els seus motius de descart tipificats, el rellançament d'un pas aparcat o d'una execució sencera, el catàleg d'activadors i accions amb els camps que exposa cada activador, i la quota mensual d'execucions. Requereix el mòdul automations. (18 tools)
replay_automation_run i replay_automation_run_step tornen a executar els
passos de debò: envien correus, entreguen webhooks i criden tercers. No és un
reintent innocu: confirma-ho amb la persona usuària abans d'invocar-les. La
feina s'encua, així que la resposta confirma que s'ha acceptat, no que hagi
acabat; comprova el desenllaç amb get_automation_run o
list_automation_run_steps.
| Eina | Scope | Categoria |
|---|---|---|
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 |
Compte
Identitat fiscal i personalització del compte: verifica el par nom + NIF registrat de l'empresa contra el cens de l'AEAT, consulta plantilles de personalització i actualitza la personalització del compte. (4 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 del teu propi tenant: llistar, crear, consultar, rotar el secret i revocar. El secret es retorna un sol cop, en crear i en rotar. (5 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Gestoria
Mode gestoria: gestiona les empreses filles del tenant mestre i les seves child API keys — crear/llistar/consultar/actualitzar/eliminar, activar/desactivar, previsualització del cost per plaça, estat d'aprovisionament, API keys per empresa i un resum consolidat del compliment horari de les empreses filles. (17 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Pagaments i passarel·les
Integracions de pagaments i botigues: facturació automàtica de Stripe, comptes connectats, liquidacions, safata d’esdeveniments, gestió i diagnòstic de botigues WooCommerce i Shopify. Aquestes eines només admeten API key. La disponibilitat també depèn dels mòduls de l’empresa i de la configuració del proveïdor. (20 tools)
replay_integrations_event té efecte fiscal real. Si la causa que va impedir
facturar ja està resolta, reprocessar un esdeveniment aparcat pot emetre una
factura de debò, amb el seu número de sèrie i el seu alta a VeriFactu. No és
un reintent innocu: confirma-ho amb la persona usuària abans d'invocar-la. No
duplica factures: el reprocés torna a passar per la mateixa comprovació
d'idempotència de l'intent original.
| Eina | Scope | Categoria |
|---|---|---|
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 |
Correus enviats
Registre de correus enviats: llista els correus que Factuarea ha enviat en nom de l'empresa (factures, pressupostos, albarans, recordatoris de pagament), consulta'n un pel seu id i resumeix d'una sola vegada com va acabar l'enviament d'un lot de fins a 100 documents. Fes-lo servir per respondre «s'ha enviat el correu d'aquesta factura?» i per investigar enviaments fallits. (3 tools)
L'estat descriu el lliurament al servidor SMTP de sortida, no el lliurament
real. sent significa que el servidor de correu de sortida va acceptar el
missatge: tot i així pot rebotar o acabar a spam sense que Factuarea se
n'assabenti. No existeixen els estats delivered, bounced ni opened;
queued, sending, sent i failed són els únics. No afirmis mai que la
persona destinatària el va rebre, el va obrir o el va llegir.
| Eina | Scope | Categoria |
|---|---|---|
get_emails | emails:read ¹ | read |
get_emails_indicators | emails:read ¹ | read |
list_emails | emails:read ¹ | read |
Registre de peticions a l'API
El trànsit de la teva pròpia integració contra l'API pública v1 dels últims 30 dies: llista les crides amb el seu mètode, ruta, codi d'estat, durada, prefix d'API key i entorn, amb filtres per només errors o per qualsevol d'aquests camps, i consulta'n una de concreta pel seu request_id, l'identificador opac que l'API retorna a la capçalera de cada resposta. Fes-lo servir per depurar una integració: què va cridar, quan, amb quin codi d'estat i quant va trigar. Les capçaleres, el cos i la query string no s'emmagatzemen i no es retornen mai. (2 tools)
| Eina | Scope | Categoria |
|---|---|---|
get_developers_request_logs | developers:read ¹ | read |
list_developers_request_logs | developers:read ¹ | read |
Empleats
Plantilla de personal: cerca, alta/edició/baixa/reactivació, estadístiques i el cicle d'invitacions (enviar/reenviar/cancel·lar i llistar invitacions d'empleat). Requereix el mòdul control_horario. (12 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Places d'empleat
Facturació de l'add-on de places: la subscripció de places per contracte — previsualitzar i consultar el càrrec i la facturació de la plaça, subscriure, canviar la quantitat de places i cancel·lar l'add-on. Requereix el mòdul control_horario. (5 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Horaris de treball
Horaris de treball setmanals i les seves assignacions: cerca, CRUD, arxivar/desarxivar, assignar/desassignar a empleats i consultar l'horari efectiu d'un empleat. Requereix el mòdul control_horario. (11 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 horari
Registre de jornada (RD-llei 8/2019): fitxar entrada/sortida amb pauses, entrades manuals, el flux de correccions de fitxatge, saldos i fulls d'hores mensuals, el tancament mensual inalterable del registre (tancar/reobrir/segellar, signatura, validació de cadena) i les seves exportacions, a més de les exportacions de nòmina. Requereix el mòdul control_horario. (29 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Absències
Absències: tipus, polítiques (amb configuració de carryover i assignacions), sol·licituds (crear/aprovar/rebutjar/cancel·lar), saldos i el calendari d'absències de l'equip. Requereix el mòdul control_horario. (25 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Presència
Presència: el tauler de presència en viu i l'estat de presència per empleat i diari. Requereix el mòdul control_horario. (3 tools)
| Eina | Scope | Categoria |
|---|---|---|
get_employee_presence | presence:read | read |
get_live_presence | presence:read | read |
list_daily_presence | presence:read | read |
Festius
Festius: consultar el calendari de festius de l'empresa i resoldre els festius aplicables a la regió (CCAA) d'un empleat. Requereix el mòdul control_horario. (3 tools)
| Eina | Scope | Categoria |
|---|---|---|
get_holiday | holidays:read | read |
list_holidays | holidays:read | read |
resolve_applicable_holidays | holidays:read | read |