Set the billing country and VAT number
PUT /v1/billing/tax
In this build: Uses a stand-in for an external service. The rules and rates are real. A VAT number is checked for its shape only: confirming it is live is a VIES lookup, which isn't connected.
Scope: billing.write
CLI: harebox billing tax set
| Field | Type | Notes |
|---|---|---|
country |
string or null |
Where the account is established, as an ISO 3166 code such as FR, DE or US. Empty clears it. |
vat_id |
string or null |
An EU business's VAT number, with its country prefix (EL for Greece). Setting one marks the account a business. |
business |
boolean |
The account buys as a business. Outside France, an EU business with a VAT number pays no VAT: it accounts for it itself (reverse charge). |
TaxDetails
| Field | Type | Notes |
|---|---|---|
country |
string or null |
|
vat_id |
string or null |
|
business (required) |
boolean |
|
treatment (required) |
string |
fr_vat: in France, French VAT. eu_consumer_vat: a consumer elsewhere in the EU, at their country's rate. reverse_charge: an EU business outside France with a VAT number, no VAT. outside_eu: no EU VAT. fr_vat_default: no country given yet, so French VAT applies. One of: fr_vat, fr_vat_default, eu_consumer_vat, reverse_charge, outside_eu |
rate_pct (required) |
number |
The VAT rate added to each charge. |
prices_include_vat (required) |
boolean |
Always false: prices exclude VAT, which is added to each charge. |
vat_id_check |
string |
format: the VAT number has a valid shape. It isn't checked against VIES yet. One of: none, format |
Errors follow one format.