---
title: "Download Payroll Document"
method: POST
path: "/custom/datev/download-document"
tags: ["Custom Endpoints"]
---

# Download Payroll Document

`POST /custom/datev/download-document`

Download a document from DATEV

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

### Example Request Body

```json
{
  "accounting_month": "2001-12-01",
  "document_type": "LOJE",
  "employee_id": null
}
```

## Headers

- `X-Integration-Id` string, required

## Request body

- PostCustomDatevDownloadDocumentRequestBody — 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` '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', 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)
  - `employee_id` string, nullable, required

## Response `200`

POST /custom/datev/download-document Positive response

- PostCustomDatevDownloadDocumentPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `data_url` string, uri, required — The URL to download the document from.
    - `file_name` string, required
    - `content_type` string, 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/149bf44faf1a/schema)