Tax record books (self-employed)
list_tax_documentsEntries of the self-employed tax record books of a fiscal year (Spain: income, expenses, investment goods and provisions books), one per tax document (invoice), as shown in Cuéntamo: accrual and invoice dates, invoice number, fiscal amount with VAT, VAT rate(s), income-tax withholding, tax-return box, depreciation, payment status and completeness. Filters by book, accrual date range, client or supplier, tax-return box and missing data; paginated. Client and supplier names and tax ids come partially hidden unless reveal_third_parties is true; they are returned under untrusted with the concept and notes. Read-only. Needs the self-employed module.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_tax_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | No | Account book id (from list_books). Optional if the user has only one. | |
| year | No | Fiscal year. Default: current year. | |
| limit | No | Default: 50. | |
| offset | No | For the next page. Default: 0. | |
| date_to | No | Accrual date to (inclusive). | |
| tax_box | No | Tax-return box code (e.g. 0186), or "unclassified". | |
| tax_book | No | Default: all. | |
| date_from | No | Accrual date from (inclusive), e.g. the first day of a quarter. | |
| third_party | No | Part of the client or supplier name or tax id (accents and case ignored). Matches on the full data even when the answer hides it. | |
| incomplete_only | No | Only entries missing the client/supplier or the invoice number. | |
| reveal_third_parties | No | Full names and tax ids of clients, suppliers and payees. Default false: they come partially hidden (first letters of each word, first and last characters of the tax id). |