Tax Settings (India)
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
The Tax Settings module in Zoho ERP allows you to fetch and update organization tax configuration.
Download Tax Settings (India) OpenAPI Document
End Points
Attribute
pan_number
string
PAN number of the organization.
tan_number
string
TAN number of the organization.
tds_circle
string
TDS circle in format
AreaCode/AOType/RangeCode/AONumber. employee_id
string
Unique identifier of the authorized person (employee).
authorized_person_name
string
Name of the authorized person.
authorized_person_parent
string
Father's name of the authorized person.
authorized_person_designation
string
Designation of the authorized person.
deposit_schedule
string
TDS deposit schedule frequency. Allowed values are
monthly and quarterly.{
"pan_number": "AAAAA0000K",
"tan_number": "DELH12345A",
"tds_circle": "DEL/W/123/456",
"employee_id": "36000000012849",
"authorized_person_name": "Anand Maya",
"authorized_person_parent": "Ram Thakur",
"authorized_person_designation": "Finance Manager",
"deposit_schedule": "monthly"
}
Update 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 the organization tax settings.
OAuth Scope : ERP.settings.UPDATE
Arguments
pan_number
string
(Required)
PAN number of the organization.
tan_number
string
TAN number of the organization.
tds_circle
string
TDS circle in format
AreaCode/AOType/RangeCode/AONumber. employee_id
string
Unique identifier of the authorized person (employee).
authorized_person_name
string
Name of the authorized person.
authorized_person_parent
string
Father's name of the authorized person.
authorized_person_designation
string
Designation of the authorized person.
deposit_schedule
string
(Required)
TDS deposit schedule frequency. Allowed values are
monthly and quarterly.Query Parameters
organization_id
string
(Required)
Unique identifier for the organization.
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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"pan_number": "AAAAA0000K",
"tan_number": "DELH12345A",
"tds_circle": "DEL/W/123/456",
"employee_id": "36000000012849",
"authorized_person_name": "Anand Maya",
"authorized_person_parent": "Ram Thakur",
"authorized_person_designation": "Finance Manager",
"deposit_schedule": "monthly"
}
{
"code": 0,
"message": "Your organisation tax details have been updated successfully.",
"income_tax_details": {
"pan_number": "AAAAA0000K",
"tan_number": "DELH12345A",
"tds_circle": "DEL/W/123/456",
"employee_id": "36000000012849",
"authorized_person_name": "Anand Maya",
"authorized_person_parent": "Ram Thakur",
"authorized_person_designation": "Finance Manager",
"deposit_schedule": "monthly"
}
}
Get 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 the organization tax settings.
OAuth Scope : ERP.settings.READ
Query Parameters
organization_id
string
(Required)
Unique identifier for the organization.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?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/v1/settings/incometaxdetails?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"income_tax_details": {
"pan_number": "AAAAA0000K",
"tan_number": "DELH12345A",
"tds_circle": "DEL/W/123/456",
"employee_id": "36000000012849",
"authorized_person_name": "Anand Maya",
"authorized_person_parent": "Ram Thakur",
"authorized_person_designation": "Finance Manager",
"deposit_schedule": "monthly"
}
}