beel_cancel_representation
Cancels a company's active AEAT representation, preventing production invoice submissions until a new representation document is generated and signed.
Instructions
Cancels the active AEAT representation of a company.
Effect: until a new document is generated and signed, the company can no longer submit invoices to AEAT in production. Its activation and its ability to issue non-VeriFactu invoices are untouched.
No active representation: rejected with
400. Cancelling is a state transition, not a delete-if-present.
BeeL API endpoint: DELETE /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_cancel_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. |