Set company vat id
set_company_vat_idSet or clear a company's EU VAT ID with automatic normalization and format validation; malformed IDs are refused, and changed IDs require re-verification before VAT-exempt order taxation.
Instructions
Set the EU VAT id of a company record. cmssy normalizes it (spaces, dots and dashes dropped, GR read as EL) and checks it against the member state's format; a malformed id is refused (BAD_USER_INPUT). null or empty clears it. A changed id is no longer verified, so its orders are taxed as standard until set_company_vat_verified attests the new value. Needs customers:manage. Verifying the id or exempting the company (set_company_vat_verified, set_company_tax_exemption) needs customers:manage and site:config:edit, and so does 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>",
"vatId": "<vatId>"
},
"name": "set_company_vat_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vatId | Yes | The EU VAT id with its country prefix, e.g. DE123456789; null or empty clears it | |
| recordId | Yes | The company record's id (a record of a model with the Company capability; a customer's company.id) |