How to insert salary table via the API

If as a integration partner there is the need to insert a salary table via the API, you can use this article as guidance.

 

A salary table constitutes of the three parts:

  • salary table
  • salary table scale
  • salary table step

To insert one, you can use the call SalaryTable_Insert. Here is a step by step on how to use it: 

1. Get the GuidSalaryTable

First, get the guid of the salary table linked to a specific company using SalaryTable2_Get.

The call will return only the salary table that is set up on Company -> Salary Settings (NL). 

mceclip0.png

2. Get the GuidSalaryTableScale

Use the call SalaryTable2_GetScales to get a list of scales of the company salary table.

 

3. Get the GuidSalaryTableStep

Use the call SalaryTable2_GetSteps to get a list of steps from a specific scale. 

Example:

Get steps from "5 | Schaal 5"

<SalaryTable2_GetSteps xmlns="https://api.nmbrs.nl/soap/v3/CompanyService">
<CompanyId>{{companyId}}</CompanyId>
<Scale>
<Scale>5</Scale>
</Scale>
<Period>11</Period>
<Year>2020</Year>
</SalaryTable2_GetSteps>

1. Insert salary table

Use call SalaryTable_Insert to insert a new salary table

<SalaryTable_Insert xmlns="https://api.nmbrs.nl/soap/v3/EmployeeService">
<EmployeeId>{{employeeId}}</EmployeeId>
<SalaryTableId>{{GuidSalaryTable}}</SalaryTableId>
<SalaryTableScaleId>{{GuidSalaryTableScale}}</SalaryTableScaleId>
<SalaryTableStepId>{{GuidSalaryTableStep}}</SalaryTableStepId>
<StartDate>2020-02-10T00:00:00</StartDate>
</SalaryTable_Insert>

Comments

Knowledge base