Anthill

Create a new customer. Only the name is required — add email, phone, business tax registration number and address when the user provides them.

create_customer

Issue a customer invoice. Either derive it from a confirmed quote (pass quote_id, optionally with explicit lines for partial invoicing) or create it standalone from free-form lines. TAXES: by default each line gets the company's default tax (21% IVA in ES). For customers that must NOT carry Spanish VAT (exports, extra-EU clients), pass "tax_ids": [] on EVERY line — never leave default taxes on an export invoice. Ask the user when unsure; never guess the tax treatment.

create_invoice

Add a new product or service to the company's catalog. Use this to load a catalog (e.g. from a list the user pasted or a spreadsheet) and BEFORE quoting something recurring, so the item exists once with a real price instead of being auto-created from a quote line. Only name and kind are required. NEVER invent commercial data: list_price and standard_price must come from the user or a document they provided — if you don't have a price, leave it out and ask. Always search_products first to avoid creating a duplicate.

create_product

Create a NEW quote (presupuesto) in the ERP. NEVER call this directly after gathering data — ALWAYS show preview_quote first and wait for the user's explicit confirmation ("sí", "dale", "confirma"). When the user confirms the preview, call this in that same turn. The server ENFORCES this: create_quote is rejected without a valid preview_id, and the lines + global_price must be exactly the ones the user saw in that preview. The quote is created in draft — confirm_quote makes it a firm order, only on explicit request. To correct an existing quote use update_quote — do NOT create a duplicate. PRICING RULE: never invent or estimate prices. A price must come from the user's message, the product catalog (search_products), or a previous quote. If a price is missing, ASK the user (one question per turn). Only suggest reference prices if the user explicitly asks you to, and present them as suggestions requiring their confirmation.

create_quote

Create a new supplier (vendor).

create_supplier

Archive a memory that is wrong or obsolete. Get the memory_id from recall first, and confirm with the user which one to remove.

forget

Delete an automation permanently. Confirm with the user first.

delete_automation

Email a quote or a posted invoice to the customer, with its PDF attached. This LEAVES the building: it reaches the customer directly. Only call it when the user explicitly asked to send THIS document — never as a helpful extra step after creating one, and never to a recipient they did not give you. Confirm the destination address with them first if it isn't obvious.

send_document_email

VAT charged minus VAT borne for a period → the indicative amount owed to the tax office. Defaults to the CURRENT QUARTER. ALWAYS present this as an orientation figure computed from posted entries, never as the official filing — the accountant files the real return.

get_vat_position

What the company OWES one supplier: unpaid/partially paid bills and the outstanding total. The mirror of get_customer_debt.

get_supplier_debt

Get the company's profile in Anthill: name, country, ERP engine status, and the connections (e.g. email inbox) this company's agent can access.

get_company_info

Get how much a customer owes: open invoices and amounts due.

get_customer_debt

Itemized customer account (cuenta corriente): invoices and payments in date order with a running balance. Use this when the user wants the detail behind a balance; get_customer_debt gives only the total.

get_customer_statement

Get a download link for a delivery note PDF (albarán), ready to print or share with the customer. Present it to the user as a clickable link.

get_delivery_note_pdf

Get the current visual customization of the company's documents: cover & closing pages of quotes (presentation), the layout shared by quotes and invoices (colors, font, letterhead, footers), whether presentation mode is on, and the ALLOWED VALUES for every selection field (layout styles, textures, fonts, paper formats). Call this BEFORE update_document_branding to know the current state and the valid options.

get_document_branding

Get a download link for one attachment of an email in the active company's inbox (e.g. an invoice PDF someone sent). Returns a signed link; present it to the user.

get_email_attachment

Income, expenses and result for a period, plus cash/bank balances — the "how is the business doing" answer. Defaults to the current year.

get_financial_summary

Get a download link for an invoice's PDF document, ready to share with the customer. Present it to the user as a clickable link.

get_invoice_pdf

Get a quote's full detail: lines, totals, state and remaining amount to invoice.

get_quote

Get a download link for a quote's PDF document, ready to share with the customer. Present it to the user as a clickable link.

get_quote_pdf

Overdue money bucketed 30/60/90+ days, per customer or per supplier — "who owes me and how late". Use kind='payable' for what the company owes.

get_aging

List the company's automations: schedule, action, status and next run.

list_automations

List the company's customers. Optionally filter by a free-text search over name, email, phone or tax ID.

list_customers

List every company this login can operate and which one is ACTIVE (every other tool acts on the active one). Call it when the user mentions another of their businesses, asks which company they are on, or a customer/document seems to belong to a different company.

list_my_companies

List pending delivery orders (albaranes de salida): what still has to be shipped or handed to customers, with items, quantities and addresses.

list_pending_deliveries

List quotes, optionally filtered by customer and/or state.

list_quotes

List the company's internal stock locations (warehouses and zones).

list_stock_locations

List the company's suppliers (vendors).

list_suppliers

List the tax rates this company can actually put on a line, with the id each one needs, plus the company's default tax. Call this BEFORE passing `tax_ids` anywhere (create_invoice lines, automations): tax ids are company-specific and must NEVER be guessed — a wrong id produces a legally wrong invoice. If the user just wants the normal rate, omit tax_ids entirely and the company default applies; only reach for an explicit id when they asked for a specific treatment (reduced rate, exempt, intra-EU).

list_taxes

List customer invoices that are unpaid or partially paid.

list_pending_invoices

Every unpaid supplier bill, oldest due first, with the overdue subtotal — "what do I owe / what's overdue". The mirror of list_pending_invoices.

list_pending_bills

Pause an active automation (it stops firing) or resume a paused one.

pause_automation

Publish (post) a DRAFT invoice, making it official and sequenced. Only call when the user explicitly asks to post/publish it. Idempotent if already posted.

post_invoice

Render a PDF preview of the CURRENT branding so the user can see it: the quote cover page, the closing page, or a sample document with the shared layout (needs at least one quote to exist). Returns a download link; present it to the user.

preview_branding

Render a PREVIEW of a quote for the user to review BEFORE anything is created in the ERP. This step is MANDATORY before create_quote — even if the user gave customer, work and price in a single message. The response includes a preview_id that create_quote REQUIRES (the server rejects create_quote without it). Writes nothing in the ERP. If the user requests changes, re-emit the preview with the changes (each preview issues a fresh preview_id); only after an explicit "sí"/"confirma" call create_quote with the LATEST preview_id and the same lines. Draft the professional wording YOURSELF from the user's words (never ask for a title or for what to include/exclude — infer sensible defaults): rewrite each job as a complete customer-facing sentence, group by zones with section headers when the user organizes work that way, and list what is included / not included transparently.

preview_quote

Read one email from the active company's connected inbox: headers, text body (truncated if very long) and attachment filenames.

get_email

Search the company's saved memories. Call this at the START of a task to recover context from previous conversations (any agent, any channel) — e.g. before drafting a quote for a known customer, recall that customer's name.

recall

Register a payment received for a customer invoice. This writes an accounting entry in the company's own ERP — it never moves funds and never asks for card or bank account numbers (the optional reference/bank name are bookkeeping labels for the ledger entry).

register_payment

Register a purchase/expense: 'I bought N units of X at Y each from supplier Z'. Creates and completes the whole purchase flow, optionally generating the vendor bill.

register_expense

Register a miscellaneous expense that is NOT a supplier purchase or a supplier bill: taxes, bank fees, rent, small cash outflows. Creates a posted accounting entry immediately, so amount and description must come from the user — confirm both before calling if there is any ambiguity.

register_misc_expense