Set company vat verified
set_company_vat_verifiedAttest or withdraw a company VAT id check to zero-rate its EU orders as reverse charge; withdrawing restores standard taxation. Requires a stored VAT id matching expectedVatId.
Instructions
Attest that a company record's VAT id was checked (for example in VIES), or withdraw that attestation. A verified EU VAT id of another member state than the workspace's sellerCountry (update_cart_config) zero-rates the company's orders as reverse charge, unless an order ships to the seller's country, or out of the EU as an export; withdrawing it taxes them as standard again. Carts already holding the old status are refused at checkout (BUYER_CHANGED) and orders keep the treatment they were placed with. Refused when the company has no VAT id (set it with set_company_vat_id) and with CONFLICT when the stored id differs from expectedVatId. Needs customers:manage and site:config:edit, the same pair as set_company_tax_exemption 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>",
"verified": "<verified>"
},
"name": "set_company_vat_verified"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recordId | Yes | The company record's id (a record of a model with the Company capability; a customer's company.id) | |
| verified | Yes | true attests the VAT id was checked, false withdraws it | |
| expectedVatId | No | The VAT id you checked, as get_record's vatId shows it; required to verify. A different stored id is refused with CONFLICT |