Smart Paste payroll period data

Initiate a Smart Paste on payroll period data on administration level

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

Initiate a Smart Paste operation on payroll period data for all active employments in the given payroll period for the given payroll administration.

post/payrollcomponent/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriods/{payrollPeriodId}/payrollperioddata/smartpaste

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/payrollcomponent/providers/employers/payrolladministrations/{payrollAdministrationId}/payrollPeriods/{payrollPeriodId}/payrollperioddata/smartpaste
  • Auth
    none required

Path parameters

payrollAdministrationIdstring uuid required

The unique identifier of an administration

payrollPeriodIdinteger required
Example:202510

The unique identifier of the payroll period.

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

Example request

{
  "context": {
    "employerId": "0d5327ae-0298-49ae-93b7-19cc9d2acb2f",
    "payrollComponentSet": "ef6d4fec-9118-4dad-9971-3264c6da4ce0",
    "payslipType": 1,
    "pageNumber": 1,
    "pageSize": 250,
    "orderBy": "employee.formattedName,employment.incomeRelationshipNumber",
    "language": "Nederlands"
  },
  "payrollData": [
    {
      "employment": {
        "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
        "payrollId": 2,
        "incomeRelationshipNumber": 12
      },
      "employee": {
        "formattedName": "Jong, I",
        "employeeNumber": 156,
        "firstName": "Susan"
      },
      "payrollPeriod": {
        "year": 2025,
        "periodNumber": 10,
        "periodStartDate": "2025-10-01",
        "periodEndDate": "2025-10-31"
      },
      "shift": {
        "shiftNumber": 1,
        "fullTimeHoursPerWeek": 40,
        "bonusPercentage": 12
      },
      "payslipType": {
        "key": 2,
        "value": "Bijzonder tarief strook"
      },
      "distributionUnit": {
        "key": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
        "code": 2,
        "description": "Sales"
      },
      "costCenter": {
        "key": 2,
        "code": "SAL073",
        "description": "Sales Den Bosch"
      },
      "costUnit": {
        "key": 2,
        "code": "01",
        "description": "Cars"
      },
      "payrollComponents": [
        {
          "payrollComponent": {
            "key": 1,
            "description": "Uren gewerkt",
            "deviatingDescription": "Hoeveelheid uren productief",
            "category": {
              "key": 1,
              "value": "Uren"
            },
            "deductionOrPayment": {
              "key": 2,
              "value": "Betaling"
            }
          },
          "value": 144
        }
      ]
    }
  ],
  "clipboard": {
    "clipboardText": "Mark heeft 8 uur gewerkt op 2025-10-07. Boek 4 uur op component YRWN G3WERLT voor Susan diezelfde dag.",
    "clipboardFiles": [
      {
        "base64Content": "iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAIAAAACUFjqAAAAEklEQVR4nGP8z4APMOGVHbHSAEEsAROxCnMTAAAAAElFTkSuQmCC",
        "mimeType": "image/png"
      }
    ]
  }
}

Response

Created

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "content": {
    "transactionId": "b14acd0d-75d7-4fc8-8b22-4a3924585cab"
  }
}

Changes

No recorded changes to this operation across all 6 revisions of this API.