DATEV-Proxy-Verbindung aktivieren (Beta Feature)

Bitte beachten Sie, dass sich diese Funktion derzeit noch in der Beta-Phase befindet.

Die Proxy-Verbindung für DATEV beschleunigt den Datenabruf und reduziert die Last auf die DATEV API.

Warum eine Proxy-Verbindung verwenden?

Schutz der DATEV API: Ohne Proxy greifen alle Nutzer direkt auf die DATEV API zu. Mit der Proxy-Verbindung werden alle Anfragen zentral über einen Cache verarbeitet, der im Hintergrund regelmäßig aktualisiert wird. Dadurch wird die Anzahl der API-Aufrufe deutlich reduziert.
Schnellere Datenabfragen: Daten werden direkt aus dem Speicher bereitgestellt. Auch abgelaufene Einträge werden sofort angezeigt und anschließend im Hintergrund aktualisiert.
Sicheres Design: Die Proxy-Verbindung verarbeitet ausschließlich Lesezugriffe. Anmeldungen sowie das Schreiben von Zeiteinträgen erfolgen weiterhin direkt über DATEV mit der Identität des jeweiligen Nutzers. Fällt der Proxy aus, bleibt Login und Zeiterfassung weiterhin funktionsfähig, da automatisch direkt auf DATEV zugegriffen wird.

Schritt 1: Service User in Memtime hinzufügen

Dieser Schritt ist verpflichtend.

Die Proxy-Verbindung authentifiziert sich bei DATEV über einen zentralen Service User. Erst wenn ein Service User vorhanden ist, wird die Option zur Aktivierung des Proxys in der Memtime App angezeigt.

Detaillierte Anweisungen zum Hinzufügen eines Service Users finden Sie hier:

🔗 Service User für Memtime einrichten

Ohne Service User werden die Proxy-Optionen in Memtime ausgeblendet.

Schritt 2: DATEV Proxy-Verbindung aktivieren

Dieser Schritt wird vom Memtime-Administrator durchgeführt.

Stellen Sie sicher, dass die Proxy-Konfiguration korrekt vorbereitet ist, bevor Sie fortfahren.

1. Öffnen Sie die Memtime App. Navigieren Sie zu:

Menu Icon (☰) → Connected Apps

2. Öffnen Sie die Integration DATEV EO Comfort. Scrollen Sie zu Erweiterte Einstellungen.

3. Klicken Sie auf Beta Version des Proxys aktivieren.

4. Klicken Sie anschließend auf Aktivieren.

Nach der Aktivierung schließt sich das Fenster automatisch. Danach steht die Option Proxy einrichten zur Verfügung, die in Schritt 5 benötigt wird.

Schritt 3: Proxy-Download-Link erhalten

Der Proxy-Download-Link ist nicht öffentlich verfügbar.

Bitte kontaktieren Sie unser Support-Team unter: support@memtime.com.

Bitte geben Sie dabei folgende Informationen an:

Firmenname
E-Mail-Adresse Ihres Memtime-Kontos
Kurze Beschreibung des Anwendungsfalls

Unser Team stellt Ihnen anschließend den passenden Download-Link sowie gegebenenfalls zusätzliche Setup-Anweisungen zur Verfügung.

Schritt 4: Proxy-Verbindung auf dem unternehmensweiten Server installieren und ausführen

Dieser Schritt wird vom Systemadministrator durchgeführt.

Überblick der Schritte

1. datev-proxy.exe herunterladen und auf dem Server ablegen

2. TCP-Port in der Windows Firewall öffnen (falls erforderlich)

3. Optional config.json konfigurieren

4. Proxy starten (empfohlen als Windows-Dienst)

5. Erreichbarkeit über GET /health prüfen

6. Fügen Sie die Proxy-URL in Memtime ein (Memtime-Admin, erweiterte Aktion Proxy Einstellen).

Es werden keine DATEV-Zugangsdaten manuell im Proxy gespeichert. Diese werden automatisch durch die Integration bereitgestellt, sobald die Proxy-URL konfiguriert ist und ein API-User existiert.

