Collective bases for employment fund calculation

Create bases for employment fund calculation for multiple employments

Changed on

Activity name : <a href="https://developer.loket.nl/Activities/PostCollectiveBasesForEmploymentFundCalculationByEmployerId" target="_blank">PostCollectiveBasesForEmploymentFundCalculationByEmployerId</a>

Add a base for employment fund calculation records to multiple employments in one request. The request will be processed as a collective action.

The user can edit the most recent values or add new values. The user cannot edit old records or insert records in between existing records.

post/v2/providers/employers/{employerId}/employees/employments/basesforemploymentfundcalculation

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/v2/providers/employers/{employerId}/employees/employments/basesforemploymentfundcalculation
  • Auth
    none required

Path parameters

employerIdstring uuid required

The unique identifier of the employer

Headers

Authorizationstring required
Example:Bearer <TOKEN>

A valid Bearer token for authorizing the request.

Acceptstring required
Example:application/json;version=2018-01-01

The accept header is used to influence what type of output is returned and in most cases the version of the output

Request body

employmentIdstring uuid

The unique identifier of an object (GUID/UUID)

startDatestring date

The date on which this base for employment fund calculation starts.

A (linked chain)[./#section/Data/Date-chains] per base for calculation is maintained within this resource. So multiple bases can be active at the same time for different payrollcomponents

endDatestring date nullable

The end date of the entity. The date is up to and including.

basenumber double

The base (amount of money) to be used in the fund calculation

Example request

[
  {
    "employmentId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "startDate": "2027-01-01",
    "endDate": "2027-12-31",
    "payrollComponent": {
      "key": 101
    },
    "base": 6
  }
]

Response

OK

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "content": {
    "collectiveActionId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "collectiveActionParentId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "employerId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "payrollAdministrationId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "submittedByUserId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "submittedOn": "2023-05-08T15:16:49+02:00",
    "itemCount": {
      "processedWithError": 10,
      "processed": 75,
      "processedWithWarning": 15,
      "total": 100
    }
  }
}

Changes