beel_delete_customers_bulk
Delete multiple customers for a company by ID in a single bulk operation. Customers with invoices are retained and returned with a status explaining why deletion failed.
Instructions
Deletes the customers listed in ids from this company.
Partial results
Partial operation: the customers that can be deleted are deleted, and the rest keep their place in
customers_deletionwith the status that explains why. That is why it answers200with a body instead of204, and why it answers200even when no row could be deleted.HAS_INVOICES: a customer that has invoices cannot be deleted and comes back with that row status.
What deleting means
Semantics: the same semantics as
DELETE /v1/companies/{company_id}/customers/{customer_id}— the customer is retained internally for tax record-keeping purposes but is no longer exposed by the API, its identifier is released for reuse, and invoices already issued to it keep their own copy of the recipient's details.Deleting is not deactivating: deleting frees the identifier, so the same NIF can be registered again, while
PATCHwithactive: falseleaves the customer where it is with its NIF still taken.
BeeL API endpoint: DELETE /v1/companies/{company_id}/customers/bulk (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>",
"ids": "<ids>"
},
"name": "beel_delete_customers_bulk"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Comma-separated customer IDs | |
| 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. |