REWE Modell mit DATEVconnect per Python on-premises

Zielstellung

• Wir installieren OCT auf einem Server in Ihrem Intranet.

• Wir lesen die DATEV Daten über die im Intranet erreichbare WEBAPI DATEVconnect.

Voraussetzungen

• Sie haben Zugriff auf einen Windows-Server mit Administratorrechten.

• Von diesem Server aus können Sie den DATEVConnect Service mit einem Windows Benutzer erreichen.

• Sie verfügen über den Zugang zu einer SQL Server Datenbank - diese kann sich an einem beliebigen Ort befinden.

Paketkonfigurationen

Zugriff auf DATEV im Browser testen

Testen Sie zunächst, ob Sie den DATEVConnect Webservice vom vorgesehenen Server aus erreichen.

• xxx = Name des DATEV Servers, xxx-yyyy-xxx-ddd = client_id eines DATEV Mandanten

• https://xxxxx:58452/datev/api/accounting/v1/clients → Test des Mandantenabrufs, muss die Liste der relevanten Mandanten liefern, von einem dieser die client_id kopieren

• https://xxxxx:58452/datev/api/accounting/v1/clients/xxx-yyy-xxx-ddd/fiscal-years → Test des Abrufs der Wirtschaftsjahre eines Mandanten

• https://xxxxx:58452/datev/api/accounting/v1/clients/xxx-yyy-xxx-ddd/fiscal-years/20260101/account-postings?filter=account_number ge 10000000 and account_number le 20000000 → Test des Buchungsabrufs, muss die Buchungen auf Konto 1000 bis 2000 liefern (Bereich ggf. anpassen)

• https://xxxxx:58452/datev/api/accounting/v1/clients/xxx-yyy-xxx-ddd/fiscal-years/20260101/account-postings?filter=account_number eq 12345678 and date eq 2026-06-25 → Test des Buchungsabrufs für die Buchungen auf einem Konto an einem Tag

Falls der Browser diese Verbindung noch als unsicher meldet, kann man direkt im Browser das Zertifikat des DATEV Servers exportieren und in die Zertifikatsverwaltung des Computers importieren (Vertrauenswürdige Stammzertifizierungsstellen)

Installation von OCT über Konfigurator

• Konfigurator herunterladen Link

• OCT über Konfigurator installieren

• OCT Datenbank über Konfigurator erstellen

• OCT Konfigurator.exe und Seriennummer nach C:\ProgramData\SaxessSoftware verschieben

Python Laufzeitumgebung einrichten

• Python installieren Link und OCTService nach der Python Installation neu starten.

• ODBC Treiber 18 installieren Link (nur sofern unter den Datenquellen 64 Bit nicht als Treiber vorhanden - ab Windows Server 2025 standardmäßig vorhanden)

• Gateway_DATEVconnect.zip herunterladen, entpacken und unter C:\ProgramData\SaxessSoftware\Gateway_DATEVconnect ablegen Link

• Datei “install libaries (als Admin ausführen).bat” als ebensolcher ausführen

• config.json im Gatewayordner bearbeiten

Einrichtung der OCT Datenbank für die DATEVconnect Staging Daten

• Aus der Modulverwaltung das Modul GATEWAY-DATEVCONNECT-PYTHON einspielen → erstellt die staging.tDATEVCONNECT* Tabellen + Views etc. und die Pipelines GWDC, TRUNCATE, ATR

• Pipeline GWDC konfigurieren

  • Globalen Pipeline Parameter DatenquellenID prüfen → sollte auf DATEV stehen

  • 2x Steps für Containerausführung löschen

  • zuerst nur Step 1 (Steuerungsabfrage) aktivieren und ausführen → Dieser holt das Inhaltsverzeichnis von DATEV ab. → In Produktline “GWDC” auf TAB Steuerungstabelle anschauen und relevante Mandanten merken.

  • in Step 2 (Mandantenaktivierung) die benötigten Mandanten und Jahre im Aktivierungsbefehl konfigurieren → zuerst historische Jahre holen, dann wieder auf den Standard (aktuelles Jahr und das davor) einschränken

  • Step 3 und 4 aktivieren und staging auführen lassen → Diese holen die Daten aus DATEV und konfigurieren den Buchungskreis HGB. Das Ergebnis kann in den Validierungstabellen der Produktline analysiert werden.

Auf dem DATEV System ist man jetzt fertig, die folgenden Schritte können von einem beliebigen PC durchgeführt werden, der die Datenbank erreichen kann.

Einrichtung der OCT Datenbank für das REWE Modell

• REWE Modul und Konnektor einspielen

  • REWE Modell incl. Modellierung über die OCT Modulverwaltung einspielen (Modul “REWE”) → erstellt die integration.tREWE* und result.tREWE* Tabellen + Views etc. und die Pipeline RESULTLOAD, erweitert Pipeline TRUNCATE und ATR

  • Konnektor DATEVconnect_REWE über die OCT Modulverwaltung einspielen (Modul “REWE-KONNEKTOR-GATEWAY-DATEVCONNECT”) → erstellt die Pipeline GWDC

• Modellierung einrichten

  • In TAB “GWDC” die Steuerungstabelle erneut prüfen und sich die dort eingesetzten Kontenrahmen merken.

  • Produkt “HGB Struktur” in die Produktline “MS” kopieren (per Drag & Drop)

  • Jeden benötigten Kontenrahmen aus Produktline “MT” in Produktline “MZ” kopieren (per Drag & Drop)

  • Pipeline “Modellierung” ausführen

• Pipeline für Konnektor konfigurieren

  • Die Konfiguration muss nicht angepasst werden, die Pipeline wird einfach ausgeführt. → Dieser holt die Daten aus staging* nach integration*. Das Ergebnis kann in den Validierungstabellen der Produktline analysiert werden.

• Pipeline RESULTLOAD

  • Die Konfiguration muss nicht angepasst werden, die Pipeline wird einfach ausgeführt. → Dieser holt die Daten aus integration* nach result* . Das Ergebnis kann in den Validierungstabellen der Produktline analysiert werden.

Optionale Komponenten

• Modul “REWE-ADDON-CORPORATE-PLANNER” und “REWE-ADDON-BUCHUNGSKREISMAPPING” einspielen Doku → Dieses bereitet die Daten aus result* für CP auf. Das Ergebnis kann in den Validierungstabellen der Produktline analysiert werden.

• Modul “REWE für Bissantz DeltaMaster” einspielen → Dieses bereitet die Daten aus result* für DeltaMaster auf. Das Ergebnis kann in den Validierungstabellen der Produktline analysiert werden.

Expertenoptionen

Der Prozess verwendet im Normalfall den Windows Zertifikatsspeicher, um das Zertifikat des DATEV Servers einzubinden. Sollte das nicht möglich sein (z.B. weil der DATEV Server in einer anderen Domäne steht etc.), kann das Zertifikat des DATEV Servers auch aus dem Zertifikatsspeicher exportiert und per Datei im Pfad eingebunden werden.

• Zertifikat des DATEV Servers als BASE 64 codiert exportieren und unter C:\ProgramData\SaxessSoftware\datevconnect.cer speichern

In der config Datei gibt es die Option, zwischen Authentifizierung der NTLM und Kerberos umzuschalten. Im Standard funktioniert nur NTLM. Kerberos erfordert eine besondere Konfiguration auf dem DATEV Server und in der Domäne.

Last updated: September 11, 2026