Skip to main content
PATCH
Update VAT rate
Send only the fields that you want to change. DualEntry keeps each field that you omit. Send null to clear valid_to, tax_asset_account_id, tax_liability_account_id, deductible, non_deductible_cost_account_id, or vatex_code. A null on description, is_active, or is_non_deductible changes nothing. Write deductible as a fraction from 0 to 1, with up to four decimal places. The rules for non-deductible VAT and for the tax accounts are the same as on create. An account that you omit can stay inactive, but each account that you send must be active. On a system rate (is_system is true), you can change is_active, valid_to, the tax accounts, and the non-deductible fields. A change to description or vatex_code on a system rate fails with 400. You cannot change country_code, name, rate, rate_type, tax_type, or valid_from. To change them, create a new rate and set is_active to false on this one.

Authorizations

X-API-KEY
string
header
required

Headers

Idempotency-Key
string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Path Parameters

vat_rate_id
integer
required

Body

application/json

Partial update. Omitted fields are left unchanged; explicit null clears nullable fields.

description
string | null
is_active
boolean | null
valid_to
string<date> | null
tax_asset_account_id
integer | null
tax_liability_account_id
integer | null
is_non_deductible
boolean | null
deductible
Required range: 0 <= x <= 1
non_deductible_cost_account_id
integer | null
vatex_code
enum<string> | null

The CEF VATEX code on this exempt VAT rate. Omit this field to keep the stored code. Set null to clear it.

Available options:
VATEX-EU-79-C,
VATEX-EU-132,
VATEX-EU-132-1A,
VATEX-EU-132-1B,
VATEX-EU-132-1C,
VATEX-EU-132-1D,
VATEX-EU-132-1E,
VATEX-EU-132-1F,
VATEX-EU-132-1G,
VATEX-EU-132-1H,
VATEX-EU-132-1I,
VATEX-EU-132-1J,
VATEX-EU-132-1K,
VATEX-EU-132-1L,
VATEX-EU-132-1M,
VATEX-EU-132-1N,
VATEX-EU-132-1O,
VATEX-EU-132-1P,
VATEX-EU-132-1Q,
VATEX-EU-135-1,
VATEX-EU-144,
VATEX-EU-146-1E,
VATEX-EU-148,
VATEX-EU-148-A,
VATEX-EU-148-B,
VATEX-EU-148-C,
VATEX-EU-148-D,
VATEX-EU-148-E,
VATEX-EU-148-F,
VATEX-EU-148-G,
VATEX-EU-151,
VATEX-EU-151-1A,
VATEX-EU-151-1AA,
VATEX-EU-151-1B,
VATEX-EU-151-1C,
VATEX-EU-151-1D,
VATEX-EU-151-1E,
VATEX-EU-153,
VATEX-EU-159,
VATEX-EU-309

Response

OK

Output schema for VAT rate.

id
integer
required
country_code
string
required
name
string
required
rate
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,6}0*$
rate_type
enum<string>
required
Available options:
STANDARD,
REDUCED,
SUPER_REDUCED,
PARKING,
ZERO,
EXEMPT,
OUT_OF_SCOPE
tax_type
enum<string>
required
Available options:
INPUT_OUTPUT,
ZERO_RATED,
EXEMPT,
REVERSE_CHARGE,
OUT_OF_SCOPE
valid_from
string<date>
required
valid_to
string<date> | null
required
is_active
boolean
required
is_system
boolean
required
description
string | null
required
tax_asset_account_id
integer | null
tax_liability_account_id
integer | null
is_non_deductible
boolean
default:false
deductible
string | null
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,6}0*$
non_deductible_cost_account_id
integer | null
vatex_code
enum<string> | null

The CEF VATEX code of this exempt VAT rate. null when the rate has no default.

Available options:
VATEX-EU-79-C,
VATEX-EU-132,
VATEX-EU-132-1A,
VATEX-EU-132-1B,
VATEX-EU-132-1C,
VATEX-EU-132-1D,
VATEX-EU-132-1E,
VATEX-EU-132-1F,
VATEX-EU-132-1G,
VATEX-EU-132-1H,
VATEX-EU-132-1I,
VATEX-EU-132-1J,
VATEX-EU-132-1K,
VATEX-EU-132-1L,
VATEX-EU-132-1M,
VATEX-EU-132-1N,
VATEX-EU-132-1O,
VATEX-EU-132-1P,
VATEX-EU-132-1Q,
VATEX-EU-135-1,
VATEX-EU-144,
VATEX-EU-146-1E,
VATEX-EU-148,
VATEX-EU-148-A,
VATEX-EU-148-B,
VATEX-EU-148-C,
VATEX-EU-148-D,
VATEX-EU-148-E,
VATEX-EU-148-F,
VATEX-EU-148-G,
VATEX-EU-151,
VATEX-EU-151-1A,
VATEX-EU-151-1AA,
VATEX-EU-151-1B,
VATEX-EU-151-1C,
VATEX-EU-151-1D,
VATEX-EU-151-1E,
VATEX-EU-153,
VATEX-EU-159,
VATEX-EU-309