beel_generate_representation
Generates the unsigned AEAT representation PDF for a company as the first step of the representation flow; requires complete fiscal identity and no active representation.
Instructions
Generates the unsigned AEAT representation PDF of a company, the first step of the representation flow.
Next steps: download the PDF from
GET /v1/companies/{company_id}/representation/document, sign it digitally and return it throughPOST /v1/companies/{company_id}/representation/submit.Fiscal identity: must be complete before the document can be produced. An incomplete one is rejected with
400naming what is missing.Existing representation: a company that already holds an active one is rejected too. Cancel it first.
BeeL API endpoint: POST /v1/companies/{company_id}/representation (reference: https://docs.beel.es)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company_id": "<company_id>"
},
"name": "beel_generate_representation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | Unique identifier (UUID) of the company the operation acts on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. | |
| idempotency_key | No | Optional idempotency key for this operation. Omit it and one is derived from the request itself, which makes a blind retry safe but also collapses a SECOND, deliberately identical operation into the first for 24 hours. Set it — to an order id, or anything unique per intended operation — whenever you mean to create something that may look identical to what you just created. |