1. Programmdatei ablegen

Legen Sie datev-proxy.exe in einem geeigneten Verzeichnis auf dem Server ab.

Jeder Ordner, auf den das Konto, unter dem der Proxy läuft, Lese- und Schreibzugriff hat. Die Dateien config.json und credentials.enc werden daneben angelegt:

{
  "status": "healthy",
  "proxy": true,
  "uptime": 12.3,
  "credentials": { "configured": false, "username": null },
  "cacheEntries": 0,
  "inflightRequests": 0,
  "backgroundSync": { "isSyncing": false, "lastSyncAt": null, "lastSyncDurationMs": null },
  "config": { "port": 12345 }
}

Berechtigungen: Der Ordner muss für das Konto, unter dem der Proxy ausgeführt wird, beschreibbar sein. Der Proxy erstellt die Datei config.json, falls diese fehlt, liest sie bei jedem Start ein und schreibt in die Datei credentials.enc bzw. liest aus ihr aus, sobald die Integration Anmeldedaten übermittelt.

2. Port öffnen

Standardmäßig verwendet der Proxy den TCP-Port 12345.

Wenn der Proxy auf demselben Server wie Memtime läuft und nur über localhost erreichbar ist, ist möglicherweise keine Firewall-Regel erforderlich.

Wenn andere Rechner darauf zugreifen müssen, richten Sie in der Windows-Firewall auf dem Proxy-Rechner eine eingehende TCP-Regel ein:

netsh advfirewall firewall add rule name="Datev Proxy" dir=in action=allow ^
    protocol=TCP localport=12345

Falls der Port bereits belegt ist:

1. Anderen Port in der Firewall-Regel verwenden

2. Legen Sie dies in der Datei config.json (Schritt 3) oder über die Umgebungsvariable PORT fest.

Hinweis: Der Proxy verwendet HTTP ohne TLS. Der Port darf nicht öffentlich erreichbar sein.

3. config.json konfigurieren (optional)

Sie können diesen Schritt überspringen. Beim ersten Start erstellt der Proxy automatisch die Datei config\config.json neben der ausführbaren Datei mit sinnvollen Standardwerten.

Wenn Sie vor dem ersten Start Anpassungen vornehmen möchten, legen Sie eine Datei config.json neben der ausführbaren Datei ab, die einen der folgenden Schlüssel enthält:

{
  "server":   { "port": 12345 },
  "datev":    { "baseUrl": "http://localhost:58454", "endpoints": [ … ] },
  "cache":    { "strategies": { "long": 60, "middle": 15, "short": 5 },
                "syncIntervalMinutes": 90, "pageSize": 1000 },
  "pagination":{ "maxPages": 100, "timeout": 30000 }
}

Häufige Anpassungen:

datev.baseUrl — wenn DATEV nicht auf localhost läuft
server.port — wenn 12345 belegt ist
cache.syncIntervalMinutes — nur nach Empfehlung ändern

Starten Sie den Proxy nach der Bearbeitung der Datei config.json neu.

4. Proxy ausführen

Wählen Sie eine der drei Optionen aus.

Option A (Windows Service über NSSM) wird für jede produktive Installation empfohlen.

NSSM kapselt jede .exe als echten Windows-Dienst, sodass dieser beim Systemstart automatisch startet, bei Abstürzen neu startet und über services.msc verwaltet werden kann.

1. Laden Sie NSSM herunter und legen Sie nssm.exe in einem Verzeichnis ab, das sich im PATH befindet (oder im Installationsordner).
2. Öffnen Sie eine PowerShell mit Administratorrechten (ersetzen Sie <install-folder> durch Ihren gewählten Ordner):

