HRMS

PreviousDSS Ingest NextNational Dashboard Ingest

Last updated 9 months ago

All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

Get the list of employees defined in the system.

Get the employee list based on the input parameters. Response will give the minimum set of information related to the employee.

POST/rainmaker-hrms/[API endpoint]/employees/_search

Query parameters

Body

Common request info for getting employee.

any

Response

Successful response

Body

Employeearray of Employee (object)

Request

Response

Create a new employee in the system along with all the related informations like - assignment, jurisdiction, service, education and probation

To create a new employee we can use POST and set all the required and non-mandatory parameters. When an employee is created, an user is also created along with it. Type value in object will be "EMPLOYEE".

POST/rainmaker-hrms/[API endpoint]/employees/_create

Body

Details for the new employee.

Employee*array of Employee (object)

Response

Employee request accepted for creation.

Body

Employeearray of Employee (object)

Request

Response

Update Employee data for a particular employee

To update an existing employee's employee details and all other details like assignment, jurisdiction, qualification service details and porbation. This API will also be used for deactivating an employee

POST/rainmaker-hrms/[API endpoint]/employees/_update

Body

Request header for the employee with new of values.

Employee*array of Employee (object)

Response

Employee request accepted for update.

Body

Employeearray of Employee (object)

Request

Response

Get the list of count of active and inactive employee.

Get the list of count of active and inactive employee for given tenant Id.

POST/rainmaker-hrms/[API endpoint]/employees/_count

Query parameters

Response

Successful response, present the list of count of active and inactive employee for given tenant Id.

Body

responseInfoResponseHeader (object)

ResponseHeader should be used to carry metadata information about the response from the server. apiId, ver and msgId in ResponseHeader should always correspond to the same values in respective request's RequestHeader.

EmployeeCountEmployeeCount (object)

Capture the employee count details

Request

Response

{
  "responseInfo": {
    "resMsgId": "text",
    "msgId": "text",
    "status": "COMPLETED",
    "signature": "text",
    "error": {
      "code": "text",
      "message": "text",
      "description": "text",
      "params": [
        "text"
      ]
    }
  },
  "EmployeeCount": {
    "activeEmployee": "text",
    "inactiveEmployee": "text",
    "totalEmployee": "text"
  }
}

const response = await fetch('/rainmaker-hrms/[API endpoint]/employees/_create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "Employee": [
        {
          "jurisdictions": [
            {
              "hierarchy": "text",
              "boundary": "text",
              "boundaryType": "text"
            }
          ],
          "assignments": [
            {
              "department": "text",
              "designation": "text"
            }
          ],
          "employeeStatus": "text",
          "employeeType": "text",
          "tenantId": "text"
        }
      ]
    }),
});
const data = await response.json();

{
  "Employee": [
    {
      "uuid": "text",
      "code": "text",
      "employeeStatus": "text",
      "employeeType": "text",
      "dateOfAppointment": 0,
      "jurisdictions": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "hierarchy": "text",
          "boundary": "text",
          "boundaryType": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "assignments": [
        {
          "id": "text",
          "designation": "text",
          "department": "text",
          "govtOrderNumber": "text",
          "reportingTo": "text",
          "isHOD": false,
          "isCurrentAssignment": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "serviceHistory": [
        {
          "id": "text",
          "serviceStatus": "text",
          "location": "text",
          "orderNo": "text",
          "isCurrentPosition": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "isActive": false,
      "education": [
        {
          "id": "text",
          "qualification": "text",
          "stream": "text",
          "university": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tests": [
        {
          "id": "text",
          "test": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tenantId": "text",
      "deactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForDeactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "reactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForReactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "documents": [
        {
          "documentId": "text",
          "documentName": "text",
          "referenceType": "text",
          "referenceId": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text"
      }
    }
  ]
}

const response = await fetch('/rainmaker-hrms/[API endpoint]/employees/_search?phone=text&isActive=false&tenantid=text', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
});
const data = await response.json();

{
  "Employee": [
    {
      "uuid": "text",
      "code": "text",
      "employeeStatus": "text",
      "employeeType": "text",
      "dateOfAppointment": 0,
      "jurisdictions": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "hierarchy": "text",
          "boundary": "text",
          "boundaryType": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "assignments": [
        {
          "id": "text",
          "designation": "text",
          "department": "text",
          "govtOrderNumber": "text",
          "reportingTo": "text",
          "isHOD": false,
          "isCurrentAssignment": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "serviceHistory": [
        {
          "id": "text",
          "serviceStatus": "text",
          "location": "text",
          "orderNo": "text",
          "isCurrentPosition": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "isActive": false,
      "education": [
        {
          "id": "text",
          "qualification": "text",
          "stream": "text",
          "university": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tests": [
        {
          "id": "text",
          "test": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tenantId": "text",
      "deactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForDeactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "reactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForReactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "documents": [
        {
          "documentId": "text",
          "documentName": "text",
          "referenceType": "text",
          "referenceId": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text"
      }
    }
  ]
}

const response = await fetch('/rainmaker-hrms/[API endpoint]/employees/_update', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "Employee": [
        {
          "jurisdictions": [
            {
              "hierarchy": "text",
              "boundary": "text",
              "boundaryType": "text"
            }
          ],
          "assignments": [
            {
              "department": "text",
              "designation": "text"
            }
          ],
          "employeeStatus": "text",
          "employeeType": "text",
          "tenantId": "text"
        }
      ]
    }),
});
const data = await response.json();

{
  "Employee": [
    {
      "uuid": "text",
      "code": "text",
      "employeeStatus": "text",
      "employeeType": "text",
      "dateOfAppointment": 0,
      "jurisdictions": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "hierarchy": "text",
          "boundary": "text",
          "boundaryType": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "assignments": [
        {
          "id": "text",
          "designation": "text",
          "department": "text",
          "govtOrderNumber": "text",
          "reportingTo": "text",
          "isHOD": false,
          "isCurrentAssignment": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "serviceHistory": [
        {
          "id": "text",
          "serviceStatus": "text",
          "location": "text",
          "orderNo": "text",
          "isCurrentPosition": false,
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "isActive": false,
      "education": [
        {
          "id": "text",
          "qualification": "text",
          "stream": "text",
          "university": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tests": [
        {
          "id": "text",
          "test": "text",
          "remarks": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "tenantId": "text",
      "deactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForDeactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "reactivationDetails": [
        {
          "id": "text",
          "employeeId": "text",
          "reasonForReactivation": "text",
          "orderNo": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "documents": [
        {
          "documentId": "text",
          "documentName": "text",
          "referenceType": "text",
          "referenceId": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text"
          }
        }
      ],
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text"
      }
    }
  ]
}