ProRoster - Get demand matching employees

API Url

Use it for returning a list of employees matching a specific demand, mostly when assigning a demand to employees.

GET

http://localhost:16010/ProMarkREST/rest/ProRoster/demands/{id}/matching-employees

Permissions: user

Path parameters

Field	Type	Description
id	Number	The id of the demand to be verified.

Query parameters

Field	Type	Description
date`optional`	Date	Date of the shift.
empIds`optional`	String	List of empIds separated with comma delimiter.

Success 200

Field	Type	Description
response	Object	Main object containing the response data.
data	Object	Object containing the requested data.
matchingEmployees	Object[]	Array of employees
date	Date	The date in which the demand matches.
empId	String	Employee id
empName	String	Employee full name
empNo	String	Employee number
messages	Object[]	List of messages(info/warning/errors)
code	String	The code of the message.
level	String	The severity of the message. 0=success,1=info,2=warning,3=error
message	String	The text of the message.
message`optional`	Object	Object containing response messages.
code	Number	Message code.
text	String	Message text.
type	String	Type of message. Allowed values:`"warning""info"`

Success example:

HTTP/1.1 200 OK
{
    "response": {
        "data": {
            "matchingEmployees": [
                {
                    "empId": "833",
                    "empNo": "JDO",
                    "empName": "John Doe",
                    "messages":[  
                       {  
                          "level": 2,
                          "code": 49,
                          "message": "Employee's department does not match the demand's department."
                       },
                       {  
                          "level": 1,
                          "code": 113,
                          "message": "The demand matches the employee's preference"
                       }
                    ]
                }
            ]
        },
        "errorCode": 0,
        "errorMessage": ""
    }
}