DATEVconnect integrieren –
so einfach wie nie.
Cloud Gateway ist ein transparenter Proxy vor DATEVconnect. Du implementierst exakt die DATEVconnect-API – wir kümmern uns um alles dahinter: Tunnel, Auth, Routing, Verfügbarkeit.
Cloud Gateway als transparenter Proxy
Du rufst dieselben DATEVconnect-Endpoints auf wie gewohnt – Cloud Gateway übernimmt den Rest unsichtbar im Hintergrund.
Authentifizierung
Du nutzt ein einziges Benutzername/Passwort-Paar (Basic Auth) für alle Kanzleien. Cloud Gateway mappt die Anfragen intern auf die jeweiligen DATEV-Credentials.
Routing
Jede API-Anfrage enthält eine Kanzlei-ID. Cloud Gateway leitet sie automatisch an das richtige DATEVconnect-System weiter – transparent für deine Anwendung.
Verfügbarkeit
Cloud Gateway überwacht die DATEV-Systeme kontinuierlich, puffert Verbindungsabbrüche und meldet Ausfälle sofort an dein Monitoring.
Sicherer Tunnel
DATEVconnect läuft on-premise hinter der Kanzlei-Firewall. Cloud Gateway öffnet einen verschlüsselten ausgehenden Tunnel – kein eingehender Port nötig.
Öffentliches SSL-Zertifikat
Während DATEVconnect direkt nur selbst-signierte Zertifikate liefert, stellt Cloud Gateway ein öffentlich geprüftes, valides SSL-Zertifikat bereit.
Monitoring & Logs
Jeder API-Call wird protokolliert – mit Timestamp, Latenz, HTTP-Status und Kanzlei-Zuordnung. Abrufbar im Partnerportal oder per Webhook.
Für die direkte DATEVconnect-Integration (on-premise) ist kein DATEV-Partnerstatus nötig – das gilt für Cloud Gateway und die direkte Anbindung gleichermaßen. Anders verhält es sich bei den DATEV Datenservices: Dort ist ein offizieller Freigabeprozess durch DATEV erforderlich. Auch dafür brauchen wir keine eigene Zulassung – und damit auch du nicht.
Nur die Base URL tauschen
Du implementierst DATEVconnect exakt so, wie es die DATEV-Dokumentation beschreibt. Der einzige Unterschied: statt der internen Kanzlei-IP rufst du unsere URL auf.
- Alle Endpoints identisch
- Alle Response-Strukturen identisch
- Bestehende DATEV-Dokumentation gilt 1:1
- Kein Vendor Lock-in
# DATEVconnect on-premise – nur intern erreichbar
BASE_URL = "http://<kanzlei-ip-intern>:58454/datev/api/master-data/v1"
# Pro Kanzlei andere Credentials nötig
auth = BasicAuth(<kanzlei-user>, <kanzlei-pass>)# Cloud Gateway – weltweit erreichbar, valides SSL
BASE_URL = "https://api.cloudgateway.riecken.io/datev/api/master-data/v1"
# Einmal unsere Credentials – für alle Kanzleien
auth = BasicAuth(<cg-username>, <cg-password>)Alle DATEVconnect-APIs – vollständig unterstützt
Cloud Gateway unterstützt den kompletten DATEVconnect-API-Umfang. Alle Ressourcen, alle Endpoints, alle Versionen.
Buchhaltung
Buchungen, Belege, Konten, Debitoren/Kreditoren, Bilanzen. Das Herzstück der DATEV-Integration.
Mandanten & Stammdaten
Mandantendaten, Adressen, Bankverbindungen und alle Stammdaten deiner Kanzleikunden.
Identität & Benutzerverwaltung
Nutzerinformationen, Rollen und Berechtigungsstrukturen im DATEV-System abfragen.
Diagnose & Funktionstests
Verbindungstest, Systemstatus und Health-Checks des DATEV-DATEVconnect-Servers.
Dokumentenverwaltung
Belege hochladen, abrufen und verwalten – für die automatische Belegübermittlung an die Kanzlei.
Auftragsverwaltung
Aufträge, Bestellungen, Positionen und Abrechnungsvorgänge im DATEV-Kontext verwalten.
Rechtsbereich
Rechtsdaten und gesetzliche Informationen für steuerrechtliche Auswertungen (Early Access).
Lohnabrechnung
Mitarbeiterdaten, Lohnabrechnungen und alle lohnrelevanten Informationen übertragen.
Öffentlicher Sektor
Spezifische Daten und Prozesse für Kämmereien, Eigenbetriebe und öffentliche Einrichtungen.
Die offizielle DATEVconnect-Dokumentation
Die vollständige technische Dokumentation aller DATEVconnect-APIs – Spezifikationen, Schemas, Changelogs – liegt beim DATEV Partnerportal. Da Cloud Gateway ein transparenter Proxy ist, gilt diese Dokumentation 1:1 auch für deine Cloud-Gateway-Integration. Du implementierst DATEVconnect genau wie beschrieben – nur die Base-URL ist eine andere.
Kanzleien programmatisch anbinden
Die Cloud Gateway Onboarding API ermöglicht es, den gesamten Kanzlei-Onboarding-Prozess vollständig zu automatisieren – direkt aus deiner Applikation, ohne manuelle Schritte im Partnerportal.
Typischer Use Case
Du bist SaaS-Anbieter und möchtest, dass neue Kunden ihre DATEV-Kanzlei direkt in deinem Onboarding-Flow anbinden – ohne das Cloud Gateway Partnerportal manuell zu öffnen. Die Onboarding API gibt dir dafür drei einfache Schritte:
POST /v3/selfOnboarding – du übermittelst die gewünschten Rechte und Mandantenbereiche, erhältst einen personalisierten Onboarding-Link und einen Public Access Token.
GET /v3/selfOnboarding/status prüfst du den Fortschritt. Sobald activatedAccess erreicht ist, rufst du mit GET /v3/selfOnboarding/credentials die Zugangsdaten ab.
Ist eine Kanzlei bereits im Cloud Gateway angelegt, entfällt die vollständige Identitätsprüfung. Der Kunde gibt stattdessen seine Beraternummer ein, bestätigt per E-Mail-TAN und die Freischaltung erfolgt sofort.
Authentifizierung
Alle Requests erfordern einen Bearer Token (API Key aus dem Partnerportal).
Bearer <access_token>
Content-Type
application/json
Host
api.cloudgateway.riecken.io
Endpoints
/v3/availableRights
Liefert alle verfügbaren Berechtigungen für deinen Softwarepartner-Account. Wird benötigt, um die requestedRights-IDs für den nächsten Request zu ermitteln.
/v3/selfOnboarding
Startet den Onboarding-Prozess. Gibt publicAccessToken und redirectUrl zurück – die URL schickst du an deinen Kunden.
/v3/selfOnboarding/status
Status des Onboardings abfragen. Mögliche Werte: pending, finished, failed. Detailed Status: created, userLoggedIn, signedContracts, connectionEstablished, activatedAccess.
/v3/selfOnboarding/credentials
Liefert Benutzername & Passwort nach erfolgreichem Onboarding (Status activatedAccess). Zugangsdaten sind 30 Tage abrufbar.
Kompletter Onboarding-Flow
// Welche Rechte kann ich anfordern?
GET /v3/availableRights
Host: api.cloudgateway.riecken.io
Authorization: Bearer <access_token>
// Response (Auszug)
[
{
"id": 123,
"name": "Buchhaltungszugriff",
"apiProgramGroup": "ACCOUNTING",
"apiOperation": "GET"
}
]// Onboarding initiieren
POST /v3/selfOnboarding
Host: api.cloudgateway.riecken.io
Authorization: Bearer <access_token>
Content-Type: application/json
{
"requestedClients": [
{ "consultantNumber": "*",
"clientNumber": "10000-12000" }
],
"requestedRights": [123, 124]
}
// Response
{
"publicAccessToken": "xyz123",
"redirectUrl": "https://api.cloudgateway.riecken.io
/onboarding/xyz123"
}// Status pollen bis "activatedAccess"
GET /v3/selfOnboarding/status
?onboardingPublicAccessToken=xyz123
Host: api.cloudgateway.riecken.io
Authorization: Bearer <access_token>
// Response
{
"status": "pending",
"detailedStatus": "userLoggedIn"
}
// Mögliche detailedStatus-Werte:
// created | userLoggedIn | signedContracts
// connectionEstablished | activatedAccess// Erst wenn detailedStatus = "activatedAccess"
GET /v3/selfOnboarding/credentials
?onboardingPublicAccessToken=xyz123
Host: api.cloudgateway.riecken.io
Authorization: Bearer <access_token>
// Response
{
"username": "exampleUser",
"password": "securePassword"
}
// Zugangsdaten sind 30 Tage abrufbarVollständige Sandbox-Umgebung
Das Cloud Gateway Testsystem ist eine vollständige DATEV-Sandbox mit echten Testdaten – für Entwicklung, QA und Integrationstests ohne Risiko.
Was ist das Testsystem?
Ein vollständig isoliertes DATEV-System mit synthetischen Testdaten – Mandanten, Buchungen, Belege, Mitarbeiterdaten. Es verhält sich exakt wie ein Produktivsystem, nutzt aber keine echten Kanzleidaten.
Use Cases
- Integration entwickeln ohne Produktivdaten
- Automatisierte Tests in CI/CD-Pipelines
- QA und Bugfixing mit reproduzierbaren Daten
- Onboarding neuer Entwickler im Team
- Demo-Umgebung für Sales und Kundenpräsentationen
Zugang zum Testsystem
Das Testsystem ist im Professional- und Enterprise-Plan enthalten. Im Professional-Plan steht ein geteiltes öffentliches Testsystem zur Verfügung. Enterprise-Kunden erhalten auf Wunsch ein privates, dediziertes Testsystem mit RDP-Zugriff.
Zu den PreisplänenUnterschiede zum Produktivsystem
- Synthetische Testdaten
- Kein Risiko für echte Daten
- Gleiche API-Struktur
- Identische Responses
- Keine echten Kanzleien
- Echte Kanzleidaten
- Live-Anbindungen
- Vollständiger Betrieb
- SLA-Garantien (Enterprise)
- Echte Kanzleien
Das Testsystem ist im Professional-Plan enthalten – teste jetzt ohne Risiko.
Bereit, DATEVconnect zu integrieren?
Starte mit dem Quickstart Guide oder buche einen kostenlosen Termin – wir beantworten alle technischen Fragen persönlich.
✓ DATEVconnect-kompatibel | ✓ ISO 27001 zertifiziert | ✓ DATEV-geprüfte Schnittstelle