nssm install DatevProxy "<install-folder>\datev-proxy.exe"
nssm set DatevProxy AppDirectory "<install-folder>"
nssm set DatevProxy DisplayName "Memtime Datev Caching Proxy"
nssm set DatevProxy Start SERVICE_AUTO_START
nssm set DatevProxy AppStdout "<install-folder>\logs\stdout.log"
nssm set DatevProxy AppStderr "<install-folder>\logs\stderr.log"
nssm start DatevProxy

3. Überprüfen Sie in services.msc, dass Memtime Datev Caching Proxy läuft.

Option B: Task Scheduler beim Systemstart

Leichtgewichtige Alternative, wenn NSSM von der IT des Kunden nicht freigegeben ist.

1. Öffnen Sie die Aufgabenplanung → Aufgabe erstellen (nicht "Einfache Aufgabe erstellen").

2. General: Name DatevProxy; Ausführen, unabhängig davon, ob der Benutzer angemeldet ist; Mit höchsten Privilegien ausführen.

3. Triggers: Beim Systemstart.

4. Aktionen: Programm starten → vollständiger Pfad zur datev-proxy.exe. Starten in auf den Installationsordner setzen.

5. Einstellungen: Aktivieren Sie Wenn die Aufgabe fehlschlägt, alle 1 Minute neu starten, bis zu 3 Mal.

Hinweis: Die Aufgabenplanung erfasst stdout/stderr standardmäßig nicht; Logging ist daher schwieriger als mit NSSM. Die Aufgabenplanung erfasst stdout/stderr standardmäßig nicht; Logging ist daher schwieriger als mit NSSM.

Option C: Manueller Start (nur zum Testen)

cd "<install-folder>"
datev-proxy.exe

Der Prozess schreibt Logs mit Zeitstempeln in die Konsole. Das Schließen des Terminals stoppt den Proxy. Diese Variante sollte nur zur Erstvalidierung verwendet werden.

5. Prüfen, ob der Proxy läuft

Von jedem Rechner, der den Proxy-Host erreichen kann (oder direkt auf dem Server, wenn er lokal läuft):

GET http://localhost:12345/health

Erwartete Antwort:

{
  "status": "healthy",
  "proxy": true,
  "uptime": 12.3,
  "credentials": { "configured": false, "username": null },
  "cacheEntries": 0,
  "inflightRequests": 0,
  "backgroundSync": { "isSyncing": false, "lastSyncAt": null, "lastSyncDurationMs": null },
  "config": { "port": 12345 }
}

status: "healthy" and proxy: true müssen beide vorhanden sein, damit die Integration funktioniert. credentials.configured: false ist in diesem Schritt erwartbar, da die Zugangsdaten erst im nächsten Schritt bereitgestellt werden.

Schritt 5: Proxy-Verbindung in Memtime konfigurieren

Der Memtime-Admin führt die folgenden Schritte aus.

1. Gehen Sie zurück zu Memtime, klicken Sie auf Proxy Einstellen und geben Sie die Proxy-URL ein.

2. Geben Sie http://localhost:12345 ein (Standard-URL, wenn der Proxy auf demselben Server wie Memtime läuft; andernfalls http://<proxy-host>:12345).

Klicken Sie auf Speichern.

Stellen Sie sicher, dass der Proxy aus Schritt 4 installiert und gestartet ist, bevor Sie die URL speichern.

Beim Speichern prüft Memtime im Hintergrund die Erreichbarkeit des Proxys. Dabei wird GET /health aufgerufen, und die URL wird nur akzeptiert, wenn der Proxy "healthy" zurückgibt.

3. Nach dem Klick auf Speichern erfolgt eine Hintergrundprüfung, ob die Proxy-Verbindung aktiv ist. Wenn ja, wird das Speichern abgeschlossen.

Wenn die Proxy-Verbindung nicht aktiv ist, erscheint eine Fehlermeldung. Diese weist darauf hin, dass die Einstellungen aus Schritt 4 überprüft werden sollten.

Support

Benötigen Sie Hilfe zu diesem Artikel oder haben Sie Fragen? Kontaktieren Sie uns jederzeit unter:

🔗 support@memtime.com