Set company tax exemption
set_company_tax_exemptionExempts a company record's orders from VAT by applying a legal reason, or clears the exemption with null. Requires customers:manage and site:config:edit.
Instructions
Exempt a company record's orders from VAT, or clear the exemption with null. An exempt company's carts and orders carry 0% and 0 tax with reason as the legal note, whatever its VAT id; in a workspace that stores gross prices the VAT inside them is removed, not charged. Carts already holding the old status are refused at checkout (BUYER_CHANGED) and orders keep the treatment they were placed with. Needs customers:manage and site:config:edit, the same pair as set_company_vat_verified and as linking a customer to a company whose VAT id is verified or that is tax exempt. Refused for a record that is not a company (a model with the Company capability). Returns the record id with vatId, vatCountry, vatVerifiedAt, vatVerifiedBy and taxExemptReason.
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": {
"recordId": "<recordId>",
"reason": "<reason>"
},
"name": "set_company_tax_exemption"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | The legal basis of the exemption, printed on each of the company's orders (3-300 characters); null clears the exemption | |
| recordId | Yes | The company record's id (a record of a model with the Company capability; a customer's company.id) |