ProRoster - Account balances multiple empl.

API Url

Used to get all account balances for a list of employees, According to each plan setup, it gets current , primo, ultimo ,delta.

GET
http://localhost:16010/ProMarkREST/rest/ProRoster/plans/{id}/account-balances

Permissions: user

Path parameters

FieldTypeDescription
idNumber

The plan Id.

Query parameters

FieldTypeDescription
empIdsoptionalString

Comma seperated list of employee ids. if not sent the employees of the current plans are loaded.

fromoptionalDate

If not sent it is set to the beginning of the current week.

tooptionalDate

If not sent it is set to the end of the current week.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

    accountBalancesObject[]

Collection with account balance data.

      accountIdString

Account ID.

      currentBalanceString

The current balance for the account.

      deltaNumber

The difference between ultimo and primo.

      empIdString

Employee Id.

      formatNumber

Account format ("HH:MM", "HH.CC", ".1", ".2" and so on).

      isGroupBoolean

If true the accountId is the Id of an account group.

      primoNumber

The first balance of the period.

      ultimoString

The last balance of the period.

      unitNumber

Account unit (1: Hours, 2: Days, 3: Pieces).

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example with a single shift:

HTTP/1.1 200 OK
{
"response": {
"data": {
"accountBalances": [
{
"empId": "1000",
"accountId": "T001",
"isGroup": false,
"currentBalance": 0,
"primo": null,
"ultimo": null,
"delta": null,
"unit": 1,
"format": "HH:MM"
}
]
},
"erorCode": 0,
"errorMessage": ""
}
}