DATEV Payroll
Prepare DATEV Payroll
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.
PUT
/
custom
/
datev
/
employees
/
{employee_id}
/
prepare-payroll
Authorization
Header
Path
Body
curl --request PUT \
--url https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/prepare-payroll \
--header 'Authorization: <authorization>' \
--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
}
]
}'
{
"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
}
]
}
Authorizations
Authorization
string
headerrequiredCreate an API key on the Secrets page in the Kombo dashboard.
Headers
X-Integration-Id
string
requiredID of the integration you want to interact with.
Path Parameters
employee_id
string
requiredID 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
requiredhourly_payments
object[]
requiredAdd 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[]
requiredAdd 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.
Response
200 - application/json
status
enum<string>
requiredAvailable options:
success
data
object
requiredcurl --request PUT \
--url https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/prepare-payroll \
--header 'Authorization: <authorization>' \
--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
}
]
}'
{
"status": "success",
"data": {}
}