---
title: "Prepare DATEV Payroll"
method: PUT
path: "/custom/datev/employees/{employee_id}/prepare-payroll"
tags: ["Custom Endpoints"]
---

# Prepare DATEV Payroll

`PUT /custom/datev/employees/{employee_id}/prepare-payroll`

## Request

- Base URL: `https://api.kombo.dev/v1`
- URL: `https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/prepare-payroll`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kombo/apis/kombo-api/docs/custom/datev/employees/:employee_id/prepare-payroll/put.ts> (a function with typed inputs; its response is checked against the schema)

What DATEV requires to prepare payroll is very specific and currently, as DATEV is not providing "read", this is not part of the unified model.

<Note>
  This endpoint requires the permission **Manage payroll** to be enabled in [your scope config](/scopes).
</Note>

### Example Request Body

```json
{
  "employee_id": "EvLV61zdahkN4ftPJbmPCkdv",
  "payroll_run": {
    "date": "2022-05-01"
  },
  "fixed_payments": [
    {
      "amount": 560,
      "lohnart": 100
    }
  ],
  "hourly_payments": [
    {
      "hours": 14,
      "lohnart": 200
    },
    {
      "hours": 16,
      "lohnart": 232
    }
  ],
  "custom_lodas": [
    {
      "amount": 8,
      "lohnart": 300,
      "bearbeitungsschluessel": 4
    }
  ]
}
```

## Path parameters

- `employee_id` string, required: ID of the employee that should be updated. You can use their Kombo `id` or their ID in the remote system by prefixing it with `remote:` (e.g., `remote:12312`)

## Headers

- `X-Integration-Id` string, required

## Request body

- PutCustomDatevEmployeesEmployeeIdPreparePayrollRequestBody
  - `payroll_run` object, required
    - `date` string, date-time, required: YYYY-MM-DDTHH:mm:ss.sssZ
  - `hourly_payments` object[], required: Add entries for all the hourly calculated supplements here. For example you can write "Overtime" or "Work on Holidays" (in hours here). Unfortunately, DATEV doens't allow showing a lable for the entries.
    - `hours` number, double, required: Number of hours this employee has worked.
    - `lohnart` number, double, required: The "Lohnart" (payment-type) in DATEV. Make sure a Lohnart is selected that actually supports hours.
  - `fixed_payments` object[], required: Add entries for all the fixed supplements here. For example you can write "Bonuses" (in Euros here). Unfortunately, DATEV doens't allow showing a lable for the entries.
    - `amount` number, double, required
    - `lohnart` number, double, required: The "Lohnart" (payment-type) in DATEV. Make sure a Lohnart is selected that actually supports fixed payments (no hourly modifier).
  - `custom_lodas` object[]: Add custom entries to the DATEV Lodas Standard Erfassungstabelle.
    - `amount` number, double, required: This amount value will be mapped to Datev "Wert" field.
    - `lohnart` number, double, required: Choose a valid Lodas Lohnart.
    - `bearbeitungsschluessel` number, double, required: Choose a valid Lodas Bearbeitungsschlüssel. We list the valid Bearbeitungsschlüssel [here](https://storage.googleapis.com/kombo-assets/integrations/datev/lodas_bs.json).

## Response `200`

PUT /custom/datev/employees/:employee_id/prepare-payroll Positive response

- PutCustomDatevEmployeesEmployeeIdPreparePayrollPositiveResponse
  - `status` 'success', required
  - `data` object, required
  - `warnings` object[], required: These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.
    - `message` string, required

## Other responses

- `default`: The standard error response with just the platform error codes.

## Changes

- **2026-07-13** `d0e06abf1118`: 4 breaking, 1 warning, 9 info
  - added the new required request property `fixed_payments`
  - added the new required request property `hourly_payments`
  - added the new required request property `payroll_run`
  - the request's body type changed from no type to `object`
  - …10 more

[Operation history](https://skmtc.dev/kombo/apis/kombo-api/changes/custom/datev/employees/:employee_id/prepare-payroll/put.md)

---

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