Payroll - Get periods

API Url

Use it to return a lookup for peiods

GET
http://localhost:16010/ProMarkREST/web/Payroll/periods

Permissions: user

Request headers

FieldTypeDescription
Accept-LanguageoptionalString

=en-GB Language use for localization.

X-ClientoptionalString

=Client type.

Allowed values:"Portal""Mobile""Admin"
X-RoleoptionalNumber

ProMark role (1: Employee, 2: User).

Allowed values:{12}
X-WebPart-IdoptionalNumber

Unique web-part identifier.

Query parameters

FieldTypeDescription
allowRunBoolean

If true only return periods where it is allowed to run next step If stage is not defined, the parameter is ignored.

stageNumber

Stage of payroll closure: 0: Not started, 1: Preliminary Report, 2: Validated with errors, 3: Validated, 4: Final Report completed, 5: Payroll transferred, 6: Period closed with errors, 7: Period closed. If not defined, returns all.

Success 200

FieldTypeDescription
    periodsObject[]
      descriptionString

Description of the period profile.

      endDateTime

End time of the period.

      finalCloseDateTime

Time of the completed closure of the period.

      firstValidationDateTime

Time of the first validation on the current period profile.

      idString

Period profile id.

      numberOfEmployeesNumber

Total number of employee under the current period profile.

      stageNumber

Stage of payroll closure: 0: Not started, 1: Preliminary Report, 2: Validated with errors, 3: Validated, 4: Final Report completed, 5: Payroll transferred, 6: Period closed with errors, 7: Period closed.

      startDateTime

Start time of the period.

      statusNumber

1: Open, 2: under validation and 3: closed.

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.