PUT
/
custom
/
datev
/
employees
/
{employee_id}
/
prepare-payroll
curl --request PUT \
  --url https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/prepare-payroll \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "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
    }
  ]
}'
{
  "status": "success",
  "data": {}
}

This endpoint requires the permission Manage payroll to be enabled in your scope config.

​
Example Request Body

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

Authorizations

Authorization
string
headerrequired

Create an API key on the Secrets page in the Kombo dashboard.

Headers

X-Integration-Id
string
required

ID of the integration you want to interact with.

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)

Body

application/json
payroll_run
object
required
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.

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.

custom_lodas
object[]

Add custom entries to the DATEV Lodas Standard Erfassungstabelle.

Response

200 - application/json
status
enum<string>
required
Available options:
success
data
object
required
Write raw DATEV ASCII fileSet DATEV compensations