Taxes
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Manage GST and direct tax settings for your organization in the India Edition.
Download Taxes OpenAPI Document
End Points
Create a tax
List taxes
Bulk delete taxes
Update a tax
Get a tax
Delete a tax
Mark a tax as active
Mark a tax as inactive
List transactions associated with a tax
Create a tax group
Update a tax group
Get a tax group
Delete a tax group
Update direct tax settings
Get direct tax settings
Attribute
tax_id
string
ID of the tax. Note: This value is a set of numeric characters.
tax_display_name
string
Display name of the tax.
tax_name
string
Name of the tax.
tax_name_formatted
string
Formatted name of the tax.
tax_percentage
double
Tax percentage.
is_editable
boolean
Whether the tax is editable. Allowed values:
true and false. tax_type
string
Type of tax. Allowed values:
tax, compound_tax, tds_tax, tcs_tax, tax_on_tax, and gst_tds_tax. tax_account_id
string
Account ID in which output tax will be computed. Note: This value is a set of numeric characters.
purchase_tax_account_id
string
Account ID in which input tax will be computed. Note: This value is a set of numeric characters.
tds_payable_account_id
string
TDS payable account ID. Note: This value is a set of numeric characters.
tcs_receivable_account_id
string
TCS receivable account ID. Note: This value is a set of numeric characters.
tcs_payable_account_id
string
TCS payable account ID. Note: This value is a set of numeric characters.
tax_specific_type
string
Type of tax for the India Edition. Allowed values include
tax, igst, cgst, sgst, utgst, nil, and cess. tax_specific_type_desc
string
Description of the tax specific type.
tax_specific_type_version
string
Version of the tax specific type.
tax_authority_id
string
ID of the tax authority. Note: This value is a set of numeric characters.
tax_authority_name
string
Name of the Tax Authority
is_state_cess
boolean
Whether the tax is a state cess. Allowed values:
true and false. is_value_added
boolean
Check if Tax is Value Added
tax_factor
string
Type of Tax Factor. Allowed values:
rate, share tax_account_tracking
string
Tax account tracking mode. Allowed values:
split and single. output_tax_account_name
string
Name of the account in which output tax is computed.
purchase_tax_account_name
string
Name of the account in which input tax is computed.
purchase_tax_expense_account_id
string
Account ID in which purchase tax expense will be computed. Note: This value is a set of numeric characters.
accounting_app_name
string
Name of the third-party accounting application associated with the tax.
accounting_reference_id
string
Reference ID of the tax in the third-party accounting application. Note: This value is a set of numeric characters.
diff_rate_reason
string
Reason for a different tax rate. Allowed values:
tds_non_pan, tds_non_filing, tcs_non_pan, and tcs_non_filing. start_date
string
Start date of the tax in
yyyy-mm-dd format. end_date
string
End date of the tax in
yyyy-mm-dd format. status
string
Status of the tax.
description
string
Description of the tax.
reference_id
string
Reference ID of the tax.
{
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_name_formatted": "IGST 18%",
"tax_percentage": 18,
"is_editable": true,
"tax_type": "tax",
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_specific_type": "igst",
"tax_specific_type_desc": "IGST",
"tax_specific_type_version": "1",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"is_state_cess": false,
"is_value_added": false,
"tax_factor": "rate",
"tax_account_tracking": "single",
"output_tax_account_name": "Output CGST",
"purchase_tax_account_name": "Input CGST",
"purchase_tax_expense_account_id": "132086000000107337",
"accounting_app_name": "Zoho Books",
"accounting_reference_id": "132086000000107350",
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active",
"description": "Standard IGST rate",
"reference_id": "REF-001"
}
Create a tax
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Create a GST tax rate that can be associated with items and transactions.
OAuth Scope : ERP.settings.CREATE
Arguments
tax_name
string
(Required)
Name of the tax.
tax_display_name
string
Display name of the tax.
tax_percentage
double
(Required)
Tax percentage.
tax_type
string
Type of tax. Allowed values:
tax, compound_tax, tds_tax, tcs_tax, tax_on_tax, and gst_tds_tax. tax_factor
string
Type of Tax Factor. Allowed values:
rate, share tax_specific_type
string
Type of tax for the India Edition. Allowed values include
tax, igst, cgst, sgst, utgst, nil, and cess. tax_authority_name
string
Name of the Tax Authority
tax_authority_id
string
ID of the tax authority. Note: This value is a set of numeric characters.
is_value_added
boolean
Check if Tax is Value Added
tax_account_id
string
Account ID in which output tax will be computed. Note: This value is a set of numeric characters.
purchase_tax_account_id
string
Account ID in which input tax will be computed. Note: This value is a set of numeric characters.
purchase_tax_expense_account_id
string
Account ID in which purchase tax expense will be computed. Note: This value is a set of numeric characters.
tds_payable_account_id
string
TDS payable account ID. Note: This value is a set of numeric characters.
tcs_receivable_account_id
string
TCS receivable account ID. Note: This value is a set of numeric characters.
tcs_payable_account_id
string
TCS payable account ID. Note: This value is a set of numeric characters.
tax_account_tracking
string
Tax account tracking mode. Allowed values:
split and single. is_non_advol_tax
boolean
Whether the tax is a non-advalorem tax. Allowed values:
true and false. is_state_cess
boolean
Whether the tax is a state cess. Allowed values:
true and false. diff_rate_reason
string
Reason for a different tax rate. Allowed values:
tds_non_pan, tds_non_filing, tcs_non_pan, and tcs_non_filing. start_date
string
Start date of the tax in
yyyy-mm-dd format. end_date
string
End date of the tax in
yyyy-mm-dd format. description
string
Description of the tax.
update_recurring_invoice
boolean
Update recurring invoices when the tax is changed. Allowed values:
true and false. update_recurring_expense
boolean
Update recurring expenses when the tax is changed. Allowed values:
true and false. update_draft_invoice
boolean
Update draft invoices when the tax is changed. Allowed values:
true and false. update_recurring_bills
boolean
Update recurring bills when the tax is changed. Allowed values:
true and false. update_draft_so
boolean
Update draft sales orders when the tax is changed. Allowed values:
true and false. update_subscription
boolean
Update subscriptions when the tax is changed. Allowed values:
true and false. update_project
boolean
Update projects when the tax is changed. Allowed values:
true and false.Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695")
.post(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/erp/v3/settings/taxes?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request POST \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"tax_name": "IGST18",
"tax_display_name": "IGST 18%",
"tax_percentage": 18,
"tax_type": "tax",
"tax_factor": "rate",
"tax_specific_type": "igst",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"tax_authority_id": "460000000066001",
"is_value_added": false,
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"purchase_tax_expense_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_account_tracking": "single",
"is_non_advol_tax": false,
"is_state_cess": false,
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"description": "Standard IGST rate",
"update_recurring_invoice": false,
"update_recurring_expense": false,
"update_draft_invoice": false,
"update_recurring_bills": false,
"update_draft_so": false,
"update_subscription": false,
"update_project": false
}
{
"code": 0,
"message": "The tax has been added.",
"tax": {
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_name_formatted": "IGST 18%",
"tax_percentage": 18,
"is_editable": true,
"tax_type": "tax",
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_specific_type": "igst",
"tax_specific_type_desc": "IGST",
"tax_specific_type_version": "1",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"is_state_cess": false,
"is_value_added": false,
"tax_factor": "rate",
"tax_account_tracking": "single",
"output_tax_account_name": "Output CGST",
"purchase_tax_account_name": "Input CGST",
"purchase_tax_expense_account_id": "132086000000107337",
"accounting_app_name": "Zoho Books",
"accounting_reference_id": "132086000000107350",
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active",
"description": "Standard IGST rate",
"reference_id": "REF-001"
}
}
List taxes
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
List simple, compound, and group taxes with pagination and filters.
OAuth Scope : ERP.settings.READ
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
page
integer
Page number to be fetched. Default value is 1.
per_page
integer
Number of records to be fetched per page. Default value is 10.
filter_by
string
Filter taxes. Allowed values include
Taxes.All, Taxes.Active, Taxes.Inactive, Taxes.Isexpired, Type.Tax, Type.Compoundtax, Type.Taxgroup, Type.Tds, and Type.Tdsgroup. Default value is Taxes.Active. tax_type
string
Filter by tax type.
is_tds_request
boolean
Set to
true to list TDS taxes. is_tcs_request
boolean
Set to
true to list TCS taxes. last_modified_time
string
Fetch taxes modified after this time.
tax_ids
string
Comma-separated tax IDs to filter the list.
include_tax_group_details
boolean
Set to
true to include tax group details in the response. sort_column
string
Sort column. Allowed values:
tax_name. sort_order
string
Sort order. Allowed values:
A for ascending and D for descending.headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/settings/taxes?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"taxes": [
{
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_percentage": 18,
"tax_type": "tax",
"tax_specific_type": "igst",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"is_inactive": false,
"is_default_tax": false,
"is_editable": true,
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"is_value_added": false,
"is_non_advol_tax": false,
"tax_factor": "rate",
"output_tax_account_name": "Output CGST",
"purchase_tax_account_name": "Input CGST",
"associated_tax_ids": "982000000566009,982000000566010",
"accounting_app_name": "Zoho Books",
"accounting_reference_id": "132086000000107350",
"status": "active",
"last_modified_time": "2024-04-01T10:30:00+0530",
"description": "Standard IGST rate",
"reference_id": "REF-001"
},
{...},
{...}
],
"page_context": {
"page": 1,
"per_page": 10,
"has_more_page": false,
"report_name": "Taxes",
"applied_filter": "Taxes.Active",
"sort_column": "tax_name",
"sort_order": "A"
}
}
Bulk delete taxes
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Delete multiple taxes by ID.
OAuth Scope : ERP.settings.DELETE
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
tax_ids
string
(Required)
Comma-separated tax IDs to delete.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009,982000000566010"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009%2C982000000566010")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009%2C982000000566010', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009%2C982000000566010", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009%2C982000000566010",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes?organization_id=10234695&tax_ids=982000000566009%2C982000000566010' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "The record has been deleted."
}
Update a tax
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Update the details of a simple or compound tax.
OAuth Scope : ERP.settings.UPDATE
Arguments
tax_id
string
ID of the tax. Note: This value is a set of numeric characters.
Path Parameters
tax_id
string
(Required)
Unique identifier of the tax. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695")
.put(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'PUT',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PUT", "/erp/v3/settings/taxes/982000000566009?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "PUT",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/982000000566009?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request PUT \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"tax_id": "982000000566009",
"tax_name": "IGST18",
"tax_display_name": "IGST 18%",
"tax_percentage": 18,
"tax_type": "tax",
"tax_factor": "rate",
"tax_specific_type": "igst",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"tax_authority_id": "460000000066001",
"is_value_added": false,
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"purchase_tax_expense_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_account_tracking": "single",
"is_non_advol_tax": false,
"is_state_cess": false,
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"description": "Standard IGST rate",
"update_recurring_invoice": false,
"update_recurring_expense": false,
"update_draft_invoice": false,
"update_recurring_bills": false,
"update_draft_so": false,
"update_subscription": false,
"update_project": false
}
{
"code": 0,
"message": "Tax information has been saved.",
"tax": {
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_name_formatted": "IGST 18%",
"tax_percentage": 18,
"is_editable": true,
"tax_type": "tax",
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_specific_type": "igst",
"tax_specific_type_desc": "IGST",
"tax_specific_type_version": "1",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"is_state_cess": false,
"is_value_added": false,
"tax_factor": "rate",
"tax_account_tracking": "single",
"output_tax_account_name": "Output CGST",
"purchase_tax_account_name": "Input CGST",
"purchase_tax_expense_account_id": "132086000000107337",
"accounting_app_name": "Zoho Books",
"accounting_reference_id": "132086000000107350",
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active",
"description": "Standard IGST rate",
"reference_id": "REF-001"
}
}
Get a tax
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Get the details of a simple or compound tax.
OAuth Scope : ERP.settings.READ
Path Parameters
tax_id
string
(Required)
Unique identifier of the tax. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/settings/taxes/982000000566009?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/982000000566009?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"tax": {
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_name_formatted": "IGST 18%",
"tax_percentage": 18,
"is_editable": true,
"tax_type": "tax",
"tax_account_id": "132086000000107333",
"purchase_tax_account_id": "132086000000107337",
"tds_payable_account_id": "132086000000107338",
"tcs_receivable_account_id": "132086000000107339",
"tcs_payable_account_id": "132086000000107340",
"tax_specific_type": "igst",
"tax_specific_type_desc": "IGST",
"tax_specific_type_version": "1",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"is_state_cess": false,
"is_value_added": false,
"tax_factor": "rate",
"tax_account_tracking": "single",
"output_tax_account_name": "Output CGST",
"purchase_tax_account_name": "Input CGST",
"purchase_tax_expense_account_id": "132086000000107337",
"accounting_app_name": "Zoho Books",
"accounting_reference_id": "132086000000107350",
"diff_rate_reason": "tds_non_pan",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active",
"description": "Standard IGST rate",
"reference_id": "REF-001"
}
}
Delete a tax
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Delete a simple or compound tax.
OAuth Scope : ERP.settings.DELETE
Path Parameters
tax_id
string
(Required)
Unique identifier of the tax. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
is_force_delete
boolean
Set to
true to force delete the tax. Default value is false.headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/erp/v3/settings/taxes/982000000566009?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/982000000566009?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "The record has been deleted."
}
Mark a tax as active
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Mark an inactive tax as active.
OAuth Scope : ERP.settings.CREATE
Path Parameters
tax_id
string
(Required)
Unique identifier of the tax. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695")
.post(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("POST", "/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request POST \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/active?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "The tax has been marked as active."
}
Mark a tax as inactive
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Mark an active tax as inactive.
OAuth Scope : ERP.settings.CREATE
Path Parameters
tax_id
string
(Required)
Unique identifier of the tax. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695")
.post(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("POST", "/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request POST \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/982000000566009/inactive?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "The tax has been marked as inactive."
}
List transactions associated with a tax
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
List the transactions that are associated with a specific tax.
OAuth Scope : ERP.settings.READ
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
tax_id
string
(Required)
ID of the tax for which associated transactions are listed. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/settings/taxes/taxtransactions?organization_id=10234695&tax_id=982000000566009' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"transaction_list": [
{
"entity_type": "invoice",
"entity_type_formatted": "Invoice",
"count": 5
},
{...},
{...}
]
}
Create a tax group
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Create a tax group by associating multiple GST taxes.
OAuth Scope : ERP.settings.CREATE
Arguments
tax_group_name
string
(Required)
Name of the tax group.
taxes
string
(Required)
Comma-separated list of tax IDs that are to be associated to the tax group.
tax_type
string
Type of tax. Allowed values:
tax, compound_tax, tds_tax, tcs_tax, tax_on_tax, and gst_tds_tax. start_date
string
Start date of the tax in
yyyy-mm-dd format. end_date
string
End date of the tax in
yyyy-mm-dd format. update_recurring_invoice
boolean
Update recurring invoices when the tax is changed. Allowed values:
true and false. update_recurring_expense
boolean
Update recurring expenses when the tax is changed. Allowed values:
true and false. update_draft_invoice
boolean
Update draft invoices when the tax is changed. Allowed values:
true and false. update_recurring_bills
boolean
Update recurring bills when the tax is changed. Allowed values:
true and false. update_draft_so
boolean
Update draft sales orders when the tax is changed. Allowed values:
true and false. update_subscription
boolean
Update subscriptions when the tax is changed. Allowed values:
true and false.Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxgroups?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxgroups?organization_id=10234695")
.post(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxgroups?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/erp/v3/settings/taxgroups?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxgroups?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request POST \
--url 'https://www.zohoapis.in/erp/v3/settings/taxgroups?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"tax_group_name": "GST 18% Group",
"taxes": "982000000566009,982000000566010",
"tax_type": "tax",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"update_recurring_invoice": false,
"update_recurring_expense": false,
"update_draft_invoice": false,
"update_recurring_bills": false,
"update_draft_so": false,
"update_subscription": false
}
{
"code": 0,
"message": "success",
"tax_group": {
"tax_group_id": "982000000566010",
"tax_group_name": "GST 18% Group",
"tax_group_percentage": 18,
"tax_type": "tax",
"status": "active",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"taxes": [
{
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_percentage": 18,
"tax_type": "tax",
"tax_specific_type": "igst",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active"
}
]
}
}
Update a tax group
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Update the details of a tax group.
OAuth Scope : ERP.settings.UPDATE
Arguments
tax_group_name
string
Name of the tax group.
taxes
string
Comma-separated list of tax IDs that are to be associated to the tax group.
tax_type
string
Type of tax. Allowed values:
tax, compound_tax, tds_tax, tcs_tax, tax_on_tax, and gst_tds_tax. start_date
string
Start date of the tax in
yyyy-mm-dd format. end_date
string
End date of the tax in
yyyy-mm-dd format. update_recurring_invoice
boolean
Update recurring invoices when the tax is changed. Allowed values:
true and false. update_recurring_expense
boolean
Update recurring expenses when the tax is changed. Allowed values:
true and false. update_draft_invoice
boolean
Update draft invoices when the tax is changed. Allowed values:
true and false. update_recurring_bills
boolean
Update recurring bills when the tax is changed. Allowed values:
true and false. update_draft_so
boolean
Update draft sales orders when the tax is changed. Allowed values:
true and false. update_subscription
boolean
Update subscriptions when the tax is changed. Allowed values:
true and false.Path Parameters
tax_group_id
string
(Required)
Unique identifier of the tax group. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695")
.put(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'PUT',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PUT", "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "PUT",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request PUT \
--url 'https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"tax_group_name": "GST 18% Group",
"taxes": "982000000566009,982000000566010",
"tax_type": "tax",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"update_recurring_invoice": false,
"update_recurring_expense": false,
"update_draft_invoice": false,
"update_recurring_bills": false,
"update_draft_so": false,
"update_subscription": false
}
{
"code": 0,
"message": "success",
"tax_group": {
"tax_group_id": "982000000566010",
"tax_group_name": "GST 18% Group",
"tax_group_percentage": 18,
"tax_type": "tax",
"status": "active",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"taxes": [
{
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_percentage": 18,
"tax_type": "tax",
"tax_specific_type": "igst",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active"
}
]
}
}
Get a tax group
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Get the details of a tax group.
OAuth Scope : ERP.settings.READ
Path Parameters
tax_group_id
string
(Required)
Unique identifier of the tax group. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"tax_group": {
"tax_group_id": "982000000566010",
"tax_group_name": "GST 18% Group",
"tax_group_percentage": 18,
"tax_type": "tax",
"status": "active",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"taxes": [
{
"tax_id": "982000000566009",
"tax_display_name": "IGST 18%",
"tax_name": "IGST18",
"tax_percentage": 18,
"tax_type": "tax",
"tax_specific_type": "igst",
"tax_authority_id": "460000000066001",
"tax_authority_name": "Central Board of Indirect Taxes and Customs",
"start_date": "2024-04-01",
"end_date": "2025-03-31",
"status": "active"
}
]
}
}
Delete a tax group
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Delete a tax group. Tax groups associated with transactions cannot be deleted.
OAuth Scope : ERP.settings.DELETE
Path Parameters
tax_group_id
string
(Required)
Unique identifier of the tax group. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url 'https://www.zohoapis.in/erp/v3/settings/taxgroups/982000000566010?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "The tax group has been deleted."
}
Update direct tax settings
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Update direct tax (TDS) settings for the organization.
OAuth Scope : ERP.settings.UPDATE
Arguments
tds_calculation_type
string
TDS calculation type for direct tax settings. Allowed values:
tds_item_level and tds_entity_level. track_tds_liability_from
string
Month and year from which TDS liability is tracked in
mm-yyyy format. default_penalty_account_id
string
Default penalty account ID for TDS. Note: This value is a set of numeric characters.
default_interest_account_id
string
Default interest account ID for TDS. Note: This value is a set of numeric characters.
registration_details
array
TDS registration details to update.
type
string
Registration type. Allowed values:
pan and tan. value
string
Registration value.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695")
.put(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'PUT',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PUT", "/erp/v3/settings/directtaxes?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "PUT",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/directtaxes?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request PUT \
--url 'https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"tds_calculation_type": "tds_item_level",
"track_tds_liability_from": "04-2024",
"default_penalty_account_id": "132086000000107341",
"default_interest_account_id": "132086000000107342",
"registration_details": [
{
"type": "pan",
"value": "ABCDE1234F"
}
]
}
{
"code": 0,
"message": "Direct tax settings have been updated.",
"direct_tax_settings": {
"tds_calculation_type": "tds_item_level",
"track_tds_liability_from": "04-2024",
"default_penalty_account_id": "132086000000107341",
"default_interest_account_id": "132086000000107342",
"default_penalty_account_name": "TDS Penalty",
"default_interest_account_name": "TDS Interest",
"registration_details": [
{
"type": "pan",
"type_formatted": "PAN",
"value": "ABCDE1234F"
}
]
}
}
Get direct tax settings
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Fetch direct tax (TDS) settings for the organization.
OAuth Scope : ERP.settings.READ
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/settings/directtaxes?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/settings/directtaxes?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/settings/directtaxes?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"direct_tax_settings": {
"tds_calculation_type": "tds_item_level",
"track_tds_liability_from": "04-2024",
"default_penalty_account_id": "132086000000107341",
"default_interest_account_id": "132086000000107342",
"default_penalty_account_name": "TDS Penalty",
"default_interest_account_name": "TDS Interest",
"registration_details": [
{
"type": "pan",
"type_formatted": "PAN",
"value": "ABCDE1234F"
}
]
}
}