VAT Rates
Create VAT rate
Create a custom VAT rate for your organization.
POST
Create VAT rate
The new rate has
is_system set to false and is_active set to true.
Write rate and deductible as a fraction from 0 to 1, with up to four decimal places. For example, 0.2 is 20%.
valid_to cannot be before valid_from.
For a reverse-charge rate, set tax_type to REVERSE_CHARGE.
To make a rate non-deductible, set is_non_deductible to true and send deductible, the part of the VAT that you can deduct. You can also send non_deductible_cost_account_id, an expense, other expense, or cost of goods sold account. A zero-rated, exempt, or out-of-scope rate cannot be non-deductible. When is_non_deductible is false, DualEntry ignores deductible and non_deductible_cost_account_id.
tax_asset_account_id and tax_liability_account_id override the tax accounts that the rate posts to. The asset account must be an other current asset or other asset account. The liability account must be an other current liability or long term liability account. Each account that you send must be an active account of your organization.
Fails with 400 if a value breaks these rules, or if a rate with the same country_code, name, rate, and valid_from already exists.
Fails with 409 if another request creates the same rate at the same time.Headers
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:
255Body
application/json
The CEF VATEX code to store on an exempt VAT rate. Omit or set 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 Response
Created
Output schema for VAT rate.
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