General - Get balance for all employees

API Url

Used to get all account balances for all employees user has access.

GET

http://localhost:16010/ProMarkREST/rest/General/account-balances

Permissions: user

Request headers

Field	Type	Description
Accept-Language`optional`	String	=en-GB Language use for localization.
X-Client`optional`	String	=Client type. Allowed values:`"Portal""Mobile""Admin"`
X-Role`optional`	Number	ProMark role (1: Employee, 2: User). Allowed values:`{12}`
X-WebPart-Id`optional`	Number	Unique web-part identifier.

Query parameters

Field	Type	Description
accountId`optional`	String	Optional list of Account IDs with comma separator.
periodType`optional`	Number[1-4]	Type of period (1: Latest closed period, 2: Oldest open period, 3: Current period 4: Current and future periods).

Success 200

Field	Type	Description
response	Object	Main object containing the response data.
accounts`optional`	Object[]	Collection of accounts that belong to a given employee.
balance`optional`	Number	Balance value.
department`optional`	String	Department suffix.
description`optional`	String	Account description.
format`optional`	Number	Account format (1: HH:MM, 4: HH.CC, 7: HH).
group`optional`	String	Employee group.
unit`optional`	Number	Account unit (1: Hours, 2: Days, 3: Pieces).
employees	Object[]	Collection of employees with nested accounts
avatarURI`optional`	String	URI to the employee avatar.
empNo	String	Employee number.
firstName	String	Employee first name.
initials	String	Employee initials.
sortEmpNo	String	Sort employee number.
surname	String	Employee surname.
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 with a single shift:

HTTP/1.1 200 OK
{
   "response": {
     "data": {
       "employees": [
        {
          "empNo": "1",
          "sortEmpNo": "!!!!!1",
          "firstName": "John test",
          "surname": "Doex Test"
        },
        {
          "empNo": "2",
          "sortEmpNo": "!!!!!2",
          "firstName": "2",
          "surname": "2",
          "accounts": [
           {
             "id": "A001",
             "department": "",
             "group": "",
             "balance": 86400,
             "description": "Holidays",
             "shortDescription": "Holiday"
             "unit": 2,
             "format": 1
           },
           {
             "id": "T001",
             "department": "",
             "group": "",
             "balance": 43200,
             "description": "Normal hours",
             "unit": 1,
             "format": 1
           },
           {
            "id": "T002A",
            "department": "",
            "group": "",
            "balance": 81000,
            "description": "Flex",
            "unit": 1,
            "format": 1
           }
          ]
        }
       ]
     },
     "errorCode": 0,
     "errorMessage": ""
   }
}

Error 4xx

Field	Type	Description
response	Object	Main object containing the response data.
data	Object	Object containing the requested data (empty).
errorCode	Number	Error code.
errorMessage	String	Error description.

Error example:

HTTP/1.1 404 Not found
{
   "response": {
      "errorCode": 5,
      "errorMessage": "No employees"
   }
}