1 General
The JSON Schema API presents the input template for adding new employee master data to and editing the master data of existing employees in HRWorks. Each customer database in HRWorks has a unique set of masters with regard to employee data. Hence, it is imperative that the JSON schema API is conformed to while sending employee data to HRWorks from a third-party system.
1.1 Authentication
Your API calls must contain the API key for the purpose of authentication.
Parameter | Description |
|---|
key | Please contact the HRWorks administrator in your organization for the API key. |
You can generate the API key for your organization yourself.
1.2 Endpoint
https://hinote.in/hrworks/api/v1/employeeJsonSchema?key=<customer_api_key>
You
...
need
...
to
...
use
...
https
...
in
...
your
...
API
...
call.
Please note that the API key must be appended with the URL as a request parameter.
2. Response
If the JSON Schema API call is successful, the API shall return an input template for the addEmployee and editEmployee API. A typical example of the response is as follows.
...
|
| Code Block |
|---|
| {
"title": "Employee JSON Schema in HRWorks", |
|
...
"description": "Employee JSON Schema for HRWorks Employee Input API for xyzco", |
|
...
"createdAt": "2021-07-23T05:38:09.000+000", |
|
...
...
...
...
...
"description": "Employee Id", |
|
...
"required": "true for add employee action" |
|
...
...
...
...
"description": "Employee First Name", |
|
...
"required": "true for add employee action" |
|
...
...
...
...
"description": "Employee Middle Name" |
|
...
...
...
...
"description": "Employee Last Name" |
|
...
...
...
...
"description": "Employee date of birth", |
|
...
...
"required": "true for add employee action" |
|
...
...
...
...
"description": "Employee nationality", |
|
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Father's name of employee", |
|
...
"required": "true, if unmarried and for add employee action" |
|
...
...
...
...
"description": "Marital status of employee", |
|
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Name of employee spouse", |
|
...
"required": "true, if married and for add employee action" |
|
...
...
...
...
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Employee salutation", |
|
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Employee blood group", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Bank name / Bank branch", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "Bank account number" |
|
...
...
...
...
"description": "Name as in bank account" |
|
...
...
...
...
"description": "Date of joining", |
|
...
...
"required": "true for add employee action" |
|
...
...
...
...
"description": "Date of confirmation", |
|
...
...
...
...
...
"description": "PF Join Date", |
|
...
...
...
...
...
"description": "User Id for the emoloyee in HRWorks" |
|
...
...
...
...
"description": "Password to log into HRWorks" |
|
...
...
...
...
"description": "Tax processing group", |
|
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
"priorExperienceMonths": { |
|
...
...
"description": "Prior Experience Months" |
|
...
...
"priorExperienceYears": { |
|
...
...
"description": "Prior Experience Years" |
|
...
...
...
...
...
...
"description": "Permanent Account Number", |
|
...
...
"pattern": "[a-zA-Z]{3}[pP][a-zA-Z][0-9]{4}[a-zA-Z]" |
|
...
...
...
"description": "Provident Fund Number", |
|
...
...
...
...
"description": "Employee State Insurance Number", |
|
...
...
...
...
"description": "Universal Account Number ", |
|
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Relationship with the employee", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Salutation of the dependant", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "First name of the dependant", |
|
...
...
...
...
...
"description": "Middle name of the dependant", |
|
...
...
...
...
"description": "Last name of the dependant", |
|
...
...
...
...
"description": "Date of birth of the dependant", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the id property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "Designation Id", |
|
...
...
...
...
...
...
...
...
"Associate Software Engineer", |
|
...
...
"Business Development - Executive", |
|
...
"Business Intelligence DB Analyst", |
|
...
...
"Client Services Manager", |
|
...
"Communication Coordinator", |
|
...
...
...
...
...
...
"Executive - Call Centre", |
|
...
...
"Executive - Technology Operations", |
|
...
...
"Front Office Associate", |
|
...
...
...
...
...
"Inside Sales Specialist", |
|
...
"IT - Network & Security Admin", |
|
...
"IT Support - Server & Storage Admin", |
|
...
"IT Support - Server Administrator", |
|
...
...
"Manager - Client Relations", |
|
...
"Manager - Operation Support & QA", |
|
...
...
...
"Operations Administrator", |
|
...
"Proj. Manager & Solutions Architect", |
|
...
...
...
"Quality Analyst - Lead", |
|
...
"Quality Analytics Lead", |
|
...
"Quality Assurance Manager", |
|
...
"Security Administrator", |
|
...
...
...
...
"Senior Executive - Quality Control", |
|
...
"Senior Graphics Designer", |
|
...
...
"Senior Product Manager", |
|
...
"Senior Project Manager", |
|
...
...
"Senior Sharepoint Administrator", |
|
...
"Senior Software Engineer", |
|
...
"Senior Software Engineer - Testing", |
|
...
"Senior Software Engineer-IT Support", |
|
...
...
"Senior System Engineer", |
|
...
...
...
"Service Now Administrator", |
|
...
...
"Software Engineer - IT Support", |
|
...
"Software Engineer - Testing", |
|
...
"Software Engineer - Trainee", |
|
...
"Software Engineer-Testing -Trainee", |
|
...
"Software Engineer-Testing-Trainee", |
|
...
...
"Sr Sharepoint Admin - IT Support", |
|
...
"Sr Software Engineer - IT Support", |
|
...
"Sr. Project Mgr - IT Infrastructure", |
|
...
"Sr.Project Mgr - IT Infrastructure", |
|
...
"Sr.System Engineer-Data Base Admin", |
|
...
...
...
...
"System Analyst - Server Admin", |
|
...
...
"System Engineer - Database Admin", |
|
...
"System Engineer - Network Admin", |
|
...
"System Engineer - Operations", |
|
...
"System Engineer -Security Admin", |
|
...
...
"Team Lead - Business Operations", |
|
...
"Technical Lead & Project Manager", |
|
...
"Technical Team Lead & Project Mgr", |
|
...
...
...
"Trainee - Data Analyst", |
|
...
"Trainee Executive - Operation" |
|
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the employeeId property in the items", |
|
...
...
...
...
...
...
...
...
...
"description": "Employee Id of Manager", |
|
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the id property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "EmployeeType Id", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the id property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "Status Id", |
|
...
...
...
...
...
...
...
...
...
...
...
...
"Terminated - On Notice", |
|
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
"description": "Process payroll" |
|
...
...
...
...
"description": "Process payment" |
|
...
...
...
...
"description": "Reason for leaving" |
|
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the id property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "Division Id", |
|
...
...
...
...
...
...
...
"Application Development", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the id property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
"description": "WorkLocation Id", |
|
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the code property in the items", |
|
...
...
...
...
...
...
...
...
...
"description": "Shift Code", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Address Type", |
|
...
...
...
...
...
...
...
...
...
"description": "Address Line 1", |
|
...
...
...
...
...
"description": "Address Line 2", |
|
...
...
...
...
...
...
...
...
...
"description": "Valid state or province code for the specific country", |
|
...
...
...
...
...
"description": "Postal or zip code", |
|
...
...
...
...
...
"description": "2 or 3 letter ISO code for a country", |
|
...
...
...
...
...
"description": "True if primary address", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Email Type as defined in HRWorks", |
|
...
...
...
...
...
...
...
...
...
"description": "Email Id", |
|
...
...
...
...
...
...
...
"description": "True if primary email address", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Phone type as defined in HRWorks", |
|
...
...
...
...
...
...
...
...
...
"description": "Contact number", |
|
...
...
...
...
...
"description": "True if primary contact number", |
|
...
...
...
...
...
...
...
"other.ePS_Contribution": { |
|
...
"description": "EPS_Contribution", |
|
...
...
"required": "true for add employee action", |
|
...
...
...
...
...
...
...
...
"description": "Value can be boolean for add employee action. If boolean, refer to the value property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Is Senior Mgr", |
|
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the value property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"Data update specialist", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"Service Now Developers", |
|
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
...
"description": "Revision Month", |
|
...
...
...
...
...
...
...
...
"description": "Value can be string for add employee action. If string, refer to the value property in the items", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
...
...
"other.totalExpasofApr2016": { |
|
...
"description": "Total Exp as of Apr-2016", |
|
...
...
...
"skills.primaryskills": { |
|
...
"description": "Primary skills", |
|
...
...
...
...
"description": "Configure pay/deduction components. For single pay package, use object type instead of array. For object type, refer to properties inside items.", |
|
...
...
...
...
...
...
...
...
...
"description": "From Date", |
|
...
...
...
...
...
...
"description": "Action to perform. 'Add Full' - Ignore all existing pay packages and consider only the pay/deduction components specified in this package. 'Add Partial' - Consider all existing components and combine the new pay/deduction components specified in this pay package.", |
|
...
...
...
...
...
...
...
...
...
...
"description": "Compensation Details", |
|
...
...
...
...
"description": "Compensation amount for CTC", |
|
...
...
...
...
"description": "Compensation amount for Basic", |
|
...
...
...
...
"description": "Compensation amount for HRA", |
|
...
...
...
...
"description": "Compensation amount for Conveyance", |
|
...
...
...
...
"description": "Compensation amount for Medical", |
|
...
...
...
...
"description": "Compensation amount for Special Allowance", |
|
...
...
...
"childrenEducationAllowance": { |
|
...
"description": "Compensation amount for Children Education Allowance", |
|
...
...
...
...
"description": "Use the keyword 'Configure'/'Inherit' to inherit the organization's business rule for Employer PF. You can also specify a new business rule to override the organization rule for this pay package.", |
|
...
...
...
...
"description": "Use the keyword 'Configure'/'Unconfigure' to configure/unconfigure Staff Loan for this pay package", |
|
...
...
...
...
"description": "Use the keyword 'Configure'/'Unconfigure' to configure/unconfigure Incentive for this pay package", |
|
...
...
...
"leaveTravelAllowance": { |
|
...
"description": "Leave Travel Allowance", |
|
...
...
...
...
"description": "Compensation amount for Leave Travel Allowance", |
|
...
...
...
...
...
"description": "Use the keyword 'Configure'/'Inherit' to inherit the organization's business rule for Leave Travel Allowance. You can also specify a new business rule to override the organization rule for this pay package.", |
|
...
...
...
...
...
...
"description": "Compensation amount for Car Maintenance", |
|
...
...
...
...
"description": "Compensation amount for Driver Salary", |
|
...
...
...
...
"description": "Reimbursement", |
|
...
...
...
...
"description": "Use the keywords ['Configure'/'Unconfigure' or 'Yes/No'] to configure/uncofigure Reimbursement for this pay package", |
|
...
...
...
...
"description": "Claim Procesing Group for any expense claims under this head of pay", |
|
...
...
"required": "true, if the claim is configured in the pay package", |
|
...
...
...
...
...
...
...
...
...
"description": "Use the keyword 'Configure'/'Inherit' to inherit the organization's business rule for Holiday Pay. You can also specify a new business rule to override the organization rule for this pay package.", |
|
...
...
...
"telephoneReimbursement": { |
|
...
"description": "Telephone Reimbursement", |
|
...
...
...
...
"description": "Compensation amount for Telephone Reimbursement", |
|
...
...
...
...
...
"description": "Claim Procesing Group for any expense claims under this head of pay", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
"description": "Deduction Details", |
|
...
...
...
...
"description": "Use the keyword 'Configure'/'Inherit' to inherit the organization's business rule for Employee PF. You can also specify a new business rule to override the organization rule for this pay package.", |
|
...
...
...
...
"description": "Use the keyword 'Configure'/'Inherit' to inherit the organization's business rule for Other Deduction. You can also specify a new business rule to override the organization rule for this pay package.", |
|
...
...
...
...
"description": "Loan Deduction", |
|
...
...
...
...
"description": "Deduction amount for Loan Deduction", |
|
...
...
...
...
...
"description": "The date from which the fixed period deduction should start.", |
|
...
...
...
...
...
...
"description": "The date till which the fixed period deduction should continue.", |
|
...
...
...
...
...
...
...
...
"description": "Parental Insurance", |
|
...
...
...
...
"description": "Deduction amount for Parental Insurance", |
|
...
...
...
...
...
"description": "The date from which the fixed period deduction should start.", |
|
...
...
...
...
...
...
"description": "The date till which the fixed period deduction should continue.", |
|
...
...
...
...
...
...
...
...
"description": "Insurance In-Laws", |
|
...
...
...
...
"description": "Deduction amount for Insurance In-Laws", |
|
...
...
...
...
...
"description": "The date from which the fixed period deduction should start.", |
|
...
...
...
...
...
...
"description": "The date till which the fixed period deduction should continue.", |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
2.1 Response in case of error
In case of error, the API returns the following JSON response:
false "errorMsg": "An error has occurred. Please contact Hinote Customer Support by sending an email to support@hinote.in."
} |
Note:
errorMsg is a string value describing the error.
Status codes are described in
...
the Status Codes section.
3 Coding Examples
3.1 CURL
...
...
#The following command returns employee JSON schema in response.
curl --location --request GET 'https://hinote.in/hrworks/api/v1/employeeJsonSchema?key=<customer_api_key>'
12
3 | #The following command returns employee JSON schema in response.
|
curl --location --request
|
GET