CorefinityCorefinityDocs
Open the Control PanelControl Panel
Billing · 14 of 17

corestack_billing_vat_number_set

Set the VAT number.

Scope writeNo secrets returned
On this page

When to use it

Set — or clear — your company's VAT number on its billing account. Ordering from the EU is for VAT-registered businesses: with a VAT number the EU reverse charge applies and no VAT is added to the invoices. The number is checked with the EU's VIES service in the background; nothing waits for it and nothing is refused for it. Read corestack_billing_account_get for the number's state (pending while VIES has not answered, then valid or invalid) and for the account's version, which this write sends back.

The same acceptance rule as the Control Panel's Billing details page: spaces, dots and dashes are removed, and an EU number with no country prefix gains its billing country's (EL for Greece, so 123456789 for a Greek account is stored EL123456789). It needs the write scope.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_billing_vat_number_set with vat_number DE123456789, version 384729103. (Set the VAT number.) Tell me what it returned.

Inputs

account_idinteger

One of your company's billing accounts; omitted, the company's default account. At least 1.

vat_numberstring or null

The VAT number, or null to clear it. Spaces, dots and dashes are removed; an EU number with no country prefix gains its billing country's.

versionintegerRequired

The account's version as corestack_billing_account_get returned it. A stale one is refused with stale; read the account again and send the new version. At least 0.

Example call

tools/call
{
  "name": "corestack_billing_vat_number_set",
  "arguments": {
    "vat_number": "DE123456789",
    "version": 384729103
  }
}

If it is refused

ReasonWhat to do
invalid_argumentsWith vat_number: characters outside letters, numbers, + and *; more than 20 characters; or, for a GB number, not the GB shape (GB123456789, GB123456789012, GD123, HA123). Send a corrected number.
staleSomeone changed the account's details (staff included) after you read them; read corestack_billing_account_get again and send its version.
billing_forbiddenThe person has no billing role in the company; ask a company owner or billing member.
tenant_mismatchThe account is not one of your company's.
pin_refusedThe token is pinned to certain sites or clusters. The VAT number is the company's billing details on every order and invoice, so no site or cluster pin can cover setting it; the card offers a step-up to a token with no pins.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT