Create a Tax
OAuthScope
ZohoCommerce.settings.CREATE
HTTP Request
POST https://commerce.zoho.com/store/api/v1/settings/taxrules
Body Parameters
| Parameter | Description |
| tax_name* | string: Name of the tax to be created. |
| tax_percentage* | double: Number of percentage taxable. |
| tax_type* | string: Type to determine whether it is a simple or compound tax. Allowed values: tax and compound_tax. |
| tax_specific_type (Indian edition only) | Type of tax For Indian Edition. Allowed values :IGST, SGST, NIL, CESS. |
| country_code* | string: Two letter country code to which the tax belongs. |
Request Example
Copiedcurl -i -L -X POST
-H "Authorization:Zoho-oauthtoken ***"
-H "X-com-zoho-store-organizationid:58927961"
-H "Content-Type:application/json"
-d
'{
"tax_name":"GST",
"tax_percentage":10,
"country_code":"CA",
"zones":[],
"tax_overrides":[]
}'
'https://commerce.zoho.com/store/api/v1/settings/taxrulesSuccess Response
Copied{
"code": 0,
"message": "Rule configured successfully",
"taxrule": {
"${AddressRuleTable.CountryCode}": "CA",
"tax_name": "GST",
"country_name": "Canada",
"tax_percentage": 10.000000,
"zones": [],
"tax_overrides": [],
"tax_id": "261000000007005"
}
}Failure Response
Copied{
"code": 1056,
"message": "Invalid Tax percentage."
}