---
title: "Set DATEV compensations"
method: PUT
path: "/custom/datev/employees/{employee_id}/compensations"
tags: ["Custom Endpoints"]
---

# Set DATEV compensations

`PUT /custom/datev/employees/{employee_id}/compensations`

Sets the compensations for an employee on the specified effective date.

 Other compensations will end at the effective date. That means, if you would like to add a compensation, you also have to include the compensations that you would like to keep.

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

### Example Request Body

```json
{
  "employee_id": "3bdhemmSP1TPQDGWtRveRot9",
  "effective_date": "2022-12-01",
  "compensations": [
    {
      "amount": 4500,
      "currency": "EUR",
      "period": "MONTH",
      "lohnart": 200
    },
    {
      "amount": 30,
      "currency": "EUR",
      "period": "HOUR"
    }
  ]
}
```

## 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

- PutCustomDatevEmployeesEmployeeIdCompensationsRequestBody
  - `effective_date` string, date-time, required — Date from which the submitted compensations should be valid. Please note that it might not be possible to set compensations for the past if the payroll was already run.
  - `compensations` object[], required
    - `amount` number, double, required — The amount that this employee will be paid.
    - `currency` 'EUR', required — The currency in which the employee gets paid. Currently, only euro is supported as integrated systems only work with Euro.
    - `period` 'HOUR' | 'MONTH', required — The period for which the specified amount is paid. Currently, integrated systems only support "HOUR" and "MONTH".
    - `lohnart` integer — The Lohnart that should be used for this compensation. If not specified, the default Lohnart that was requested in the connection flow will be used. Generally Lohnart is only available for monthly compensations.

## Response `200`

PUT /custom/datev/employees/:employee_id/compensations Positive response

- PutCustomDatevEmployeesEmployeeIdCompensationsPositiveResponse
  - `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.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/4700ff777f86/schema)