API Docs
/
No Results Found
Taxes

Taxes

Taxes are collected by the government to manage state expenses. A company and an individual must pay multiple taxes and disclose the income details.

Attribute

tax_id
string
Unique ID of the tax
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_authority_id
string
tax_authority_name
string
🇺🇸 United States
, 🇨🇦 Canada
only
Unique name for the Tax Authority.
is_value_added
boolean
to check if tax value os added
tax_specific_type
string
🇮🇳 India
only
Type of Tax For Indian Edition. Allowed Values : igst ,cgst ,sgst ,nil, cess

Example

{ "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "is_value_added": false, "tax_specific_type": "string" }

Create a tax

Create a tax which can be associated with an item.
oauthscope : ZohoInvoice.settings.CREATE

Arguments

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_authority_id
string
country_code
string
🇬🇧 United Kingdom
only
Two letter country code for the EU country to which the tax belongs.
tax_specific_type
string
🇮🇳 India
only
Type of Tax For Indian Edition. Allowed Values : igst ,cgst ,sgst ,nil, cess

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxes -X POST -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "country_code": "UK", "tax_specific_type": "string" }

Response Example

{ "code": 0, "message": "The tax has been added.", "tax": { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "is_value_added": false, "tax_specific_type": "string" } }

List taxes

List of simple and compound taxes with pagination.
oauthscope : ZohoInvoice.settings.READ

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxes -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "taxes": [ { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "is_value_added": false, "is_default_tax": true, "is_editable": true }, {...}, {...} ] }

Update a tax

Update the details of a simple or compound tax.
oauthscope : ZohoInvoice.settings.UPDATE

Arguments

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_authority_id
string
country_code
string
🇬🇧 United Kingdom
only
Two letter country code for the EU country to which the tax belongs.
tax_specific_type
string
🇮🇳 India
only
Type of Tax For Indian Edition. Allowed Values : igst ,cgst ,sgst ,nil, cess

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxes/{tax_id} -X PUT -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "country_code": "UK", "tax_specific_type": "string" }

Response Example

{ "code": 0, "message": "Tax information has been saved.", "tax": { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "is_value_added": false, "tax_specific_type": "string" } }

Get a tax

Get the details of a simple or compound tax.
oauthscope : ZohoInvoice.settings.READ

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxes/{tax_id} -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "tax": { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax", "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "is_value_added": false, "tax_specific_type": "string" } }

Delete a tax

Delete a simple or compound tax.
oauthscope : ZohoInvoice.settings.DELETE

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxes/{tax_id} -X DELETE -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "The record has been deleted." }

Update a tax group

Update the details of the tax group.
oauthscope : ZohoInvoice.settings.UPDATE

Arguments

tax_group_name
string
Name of the tax group to be created.
taxes
string
List of tax IDs that are to be associated to the tax group.

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxgroups/{tax_group_id} -X PUT -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_group_name": "Sales Group", "taxes": "VAT" }

Response Example

