Salary Revisions
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 Salary Revisions module in Zoho ERP allows you to add and manage salary revisions of employees.
Download Salary Revisions OpenAPI Document
End Points
Attribute
employee_id
string
Unique identifier for the employee.
revision_id
string
Unique identifier for the salary revision.
employee_name
string
The full name of the employee.
employee_number
number
ctc
number
Yearly ctc of the employee.
previous_ctc
number
The employee's CTC before the salary revision.
effective_from
string
The month from which the salary revision is effective. The arrear payment after salary revision, if any will also be calculated from the effective month. Allowed format
YYYY-MM payment_month
string
The month from which the revised salary is being paid. The arrear payment, if any will be paid out during this month. Allowed Format
YYYY-MM revision_status
string
The status of the salary revision.
change_in_percent
number
The updated percentage in salary structure (CTC) of an employee.
{
"employee_id": "36000000012849",
"revision_id": "49774000000241001",
"employee_name": "Anand Maya",
"employee_number": "",
"ctc": 650000,
"previous_ctc": 600000,
"effective_from": "2024-03",
"payment_month": "2024-04",
"revision_status": "pending",
"change_in_percent": 20
}
List Salary Revisions
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 all salary revisions with pagination.
OAuth Scope : ERP.salary.READ
Query Parameters
organization_id
string
(Required)
Unique identifier for the organization.
filter_by
string
Filter salary revisions by status. Allowed Values:
Status.All, Status.Pending, Status.Approved and Status.Rejectedheaders_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v1/salaryrevisions?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/salaryrevisions?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/salaryrevisions?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/salaryrevisions?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/salaryrevisions?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/salaryrevisions?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"salary_revisions": [
{
"employee_id": "36000000012849",
"revision_id": "49774000000241001",
"employee_name": "Anand Maya",
"employee_number": "",
"ctc": 650000,
"previous_ctc": 600000,
"effective_from": "2024-03",
"payment_month": "2024-04",
"revision_status": "pending",
"change_in_percent": 20
},
{...},
{...}
]
}
Get Salary Revision
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
Retrieve a specific salary revision.
OAuth Scope : ERP.salary.READ
Path Parameters
revision_id
string
(Required)
Unique identifier of the revision.
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/salaryrevisions/49774000000241001?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/salaryrevisions/49774000000241001?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/salaryrevisions/49774000000241001?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/salaryrevisions/49774000000241001?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/salaryrevisions/49774000000241001?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/salaryrevisions/49774000000241001?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"salary_revision": {
"effective_from": "2024-03",
"previous_ctc": 600000,
"ctc": 650000,
"revision_status": "pending",
"monthly_salary": 50000,
"change_in_percent": 20,
"employee_id": "36000000012849",
"first_name": "Anand",
"employee_name": "Anand Maya",
"revision_id": "49774000000241001",
"payment_month": "2024-04",
"earnings": [
{
"id": "49774000000236001",
"is_enabled": true,
"amount": 25000,
"is_amount_in_percentage": false,
"amount_in_percentage": 0,
"type": "basic",
"name": "Basic",
"is_included_in_pf": true,
"is_included_in_esi": true
}
],
"benefits": [
{
"id": "49774000000118005",
"is_enabled": true,
"is_amount_in_percentage": true,
"employer_amount_in_percentage": 12,
"employer_amount": "",
"type": "epf_contribution",
"name": "EPF - Employer Contribution",
"is_eligible_for_eps": true,
"is_employee_restricted_basic_enabled": false,
"is_employer_restricted_basic_enabled": true,
"employee_restricted_basic_amount": "",
"employer_restricted_basic_amount": 15000
}
],
"reimbursements": [
{
"id": "49774000000095172",
"is_enabled": true,
"amount": 1000,
"max_limit": 12000,
"carry_forward_option": "monthly",
"type": "fuel",
"name": "Fuel Reimbursement"
}
],
"fbp_components": [
{
"id": "49774000000095174",
"is_enabled": true,
"max_limit": 12000,
"amount": 1200,
"carry_forward_option": "monthly",
"is_opt_in": false,
"type": "telephone",
"name": "Telephone Reimbursement"
}
],
"variable_earnings": [
{
"id": "49774000000095515",
"is_enabled": true,
"amount": 5000,
"type": "bonus",
"name": "bonus",
"is_included_in_esi": true
}
]
}
}