Skip to main content

CreateTaxRateRequest

displayNameTaxRate-DisplayNamerequired

The name of the tax shown to the buyer.

Possible values: non-empty and <= 50 characters

Example: IVA
percentageTaxRate-Percentagerequired

The rate in percent, with up to 4 decimals. It cannot change after the tax rate is created.

Possible values: >= 0 and <= 100

Example: 21
taxTypeTaxRate-TaxType

The kind of tax: VAT, IGIC (Canary Islands) or IPSI (Ceuta and Melilla). It cannot change after the tax rate is created. Treat the set as open: more values can be added later.

Default value: VAT
Example: VAT
activeTaxRate-Active

Whether the tax rate is active. Tax rates are never deleted: set active to false to archive one. An archived rate cannot be set on a product. While a product still has it, the product cannot get new prices and its prices cannot start or switch a subscription. Subscriptions that already use it keep their copy. A new tax rate is active unless created with active: false.

Example: true
CreateTaxRateRequest
{
"displayName": "IVA",
"percentage": 21,
"taxType": "VAT",
"active": true
}