{ "code": 0, "message": "success", "tax_group": { "tax_group_id": "982000000566009", "tax_group_name": "Sales Group", "tax_group_percentage": 10.5, "taxes": [ { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax" } ] } }

Get a tax group

Get the details of a tax group.
oauthscope : ZohoInvoice.settings.READ

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxgroups/{tax_group_id} -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "tax_group": { "tax_group_id": "982000000566009", "tax_group_name": "Sales Group", "tax_group_percentage": 10.5, "taxes": [ { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax" } ] } }

Delete a tax group

Delete a tax group. Tax group that is associated to transactions cannot be deleted.
oauthscope : ZohoInvoice.settings.DELETE

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxgroups/{tax_group_id} -X DELETE -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "The tax group has been deleted." }

Create a tax group

Create a tax group associating multiple taxes.
oauthscope : ZohoInvoice.settings.CREATE

Arguments

tax_group_name
string
Name of the tax group to be created.
taxes
string
List of tax IDs that are to be associated to the tax group.

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxgroups -X POST -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_group_name": "Sales Group", "taxes": "VAT" }

Response Example

{ "code": 0, "message": "success", "tax_group": { "tax_group_id": "982000000566009", "tax_group_name": "Sales Group", "tax_group_percentage": 10.5, "taxes": [ { "tax_id": "982000000566009", "tax_name": "Sales Group", "tax_percentage": 10.5, "tax_type": "tax" } ] } }

Create Tax Exemption.

Create a Tax Exemption.
oauthscope : ZohoInvoice.settings.CREATE

Arguments

tax_exemption_code
string
(Required)
🇮🇳 India
, 🇺🇸 United States
, 🇨🇦 Canada
only
Unique code of the tax exemption.
description
string
Description for the tax exemption.
type
string
(Required)
Type of tax exemption. Allowed Values customer and item

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxexemptions -X POST -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_exemption_code": "Non-Profit", "description": "It is an Non profit organization", "type": "customer" }

Response Example

{ "code": 0, "message": "Tax Exemption has been added.", "tax_exemption": { "tax_exemption_id": "982000000577199", "tax_exemption_code": "Non-Profit", "description": "It is an Non profit organization", "type": "customer", "type_formatted": "Customer" } }

List Tax Exemptions

List all Tax Exemptions.
oauthscope : ZohoInvoice.settings.READ

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxexemptions -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "tax_exemptions": [ { "tax_exemption_id": "982000000577199", "tax_exemption_code": "Non-Profit", "description": "It is an Non profit organization", "type": "customer", "type_formatted": "Customer" }, {...}, {...} ] }

Update Tax Exemption.

Update an existing Tax Exemption.
oauthscope : ZohoInvoice.settings.UPDATE

Arguments

tax_exemption_code
string
(Required)
🇮🇳 India
, 🇺🇸 United States
, 🇨🇦 Canada
only
Unique code of the tax exemption.
description
string
Description for the tax exemption.
type
string
(Required)
Type of tax exemption. Allowed Values customer and item

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxexemptions/{tax_exemption_id} -X PUT -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_exemption_code": "Non-Profit", "description": "It is an Non profit organization", "type": "customer" }

Response Example

{ "code": 0, "message": "Tax Exemption information has been updated.", "tax_exemption": { "tax_exemption_id": "982000000577199", "tax_exemption_code": "Non-Profit", "description": "It is an Non profit organization", "type": "customer", "type_formatted": "Customer" } }

Delete Tax Exemption

Delete a Tax Exemption.
oauthscope : ZohoInvoice.settings.DELETE

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxexemptions/{tax_exemption_id} -X DELETE -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "Tax Exemption has been deleted." }

Create Tax Authority.

Create a Tax Authority.
oauthscope : ZohoInvoice.settings.CREATE

Arguments

tax_authority_name
string
(Required)
🇺🇸 United States
, 🇨🇦 Canada
only
Unique name for the Tax Authority.
registration_number_label
string
Label for the Registration Number.
registration_number
string
Registration number of the Tax Authority.
description
string
Description for the Tax Authority.

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxauthorities -X POST -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_authority_name": "Canada Revenue Agency", "registration_number_label": "Canada Tax Reg.No", "registration_number": "123456", "description": "Canada Tax Authority" }

Response Example

{ "code": 0, "message": "Tax Authority has been added.", "tax_authority": { "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "description": "Canada Tax Authority", "registration_number": "123456", "registration_number_label": "Canada Tax Reg.No" } }

List Tax Authorities

List all Tax Authorities.
oauthscope : ZohoInvoice.settings.READ

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxauthorities -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "tax_authorities": [ { "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "description": "Canada Tax Authority", "registration_number": "123456", "registration_number_label": "Canada Tax Reg.No" }, {...}, {...} ] }

Update Tax Authority.

Update an existing Tax Authority.
oauthscope : ZohoInvoice.settings.UPDATE

Arguments

tax_authority_name
string
(Required)
🇺🇸 United States
, 🇨🇦 Canada
only
Unique name for the Tax Authority.
registration_number_label
string
Label for the Registration Number.
registration_number
string
Registration number of the Tax Authority.
description
string
Description for the Tax Authority.

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxauthorities/{tax_authority_id} -X PUT -H "X-com-zoho-invoice-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "tax_authority_name": "Canada Revenue Agency", "registration_number_label": "Canada Tax Reg.No", "registration_number": "123456", "description": "Canada Tax Authority" }

Response Example

{ "code": 0, "message": "Tax Authority information has been updated.", "tax_authority": { "tax_authority_id": "982000000954211", "tax_authority_name": "Canada Revenue Agency", "description": "Canada Tax Authority", "registration_number": "123456", "registration_number_label": "Canada Tax Reg.No" } }

Delete Tax Authority

Delete a Tax Authority.
oauthscope : ZohoInvoice.settings.DELETE

Request Example

Click to copy
$ curl https://invoice.zoho.com/api/v3/settings/taxauthorities/{tax_authority_id} -X DELETE -H "X-com-zoho-invoice-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "Tax Authority has been deleted." }