Documentation Index
Fetch the complete documentation index at: https://docs.yofacturo.es/llms.txt
Use this file to discover all available pages before exploring further.
Tools
The server exposes 12 tools grouped by functional area.
Search contacts in the organization with optional filters.
| Parameter | Type | Required | Description |
|---|
query | string | No | Name search (case-insensitive). |
document_number | string | No | Filter by document number (NIF/CIF). |
email | string | No | Filter by email. |
page | integer | No | Page number. |
Deterministically resolve a single contact. Returns status (unique / ambiguous / none) and up to 5 candidates. Use this before any write operation that requires a contact_id.
| Parameter | Type | Required | Description |
|---|
query | string | No | Free-text name search (case-insensitive). |
document_number | string | No | Exact match on NIF/CIF. |
email | string | No | Exact match on email. |
id | integer | No | Exact contact id. Short-circuits all other filters. |
Create a new contact in the organization. Idempotent on document_number: if a contact with that NIF/CIF already exists, returns the existing one instead of creating a duplicate.
Update the fields of an existing contact. Only the fields passed are modified (PATCH semantics).
| Parameter | Type | Required | Description |
|---|
id | integer | Yes | Id of the contact to update. |
Products
resolve_product
Deterministically resolve a single product. Returns status (unique / ambiguous / none) and candidates. Use this before creating an invoice draft.
| Parameter | Type | Required | Description |
|---|
query | string | No | Free-text concept search. |
id | integer | No | Exact product id. |
create_product
Add a new product to the organization’s catalogue.
update_product
Update the fields of an existing product. Only the fields passed are modified (PATCH semantics).
| Parameter | Type | Required | Description |
|---|
id | integer | Yes | Id of the product to update. |
Invoices
resolve_invoice
Locate an existing issued invoice.
| Parameter | Type | Required | Description |
|---|
id | integer | No | Exact invoice id. |
full_number | string | No | Full invoice number (e.g. A-2025-0042). |
latest_for_contact_id | integer | No | Returns the most recent invoice for the given contact. |
create_invoice_draft
Create an ordinary (F1) invoice draft. The draft is not issued; use issue_invoice_draft to make it fiscally binding.
Returns the draft_id, a confirmation_token, and a preview to show the user before issuing.
| Parameter | Type | Required | Description |
|---|
contact_id | integer | Yes | Contact id. Use resolve_contact to obtain it. |
lines | array | Yes | At least one line. Each line must have product_id or (concept + unit_price). |
lines[].product_id | integer | No | Product id. Pre-fills concept, price, and tax rate. |
lines[].concept | string | No* | Required if no product_id. Overrides the product value when present. |
lines[].unit_price | number | No* | Required if no product_id. Overrides the product value when present. |
lines[].quantity | number | No | Defaults to 1. |
lines[].tax_rate | number | No | Overrides the product’s or organization’s default tax rate. |
lines[].discount_percent | number | No | Discount percentage. |
operation_date | string | No | ISO-8601 date. |
operation_description | string | No | Description of the operation. |
payment_method | string | No | Payment method. |
payment_method_info | string | No | Additional payment method information. |
create_simplified_invoice_draft
Create a simplified (F2) invoice draft, without an associated contact. Useful for tickets or general public sales.
Returns draft_id, confirmation_token, and a preview.
issue_invoice_draft
Destructive and irreversible operation. Once issued, the invoice is hash-chained and cannot be modified or deleted.
Keep in mind that invoices will not be sent to Verifactu until you submit the request from the platform.
| Parameter | Type | Required | Description |
|---|
draft_id | integer | Yes | Id of the draft to issue. |
confirmation_token | string | No | Token returned by the draft creation step. Must match if one was generated. |
send_email | boolean | No | If true, sends the issued invoice by email to the contact. Defaults to false. |
send_invoice_email
Send or resend an issued invoice by email to its associated contact.
| Parameter | Type | Required | Description |
|---|
issued_invoice_id | integer | Yes | Id of the issued invoice. |
Prompt
create_invoice
Full guided flow for issuing an invoice. The agent resolves the contact and products, creates the draft, presents the preview, and requests explicit confirmation before issuing.
