Skip to main content

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

  1. Öffne dein Make.com-Team und gehe zu AppsAdd app
  2. Suche nach Business OS DATEV oder nutze den direkten Link: DATEV App im Make Marketplace
  3. Klicke Install — die App ist sofort in deinem Szenario-Builder verfügbar

Connection einrichten

Beim ersten Modul-Drop wirst du nach einer Connection gefragt:
FeldWert
Connection NameFrei wählbar (z.B. “Business OS — Steuerkanzlei XY”)
API KeyDein 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.

Tool-Auswahl: 3 DATEV-Welten

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-ToolWofürModule-Familie
DATEV Unternehmen Online (DUO)Beleg-Upload, Buchungsvorschläge, Kassenbücher — für Mandanten/Buchhalter im UnternehmenDATEV DUO Module
DATEV Rechnungswesen — WriteBuchungen erstellen, Kontakte/Personenkonten anlegen, Belege schreiben — für SteuerberaterDATEV ReWe Write Module
DATEV Rechnungswesen — ReadStammdaten lesen, Summen-und-Salden ziehen, Buchungsdaten auswerten — für Reporting/BIDATEV 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)

ModulBeschreibungEndpoint
VerbindungenListet alle DUO-ConnectionsGET /v2/datev-duo/connections
BelegtypenListe der verfügbaren Belegtypen (Eingangs-/Ausgangsrechnung, …)GET /v2/datev-duo/belegtypen
KassenbücherListe der KassenbücherGET /v2/datev-duo/kassenbuecher
RechnungsordnerListe der Rechnungsordner (gefiltert nach Typ)GET /v2/datev-duo/rechnungsordner
Beleg bereitstellenLädt einen Beleg (PDF, JPG) in einen RechnungsordnerPOST /v2/datev-duo/beleg-bereitstellen
BuchungsvorschlagErstellt einen Buchungsvorschlag mit Beleg-BezugPOST /v2/datev-duo/buchungsvorschlag
Kassenbuch (einfach)Erstellt einen Kassenbucheintrag (vereinfacht)POST /v2/datev-duo/kassenbuch-einfach
Kassenbuch (advanced)Erstellt einen Kassenbucheintrag mit allen FeldernPOST /v2/datev-duo/kassenbuch-advanced

Module — DATEV Rechnungswesen — Write

ModulBeschreibungEndpoint
VerbindungenListet alle ReWe-Write-ConnectionsGET /v2/datev-rewe/connections
BelegtypenListe der ReWe-BelegtypenGET /v2/datev-rewe/belegtypen
SteuersätzeListe der verfügbaren Steuersätze pro MandantGET /v2/datev-rewe/steuersaetze
Beleg bereitstellenLädt einen Beleg in DATEV ReWePOST /v2/datev-rewe/beleg-bereitstellen
PersonenkontoLegt Debitor/Kreditor-Personenkonto anPOST /v2/datev-rewe/personenkonto
BuchungErstellt eine Buchung im RechnungswesenPOST /v2/datev-rewe/buchung

Module — DATEV Rechnungswesen — Read

ModulBeschreibungEndpoint
VerbindungenListet alle ReWe-Read-ConnectionsGET /v2/datev-rewe-read/connections
GeschäftsjahreListet alle Geschäftsjahre des MandantenGET /v2/datev-rewe-read/geschaeftsjahre
Geschäftsjahr (Detail)Details zu einem einzelnen GeschäftsjahrGET /v2/datev-rewe-read/geschaeftsjahre/{id}
KontenplanSach- und Personenkonten für ein GeschäftsjahrGET /v2/datev-rewe-read/kontenplan
Summen und SaldenSuSa-AuswertungGET /v2/datev-rewe-read/susa
BuchungsdatenBuchungen abrufen (asynchroner Polling-Pattern)GET /v2/datev-rewe-read/buchungsdaten
ZahlungsbedingungenZahlungsbedingungen des MandantenGET /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:
AktionCredits
Listings (Verbindungen, Belegtypen, Kassenbücher, …)0
Get-Operationen0
Beleg bereitstellen (DUO + ReWe)1
Buchungsvorschlag (DUO)1
Kassenbuch-Eintrag (DUO)1
Personenkonto (ReWe)1
Buchung (ReWe)1
ReWe-Read Operationen1
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.