ProRoster - Get planned co-workers

API Url

This api is used to load employees that have overlapping demands/tasks with you.

GET
http://localhost:16010/ProMarkREST/rest/ProRoster/employees/{id}/co-workers

Permissions: user

Path parameters

FieldTypeDescription
idNumber

The employee's unique identifier.

Query parameters

FieldTypeDescription
dateoptionalString

the date on which you want to see the co-workers

Parameter

FieldTypeDescription
        ignoreDayProfileoptionalObject[]
          isLockedBoolean

Is the attribute locked.

          valueBoolean

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    employeesObject[]
      assignedDemandsoptionalObject[]

Collection of demands (only when expand=demands).

        acceptBeforeoptionalObject[]
          daysoptionalNumber

Accept days before shift takes place.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        approvalGroupoptionalObject[]
          descriptionoptionalString

Description of the approvalGroup.

          idoptionalString

Id of the approvalGroup.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        assignmentMethodoptionalObject[]
          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

          methodoptionalString

Assignment methode Automatic = "A" or Manual "M".

        backColorString

BackGround color in HEX without #.

        baseDemandIdNumber

The Id of the base demand from which the demand was created.

        categoryoptionalObject[]
          descriptionoptionalString

Description of the category.

          idoptionalString

Id of the category.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        dateDate

The date of the demand .

        dayProfileoptionalObject[]

The day profile object.

          backColoroptionalString

BackGround color.

          descriptionString

Description of the day profile.

          endTimeoptionalNumber

Normal time end of day profile.

          foreColoroptionalString

ForeGround color.

          idoptionalString

Day profile ID.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

          isVariableBoolean

True if day profile is variable.

          startTimeoptionalNumber

Normal time start of day profile.

        departmentoptionalObject[]
          descriptionoptionalString

Description of the department.

          idoptionalString

Id of the department.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        descriptionString

Description of the demand.

        empIdString

The Id of the employee assigned to a demand.

        foreColorString

ForeGround color in HEX without #.

        groupoptionalObject[]
          descriptionoptionalString

Description of the group.

          idoptionalString

Id of the group.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        idNumber

The Id of the demand.

        isPublishedBoolean

False = the assigned demand is not published. True = the assigned demand is published.

        isTaskBoolean

True if demand is task, false if not.

        maximumBidsoptionalObject[]
          amountoptionalNumber

Number of employees to bid in.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        nameString

The name of the demand .

        normalTimeoptionalObject[]

Normal time interval for variable day profiles.

          endTimeoptionalNumber

End time of the interval in seconds.

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

          startTimeoptionalNumber

Start time of the interval in seconds.

        planIdNumber

The Id of the plan.

        qualificationSetupoptionalObject[]
          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

          qualificationoptionalObject[]
            descriptionoptionalString

Description of the qualification.

            empQualIdoptionalString

Id of the employee qualification.

            idoptionalNumber

Id of the demand qualification.

            orderoptionalNumber

Order of qualifications.

            primaryoptionalBoolean

true = This is a primary qualification.

        requiredEmployeesObject[]
          amountNumber

Number of employees

          isLockedBoolean

Is the attribute locked.

          isRequiredBoolean

Is the attribute required.

        versionNumber

Version number of the demand.

      empIdoptionalString

The Id of the employee.

      empNameoptionalString

First name + Last name.

      empNooptionalString

The number of the employee.

      initialsoptionalString

Employee's initials.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"employees": [
{
"empId: "833",
"empNo: "CMD1",
"fullName: "Ciprian Dinu 1",
"initials: "CMD1",
"assignedDemands": [
{
"id": 2153908066,
"planId": 2153557517,
"name": "Weld",
"empId": "893",
"description": "Welder",
"foreColor": "000040",
"backColor": "000050",
"version": 1,
"dayProfile": [
{
"id": "DAY",
"startTime": 46800,
"endTime": 61200,
"description": "Day Shift 13:00 - 17:00",
"isVariable": false,
"foreColor": "000080",
"backColor": "00FF40",
"isRequired": false,
"isLocked": true
}
],
"requiredEmployees": [
{
"amount": 5,
"isRequired": true,
"isLocked": true
}
],
"department": [
{
"id": "0000007215",
"description": "SAP-HR-department 15",
"isRequired": false,
"isLocked": true
}
],
"assignmentMethod": [
{
"isRequired": false,
"isLocked": false
}
],
"group": [
{
"id": "1",
"description": "BH1",
"isRequired": false,
"isLocked": true
}
],
"approvalGroup": [
{
"id": "01",
"description": "Kem Default",
"isRequired": true,
"isLocked": true
}
],
"maximumBids": [
{
"amount": 10,
"isRequired": true,
"isLocked": true
}
],
"category": [
{
"id": "02",
"description": "Part-day absence",
"isRequired": false,
"isLocked": true
}
],
"acceptBefore": [
{
"days": 2,
"isRequired": false,
"isLocked": true
}
],
"qualificationSetup": [
{
"isRequired": true,
"isLocked": true,
"qualifications": [
{
"id": "1",
"description": "Welding certificate f",
"primary": true,
"order": 1
},
{
"id": "2",
"description": "Truck certificate",
"primary": true,
"order": 2
}
]
}
]
}
]
] ,
"errorCode": 0,
"errorMessage": ""
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.