Information about the API
The software provider of the external system is implementing the call to the REST API DATEVconnect online hr-payrollreports (Lohnauswertungsdatenservice). This API enables the download of reports within the HR-domain. The available reports result from the DATEV payroll programs Lohn und Gehalt or LODAS. The scope of data includes:
- 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)
User requirements
The user requires a DATEV authentication medium (e.g. SmartLogin) and the DATEVconnect online contract.
After successful authentication and authorization, the client can fetch the desired reports from the DATEV data center.
Sandbox
The Sandbox-API can be used in order to try out the API without productive data. The detailed specification can be found under “API-Reference”. The available data is limited to certain parameters.
The requests can be sent for the client-id 455148-1, either with the Accept Header application/pdf or application/zip.
These are the possible combinations for the path parameter document_types and the two query parameters period and employee_number (optional):
| document_types | period | employee_number |
|---|---|---|
| LOBN | 2020-09-01 | 1 |
| LSTB | 2020-09-01 | 1 |
| SVNW | 2020-06-01 | 2 |