Skip to main content
POST
/
custom
/
datev
/
employees
/
{employee_id}
/
download-document
curl --request POST \
  --url https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/download-document \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "accounting_month": "2001-12-01",
  "document_type": "LOJE"
}'
{
  "status": "<string>",
  "data": {
    "data_url": "<string>",
    "file_name": "<string>",
    "content_type": "<string>"
  },
  "warnings": [
    {
      "message": "<string>"
    }
  ]
}
This endpoint requires the permission Manage documents to be enabled in your scope config.

​
Example Request Body

{
  "accounting_month": "2001-12-01",
  "document_type": "LOJE"
}

Authorizations

​
Authorization
string
header
required

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 | null
required

POST /custom/datev/employees/:employee_id/download-document Parameter

Body

application/json

POST /custom/datev/employees/:employee_id/download-document Request body

The data to request an electronic certificate of incapacity for work (eAU).

​
accounting_month
string<date-time>
required

The month to request the document for.

​
document_type
enum<string>
required

Brutto/Netto (LOBN)

Lohnsteuerbescheinigung (german/english) (LSTB/LSTE)

SV-Nachweis (SVNW)

A1-Bescheinigung (ABEG)

Antragsbestätigung A1-Bescheinigung (AANB)

Buchungsbeleg (BUBE)

Lohnjournal (german/english) (LOJO/LJOE)

Lohnsteueranmeldung (LSTA)

Beitragsnachweis (KBNW)

Beitragsnachweis-Erläuterung (SBNW)

Übersicht Zahlungen (ZAKF)

DÜ Zahlungen (PRZA)

Barauszahlungswerte (ZABR)

Überzahlungen-Werte (ZAUW)

Personalkostenübersicht (german/english) (LOPS/LOPE)

Kostenstellenwerte (KOST)

Kostenträgerwerte (KOTR)

Lohnartenwerte einfach/erweitert (LOWE/LOPN)

Lohnkonto (LKTO)

Personalreport (LORE)

Mitarbeiterstammdaten (PDAT)

Pfändungswerte (PFAN)

Darlehenswerte (DAWE)

Wertguthaben je Arbeitnehmer (WEAN)

Available options:
AANB,
ABEG,
BUBE,
DAWE,
KBNW,
KOST,
KOTR,
LKTO,
LOBN,
LJOE,
LOJE,
LOJO,
LOPE,
LOPN,
LOPS,
LORE,
LOWE,
LSTA,
LSTB,
LSTE,
PDAT,
PFAN,
PRZA,
SBNW,
SVNW,
WEAN,
ZABR,
ZAKF,
ZAUW

Response

POST /custom/datev/employees/:employee_id/download-document Positive response

​
status
string
required
Allowed value: "success"
​
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.