---
title: "Add other payroll variables for an employment"
method: POST
path: "/v2/providers/employers/employees/employments/{employmentId}/otherPayrollVariables"
tags: ["Other payroll variables"]
---

# Add other payroll variables for an employment

`POST /v2/providers/employers/employees/employments/{employmentId}/otherPayrollVariables`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}/otherPayrollVariables`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/PostOtherPayrollVariablesByEmploymentId" target="_blank">PostOtherPayrollVariablesByEmploymentId</a>

Add other payroll variables for an employment.
__Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the POST URL.

__Defaults :__ Default values for a new object can be acquired by adding `/defaults' to the POST URL.

## Path parameters

- `employmentId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Request body

- OtherPayrollVariables2
  - `id` string, uuid: The unique identifier of an object (GUID/UUID)
  - `startDate` string, date: The date on which this record starts. A (broken chain)[./#section/Data/Date-chains] is maintained with this record.
  - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
  - `productivityPercentage` number, double: productivityPercentage (Productiviteitspercentage) can be used to indicate the productivity percentage of an employment.
  - `payrollProperties` object
    - `deviatingPremiumGroup` object, nullable: Deviating premium group (Afwijkende premiegroep sectorfonds), indicates what deviating premie sector funds applies to the employment. Do not specify if there is no deviation from the premium group for the payroll administration the employment is linked to.
      - `key` integer
      - `value` string
    - `wageCostBenefit` object, nullable: Wage cost benefit (loonkostenvoordeel (LKV)). If applicable select the correct option to reduces the costs for an employer to employ the employee. __UWV:__ Het loonkostenvoordeel (LKV) is een onderdeel van de Wet tegemoetkomingen loondomein (Wtl). Het LKV is een tegemoetkoming voor werkgevers die 1 of meer oudere werknemers en/of werknemers met een arbeidsbeperking in dienst nemen of houden.
      - `key` integer
      - `value` string
    - `wajongWithWageDispensation` boolean: wajongWithDispensation (Wajong met loondispensatie (was Doelgroep banenafspraak)) indicates that the employer has the express premission to lower the wage of this employment (even below minimum wage). This indicator will disable the validation on minimum wage for this employment.
    - `phaseClassification` object, nullable: Phase classification (Fase indeling) <to do> Indicatie die aangeeft in welke fase de inkomstenverhouding voor bepaalde tijd zich bevindt in het kader van de Wet Flexibiliteit en Zekerheid.
      - `key` integer
      - `value` string
    - `incidentalIncomeDeduction` object, nullable: Incidental income deduction (Incidentele inkomstenvermindering) <to do> Indien gebruik gemaakt wordt van onbetaald verlof en/of ziekte uren dan wordt automatisch de code incidentele inkomstenvermindering in de loonaangifte bepaald (rubriek in de loonaangifte welke aangeeft dat het loon door ziekte of onbetaald verlof tijdelijk lager is dan het overeengekomen loon). In overige gevallen kan Loket niet automatisch bepalen of er sprake is van een incidentele inkomstenvermindering. In deze rubriek dient dan de juiste waarde ingevuld te worden
      - `key` integer
      - `value` string
    - `terminateIncomenumberFlexibleEmployment` object, nullable: Terminate incomenumber flexible employment (Einde inkomstenverh.Flexwerker) <to do>
      - `key` integer
      - `value` string
    - `applyMinimumWageVocationalLearningPathway` boolean: Minimum wage vocational learning pathway (Minimumloon BBL) <to do>
    - `occupationalDisabilityPremiumDiscount` object, nullable: Occupational disability premium discount (arbeidsgehandicaptenkorting) not to be used after 2017. It indicates if "arbeidsgehandicaptenkorting" is applicable to this employment. Indicatie die aangeeft of er arbeidsgehandicaptenkorting of korting in dienst nemen van ouderen werknemer van toepassing is. Loket zal bij invulling automatisch de juiste kortingen berekenen. Vanaf 2013 zijn alleen nog de codes 5 en 6 van toepassing. Indien codes 1 t/m 4 zijn ingevuld in 2013 dan interpreteert Loket als code 5.
      - `key` integer
      - `value` string
    - `occupationalDisabilityDeductionAfter2009` number, double, nullable: (OccupationalDisability) Deduction after 2009 (Arbeidsgeh.krt na 2009 (tm 2009 WAO)) <to do> Tot en met 2009 moest de premiekorting arbeidsgehandicapte werknemers gesplitst worden in een gedeelte voor de premie WAO/WIA en een gedeelte voor de premie WW-awf of UFO premie. Vanaf 2010 hoeft u het totaalbedrag niet meer te splitsen. Loket zal de bedragen die opgegeven zijn bij Arbeidsgeh.krt na 2009 (tm 2009 WAO) en Arbeidsgeh. krt (tm 2009 AWF/UFO) bij elkaar optellen. U kunt vanaf 2010 dus volstaan met het vullen van Arbeidsgeh.krt na 2009 (tm 2009 WAO). Vanaf 2013 mag dit veld geen waarde meer bevatten, premiekorting arbeidsgehandicapte werknemer wordt automatisch bepaald op basis van opgegeven indicatie bij veld premiekorting
    - `occupationalDisabilityDeductionTo2009` number, double, nullable: (OccupationalDisability) Deduction to 2009 (including 2009) (Arbeidsgeh.krt (tm 2009 AWF/UFO)) Tot en met 2009 moest de premiekorting arbeidsgehandicapte werknemers gesplitst worden in een gedeelte voor de premie WAO/WIA en een gedeelte voor de premie WW-awf of UFO premie. Vanaf 2010 hoeft u het totaalbedrag niet meer te splitsen. Loket zal de bedragen die opgegeven zijn bij Arbeidsgeh.krt na 2009 (tm 2009 WAO) en Arbeidsgeh. krt (tm 2009 AWF/UFO) bij elkaar optellen. U kunt vanaf 2010 dus volstaan met het vullen van Arbeidsgeh.krt na 2009 (tm 2009 WAO). Vanaf 2013 mag dit veld geen waarde meer bevatten, premiekorting arbeidsgehandicapte werknemer wordt automatisch bepaald op basis van opgegeven indicatie bij veld premiekorting
    - `collectiveLaborAgreementCodeHiringEmployer` object, nullable: "CAO code inlener" The CAO code to be used in the payrolltax taxreturn for an employment that is "hired through agents" / " hired through an intermediary/third party". For more information when to set this value please check "Gegevensspecificaties aangifte loonheffingen 2020 v2.0 11 juli 2019"
      - `key` integer
      - `value` string
      - `startDate` string, date: The start date of the CAO
      - `endDate` string, date, nullable: The end date of the CAO
    - `applyYearlyHoursNorm` boolean: applyYearlyHoursNorm (jaarurennorm) indicates if the contract is based on a set numbers of hours per year and a set wage is payed every payroll period.
  - `pensionProperties` object
    - `annualCalculationBaseAbp` number, double, nullable: annualCalculationBase (jaargrondslag voor ABP) for ABP. As of 1-1-2026, this field will no longer be used and must be filled with 0.
    - `leaveAbp` object, nullable: If both `leaveType` and `valueOfParticipationDuringLeave` are empty this parent object will be set to null. The same holds true when puting or posting this object. set `leaveAbp` to null when both `leaveType` and `valueOfParticipationDuringLeave` don't have a value
      - `leaveType` object: Leave type (Verlofsoort ABP) for ABP. <to do>
        - `key` integer
        - `value` string
      - `valueOfParticipationDuringLeave` integer: valueOfParticipation (waardeDeelnemerschap) (pensioen opbouw voor ambtenaren ABP)
    - `deviatingDisabilityInsuranceActPercentageForCordares` object, nullable: deviatingDisabilityInsuranceActPercentageForCordares (WAO % Cordares) used for Cordares. <to do>
      - `key` integer
      - `value` string
    - `applyDispensationRiskFund` boolean: applyDispensationRiskFund (Disp. risicofonds) <to do>
    - `compulsoryEducationDays` integer, nullable: compulsoryEducationDays (Aantal dagen leerplicht) <to do>
    - `occupationalPensionFund` integer, nullable: Occupational Pension Fund (BPF-code) <to do>
    - `specificationOfIncomeRelationshipApg` object, nullable: specificationOfIncomeRelationship (APGVerbijzonderingInkomstenverhouding) used for the APG pension fund. <to do>
      - `key` integer
      - `value` string
      - `code` string
  - `insuranceProperties` object
    - `applicableForNoRiskPolicy` boolean: Indicates if the employment is applicable for the "Looncompensatie bij ziekte (no-riskpolis)" as defined by the UWV. Please check with the UWV to determine when to set the value to true.

## Response `201`

Created

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `content` OtherPayrollVariables2
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: The date on which this record starts. A (broken chain)[./#section/Data/Date-chains] is maintained with this record.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `productivityPercentage` number, double: productivityPercentage (Productiviteitspercentage) can be used to indicate the productivity percentage of an employment.
    - `payrollProperties` object
      - `deviatingPremiumGroup` object, nullable: Deviating premium group (Afwijkende premiegroep sectorfonds), indicates what deviating premie sector funds applies to the employment. Do not specify if there is no deviation from the premium group for the payroll administration the employment is linked to.
        - `key` integer
        - `value` string
      - `wageCostBenefit` object, nullable: Wage cost benefit (loonkostenvoordeel (LKV)). If applicable select the correct option to reduces the costs for an employer to employ the employee. __UWV:__ Het loonkostenvoordeel (LKV) is een onderdeel van de Wet tegemoetkomingen loondomein (Wtl). Het LKV is een tegemoetkoming voor werkgevers die 1 of meer oudere werknemers en/of werknemers met een arbeidsbeperking in dienst nemen of houden.
        - `key` integer
        - `value` string
      - `wajongWithWageDispensation` boolean: wajongWithDispensation (Wajong met loondispensatie (was Doelgroep banenafspraak)) indicates that the employer has the express premission to lower the wage of this employment (even below minimum wage). This indicator will disable the validation on minimum wage for this employment.
      - `phaseClassification` object, nullable: Phase classification (Fase indeling) <to do> Indicatie die aangeeft in welke fase de inkomstenverhouding voor bepaalde tijd zich bevindt in het kader van de Wet Flexibiliteit en Zekerheid.
        - `key` integer
        - `value` string
      - `incidentalIncomeDeduction` object, nullable: Incidental income deduction (Incidentele inkomstenvermindering) <to do> Indien gebruik gemaakt wordt van onbetaald verlof en/of ziekte uren dan wordt automatisch de code incidentele inkomstenvermindering in de loonaangifte bepaald (rubriek in de loonaangifte welke aangeeft dat het loon door ziekte of onbetaald verlof tijdelijk lager is dan het overeengekomen loon). In overige gevallen kan Loket niet automatisch bepalen of er sprake is van een incidentele inkomstenvermindering. In deze rubriek dient dan de juiste waarde ingevuld te worden
        - `key` integer
        - `value` string
      - `terminateIncomenumberFlexibleEmployment` object, nullable: Terminate incomenumber flexible employment (Einde inkomstenverh.Flexwerker) <to do>
        - `key` integer
        - `value` string
      - `applyMinimumWageVocationalLearningPathway` boolean: Minimum wage vocational learning pathway (Minimumloon BBL) <to do>
      - `occupationalDisabilityPremiumDiscount` object, nullable: Occupational disability premium discount (arbeidsgehandicaptenkorting) not to be used after 2017. It indicates if "arbeidsgehandicaptenkorting" is applicable to this employment. Indicatie die aangeeft of er arbeidsgehandicaptenkorting of korting in dienst nemen van ouderen werknemer van toepassing is. Loket zal bij invulling automatisch de juiste kortingen berekenen. Vanaf 2013 zijn alleen nog de codes 5 en 6 van toepassing. Indien codes 1 t/m 4 zijn ingevuld in 2013 dan interpreteert Loket als code 5.
        - `key` integer
        - `value` string
      - `occupationalDisabilityDeductionAfter2009` number, double, nullable: (OccupationalDisability) Deduction after 2009 (Arbeidsgeh.krt na 2009 (tm 2009 WAO)) <to do> Tot en met 2009 moest de premiekorting arbeidsgehandicapte werknemers gesplitst worden in een gedeelte voor de premie WAO/WIA en een gedeelte voor de premie WW-awf of UFO premie. Vanaf 2010 hoeft u het totaalbedrag niet meer te splitsen. Loket zal de bedragen die opgegeven zijn bij Arbeidsgeh.krt na 2009 (tm 2009 WAO) en Arbeidsgeh. krt (tm 2009 AWF/UFO) bij elkaar optellen. U kunt vanaf 2010 dus volstaan met het vullen van Arbeidsgeh.krt na 2009 (tm 2009 WAO). Vanaf 2013 mag dit veld geen waarde meer bevatten, premiekorting arbeidsgehandicapte werknemer wordt automatisch bepaald op basis van opgegeven indicatie bij veld premiekorting
      - `occupationalDisabilityDeductionTo2009` number, double, nullable: (OccupationalDisability) Deduction to 2009 (including 2009) (Arbeidsgeh.krt (tm 2009 AWF/UFO)) Tot en met 2009 moest de premiekorting arbeidsgehandicapte werknemers gesplitst worden in een gedeelte voor de premie WAO/WIA en een gedeelte voor de premie WW-awf of UFO premie. Vanaf 2010 hoeft u het totaalbedrag niet meer te splitsen. Loket zal de bedragen die opgegeven zijn bij Arbeidsgeh.krt na 2009 (tm 2009 WAO) en Arbeidsgeh. krt (tm 2009 AWF/UFO) bij elkaar optellen. U kunt vanaf 2010 dus volstaan met het vullen van Arbeidsgeh.krt na 2009 (tm 2009 WAO). Vanaf 2013 mag dit veld geen waarde meer bevatten, premiekorting arbeidsgehandicapte werknemer wordt automatisch bepaald op basis van opgegeven indicatie bij veld premiekorting
      - `collectiveLaborAgreementCodeHiringEmployer` object, nullable: "CAO code inlener" The CAO code to be used in the payrolltax taxreturn for an employment that is "hired through agents" / " hired through an intermediary/third party". For more information when to set this value please check "Gegevensspecificaties aangifte loonheffingen 2020 v2.0 11 juli 2019"
        - `key` integer
        - `value` string
        - `startDate` string, date: The start date of the CAO
        - `endDate` string, date, nullable: The end date of the CAO
      - `applyYearlyHoursNorm` boolean: applyYearlyHoursNorm (jaarurennorm) indicates if the contract is based on a set numbers of hours per year and a set wage is payed every payroll period.
    - `pensionProperties` object
      - `annualCalculationBaseAbp` number, double, nullable: annualCalculationBase (jaargrondslag voor ABP) for ABP. As of 1-1-2026, this field will no longer be used and must be filled with 0.
      - `leaveAbp` object, nullable: If both `leaveType` and `valueOfParticipationDuringLeave` are empty this parent object will be set to null. The same holds true when puting or posting this object. set `leaveAbp` to null when both `leaveType` and `valueOfParticipationDuringLeave` don't have a value
        - `leaveType` object: Leave type (Verlofsoort ABP) for ABP. <to do>
          - `key` integer
          - `value` string
        - `valueOfParticipationDuringLeave` integer: valueOfParticipation (waardeDeelnemerschap) (pensioen opbouw voor ambtenaren ABP)
      - `deviatingDisabilityInsuranceActPercentageForCordares` object, nullable: deviatingDisabilityInsuranceActPercentageForCordares (WAO % Cordares) used for Cordares. <to do>
        - `key` integer
        - `value` string
      - `applyDispensationRiskFund` boolean: applyDispensationRiskFund (Disp. risicofonds) <to do>
      - `compulsoryEducationDays` integer, nullable: compulsoryEducationDays (Aantal dagen leerplicht) <to do>
      - `occupationalPensionFund` integer, nullable: Occupational Pension Fund (BPF-code) <to do>
      - `specificationOfIncomeRelationshipApg` object, nullable: specificationOfIncomeRelationship (APGVerbijzonderingInkomstenverhouding) used for the APG pension fund. <to do>
        - `key` integer
        - `value` string
        - `code` string
    - `insuranceProperties` object
      - `applicableForNoRiskPolicy` boolean: Indicates if the employment is applicable for the "Looncompensatie bij ziekte (no-riskpolis)" as defined by the UWV. Please check with the UWV to determine when to set the value to true.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)