DATEV Make App
Die Business OS DATEV Custom App für Make.com bringt DATEV Unternehmen Online und DATEV Rechnungswesen als drag-and-drop Module in deine Szenarien — für Beleg-Übertragung, Buchungsvorschläge, Kassenbuch-Einträge, Buchungen, Stammdaten und Auswertungen.
Installation
- Öffne dein Make.com-Team und gehe zu Apps → Add app
- Suche nach Business OS DATEV oder nutze den direkten Link: DATEV App im Make Marketplace
- Klicke Install — die App ist sofort in deinem Szenario-Builder verfügbar
Connection einrichten
Beim ersten Modul-Drop wirst du nach einer Connection gefragt:
| Feld | Wert |
|---|
| Connection Name | Frei wählbar (z.B. “Business OS — Steuerkanzlei XY”) |
| API Key | Dein Org- oder Agency-API-Key aus dem Dashboard (Format bo_xxxxx...) |
Anders als bei der Banking-App gibt es bei DATEV keinen API-Typ-Selector — DATEV hat nur eine API, alle Module nutzen sie.
DATEV Online unterstützt drei verschiedene Anwendungen, jede mit eigenem OAuth-Flow und eigenem Berechtigungsmodell. Du wählst pro Connection im Dashboard, welche DATEV-App du verbinden möchtest:
| DATEV-Tool | Wofür | Module-Familie |
|---|
| DATEV Unternehmen Online (DUO) | Beleg-Upload, Buchungsvorschläge, Kassenbücher — für Mandanten/Buchhalter im Unternehmen | DATEV DUO Module |
| DATEV Rechnungswesen — Write | Buchungen erstellen, Kontakte/Personenkonten anlegen, Belege schreiben — für Steuerberater | DATEV ReWe Write Module |
| DATEV Rechnungswesen — Read | Stammdaten lesen, Summen-und-Salden ziehen, Buchungsdaten auswerten — für Reporting/BI | DATEV ReWe Read Module |
Vor dem ersten Make-Aufruf musst du die jeweilige Connection im Business OS Dashboard per OAuth einrichten — DATEV leitet dich durch den Berater-Login.
Module — DATEV Unternehmen Online (DUO)
| Modul | Beschreibung | Endpoint |
|---|
| Verbindungen | Listet alle DUO-Connections | GET /v2/datev-duo/connections |
| Belegtypen | Liste der verfügbaren Belegtypen (Eingangs-/Ausgangsrechnung, …) | GET /v2/datev-duo/belegtypen |
| Kassenbücher | Liste der Kassenbücher | GET /v2/datev-duo/kassenbuecher |
| Rechnungsordner | Liste der Rechnungsordner (gefiltert nach Typ) | GET /v2/datev-duo/rechnungsordner |
| Beleg bereitstellen | Lädt einen Beleg (PDF, JPG) in einen Rechnungsordner | POST /v2/datev-duo/beleg-bereitstellen |
| Buchungsvorschlag | Erstellt einen Buchungsvorschlag mit Beleg-Bezug | POST /v2/datev-duo/buchungsvorschlag |
| Kassenbuch (einfach) | Erstellt einen Kassenbucheintrag (vereinfacht) | POST /v2/datev-duo/kassenbuch-einfach |
| Kassenbuch (advanced) | Erstellt einen Kassenbucheintrag mit allen Feldern | POST /v2/datev-duo/kassenbuch-advanced |
Module — DATEV Rechnungswesen — Write
| Modul | Beschreibung | Endpoint |
|---|
| Verbindungen | Listet alle ReWe-Write-Connections | GET /v2/datev-rewe/connections |
| Belegtypen | Liste der ReWe-Belegtypen | GET /v2/datev-rewe/belegtypen |
| Steuersätze | Liste der verfügbaren Steuersätze pro Mandant | GET /v2/datev-rewe/steuersaetze |
| Beleg bereitstellen | Lädt einen Beleg in DATEV ReWe | POST /v2/datev-rewe/beleg-bereitstellen |
| Personenkonto | Legt Debitor/Kreditor-Personenkonto an | POST /v2/datev-rewe/personenkonto |
| Buchung | Erstellt eine Buchung im Rechnungswesen | POST /v2/datev-rewe/buchung |
Module — DATEV Rechnungswesen — Read
| Modul | Beschreibung | Endpoint |
|---|
| Verbindungen | Listet alle ReWe-Read-Connections | GET /v2/datev-rewe-read/connections |
| Geschäftsjahre | Listet alle Geschäftsjahre des Mandanten | GET /v2/datev-rewe-read/geschaeftsjahre |
| Geschäftsjahr (Detail) | Details zu einem einzelnen Geschäftsjahr | GET /v2/datev-rewe-read/geschaeftsjahre/{id} |
| Kontenplan | Sach- und Personenkonten für ein Geschäftsjahr | GET /v2/datev-rewe-read/kontenplan |
| Summen und Salden | SuSa-Auswertung | GET /v2/datev-rewe-read/susa |
| Buchungsdaten | Buchungen abrufen (asynchroner Polling-Pattern) | GET /v2/datev-rewe-read/buchungsdaten |
| Zahlungsbedingungen | Zahlungsbedingungen des Mandanten | GET /v2/datev-rewe-read/zahlungsbedingungen |
Multi-Mandanten-Berater (Steuerkanzleien)
Wenn eine Connection mehrere Mandanten umfasst (typischer Steuerberater-Account), kannst du auf den ReWe-Read-Modulen den optionalen Parameter Mandant (companyId) setzen — Format <Beraternummer>-<Mandantennummer>, z.B. 386587-29183.
Wichtig: Ohne Mandant-Angabe nutzt DATEV den beim OAuth gewählten Default-Mandanten. Wenn dieser keine Export-Subscription hat, kommt 403 zurück. Setze in dem Fall den companyId-Parameter explizit auf einen abonnierten Mandanten.
Agency-Keys
Agency-API-Keys arbeiten über mehrere Organisationen. In den DATEV-Modulen findest du den optionalen Parameter Organisation (Agency-Key only) — UUID der Ziel-Organisation:
- Bei Org-Keys: Parameter leer lassen — Org steckt im Key
- Bei Agency-Keys MIT
connection_id: Parameter optional — Backend resolved die Org aus der Connection
- Bei Agency-Keys OHNE
connection_id (z.B. List-Endpunkte): Parameter optional, aber empfohlen zum Filtern
- Bei Agency-Keys auf credit-pflichtige Endpunkte ohne
connection_id: Parameter erforderlich — sonst 400
Beispiel-Szenario: Eingangsrechnung → DATEV DUO
Trigger: Webhook aus deinem ERP, wenn eine Eingangsrechnung den Status “geprüft” erreicht
[ERP-Webhook] → [Belegtypen]
Filter: typ = "Eingangsrechnung"
↓
[Rechnungsordner]
Filter: typ = "Eingangsrechnung"
↓
[Beleg bereitstellen]
belegtyp: {{1.id}}
rechnungsordner: {{2.id}}
datei: {{webhook.pdf}}
↓
[Buchungsvorschlag]
belegBereitstellungsId: {{3.id}}
buchungstext: {{webhook.subject}}
...
Beispiel-Szenario: Monatliche BWA-Auswertung
Trigger: Make-Scheduler am 5. jeden Monats
[Scheduler] → [Verbindungen ReWe-Read]
↓ Iterator
[Geschäftsjahre]
Filter: aktuelles Jahr
↓
[Summen und Salden]
geschaeftsjahrStartDatum: {{2.startDatum}}
↓
[Aggregator / Google Sheet / E-Mail an Geschäftsführer]
Credit-Verbrauch
Pro Modul-Aufruf werden Credits abgebucht:
| Aktion | Credits |
|---|
| Listings (Verbindungen, Belegtypen, Kassenbücher, …) | 0 |
| Get-Operationen | 0 |
| Beleg bereitstellen (DUO + ReWe) | 1 |
| Buchungsvorschlag (DUO) | 1 |
| Kassenbuch-Eintrag (DUO) | 1 |
| Personenkonto (ReWe) | 1 |
| Buchung (ReWe) | 1 |
| ReWe-Read Operationen | 1 |
Der business-os.neuesGuthaben im Response zeigt das verbleibende Guthaben.
Troubleshooting
“RVO-Recht fehlt: Stammdaten” / “Auswertungen Export” (403) — Der Steuerberater muss in DATEV RVO für deinen User auf dem Mandanten die entsprechenden Rechte-Bündel freischalten.
“datev_export_service_missing” (402) — Der Mandant hat keine DATEV-Rechnungswesen-Export-Subscription. Bei Multi-Mandanten-Connections per companyId-Parameter auf einen abonnierten Mandanten umschalten.
“datev_token_expired” (401) — OAuth-Token ist abgelaufen. Im Dashboard auf die DATEV-Card → Erneut verbinden klicken.
Buchungsdaten bleibt “PENDING” (504) — Asynchroner Job läuft noch. Make wiederholt den Call automatisch nach 30 Sekunden — pro Iterator-Run werden bis zu 3 Polls gemacht.
Source
Die DATEV-Make-App wird von Richard maintained und lebt in einem separaten Repo. Issues und Module-Wünsche: impressum@business-os.de — wir leiten sie weiter.