Vom leeren Account bis zur echten Response aus dem DATEV-Testsystem – in unter 15 Minuten. Kein DATEV-System, keine Kanzlei, keine Voraussetzungen außer einem Premium-Account.
GET /datev/api/accounting/v1/clients Authorization: Basic dGVzdC11c2VyOm15c2VjcmV0 HTTP/1.1 200 OK [ { "name": "Tischlerbeispiel GmbH", "number": 55035, "id": "8bce03c1-1606-430b-..." }, { "name": "Erik Muster", "number": 55043, "id": "1e8738b9-8372-48ef-..." }, // ... 15 weitere Mandanten ]
Erstelle deinen Cloud Gateway Partner-Account. Das Testsystem mit echten DATEV-Testdaten ist im Professional- und Enterprise-Plan enthalten.
Klicke auf den Button unten und fülle das Registrierungsformular aus. Nach der Registrierung erhältst du per E-Mail deine Zugangsdaten zum Cloud Gateway Partnerportal.
Das Testsystem (Sandbox mit echten DATEV-Testdaten) ist ab dem Professional-Plan enthalten.
Du erhältst eine Bestätigungs-E-Mail mit deinen Zugangsdaten für das Partnerportal. Die Freischaltung erfolgt in der Regel innerhalb weniger Minuten bis zu einem Werktag.
Nach dem Login findest du im Partnerportal unter „DATEV Testsystem" die Credentials für das geteilte Testsystem – genau das machen wir in Schritt 3 & 4.
Melde dich mit deinen Zugangsdaten im Cloud Gateway Partnerportal an. Hier verwaltest du Kanzlei-Anbindungen, siehst Logs und findest die Testsystem-Credentials.
Das Partnerportal ist die Schaltzentrale deiner Cloud Gateway Integration. Nach dem Login siehst du in der linken Navigation den Punkt „DATEV Testsystem".
Deine Login-Daten hast du per E-Mail nach der Registrierung erhalten. Falls du dein Passwort vergessen hast, nutze die „Passwort vergessen"-Funktion im Portal.
Im Bereich „DATEV Testsystem" findest du das geteilte Sandbox-System mit 17 vorbereiteten Testmandanten, Buchungsdaten aus 2023–2025 und offenen Posten.
Das Cloud Gateway Testsystem ist eine vollständige DATEV-Sandbox-Umgebung mit synthetischen, aber realistischen Buchhaltungsdaten. Es verhält sich exakt wie ein Produktivsystem – alle DATEVconnect-APIs sind verfügbar.
Du brauchst keine echte Kanzlei, kein DATEVconnect vor Ort und keine IT-Infrastruktur. Der Zugang läuft vollständig über Cloud Gateway.
Im Testsystem-Bereich siehst du Benutzername und Passwort für die HTTP Basic Authentication. Speichere diese – du brauchst sie ab Schritt 5.
Cloud Gateway nutzt HTTP Basic Authentication – genau wie DATEVconnect selbst. Du sendest Benutzername und Passwort Base64-kodiert im Authorization-Header jedes Requests.
Im Partnerportal findest du den fertigen kodierten Header – direkt kopierbar, kein manuelles Kodieren nötig.
Jetzt geht es los. Drei aufeinander aufbauende Calls zeigen dir den typischen Workflow: Mandanten abrufen → Geschäftsjahr auswählen → offene Posten laden.
GET /clientsDer erste Call liefert alle Mandanten (Kanzleikunden), auf die du im Testsystem Zugriff hast. Das Testsystem enthält 17 vorbereitete Mandanten.
Du brauchst die ID eines Mandanten für alle weiteren Calls – hier nimmst du 8bce03c1… (Tischlerbeispiel GmbH).
YOUR_TOKEN durch den Base64-Auth-Header aus Schritt 4.
curl -X GET \ "https://api.cloudgateway.riecken.io\ /datev/api/accounting/v1/clients" \ -H "Authorization: Basic YOUR_TOKEN" \ -H "Accept: application/json"
[
{
"name": "Tischlerbeispiel GmbH",
"number": 55035,
"id": "8bce03c1-1606-430b-8074-4346b070bc41"
},
{
"name": "Erik Muster",
"number": 55043,
"id": "1e8738b9-8372-48ef-a2a2-1096d3c30e5e"
},
{
"name": "Testholz GmbH",
"number": 55004,
"id": "4f5e602e-8852-41d1-9a0e-9c7187d0be14"
},
{
"name": "Muster GmbH",
"number": 55034,
"id": "9cec259a-f9e5-45e6-be48-55d8f72aeed9"
},
{
"name": "Musterholz GmbH",
"number": 55003,
"id": "cbd9eba7-199d-4533-8361-19f55f1ffabe"
},
// ... 12 weitere Mandanten
]
GET /clients/{id}/fiscal-yearsFür die Tischlerbeispiel GmbH (8bce03c1…) gibt es drei Geschäftsjahre: 2023, 2024 und 2025.
Die fiscal-year ID ist das Startdatum in kompakter Form: 20250101 für das Jahr 2025. Diese ID brauchst du für Call 3.
| ID | Zeitraum | Gesperrt |
|---|---|---|
20230101 | 01.01.2023 – 31.12.2023 | Nein |
20240101 | 01.01.2024 – 31.12.2024 | Nein |
20250101 | 01.01.2025 – 31.12.2025 | Nein |
curl -X GET \ "https://api.cloudgateway.riecken.io\ /datev/api/accounting/v1/clients\ /8bce03c1-1606-430b-8074-4346b070bc41\ /fiscal-years" \ -H "Authorization: Basic YOUR_TOKEN"
[
{
"begin": "2023-01-01T00:00:00.000+01:00",
"end": "2023-12-31T00:00:00.000+01:00",
"client_number": 55035,
"currency_code": "EUR",
"legal_form": "corporation",
"is_locked": false,
"id": "20230101"
},
{
"begin": "2024-01-01T00:00:00.000+01:00",
"end": "2024-12-31T00:00:00.000+01:00",
"is_locked": false,
"id": "20240101"
},
{
"begin": "2025-01-01T00:00:00.000+01:00",
"end": "2025-12-31T00:00:00.000+01:00",
"is_locked": false,
"id": "20250101" ← für Call 3 verwenden
}
]
GET /…/accounts-receivableDer Endpunkt accounts-receivable liefert alle Debitoren-Buchungen eines Geschäftsjahres – inklusive offener und bereits ausgeglichener Posten.
Das Feld is_cleared zeigt an, ob ein Posten bereits bezahlt ist. open_balance_of_item enthält den noch offenen Betrag.
| Rech.nr. | Betrag | Fällig | Bezahlt |
|---|---|---|---|
202501016 | 2.053,71 € | 02.02.2025 | Ja |
202503001 | 1.502,58 € | 23.03.2025 | Ja |
202503030 | 2.716,75 € | 14.04.2025 | Nein |
202401036 | 5.767,18 € | 15.02.2024 | Nein |
202501036 | 6.214,75 € | 18.02.2025 | Nein |
curl -X GET \ "https://api.cloudgateway.riecken.io\ /datev/api/accounting/v1/clients\ /8bce03c1-1606-430b-8074-4346b070bc41\ /fiscal-years/20250101\ /accounts-receivable" \ -H "Authorization: Basic YOUR_TOKEN"
[
{
"open_item_number": "202503030",
"amount_debit": 2716.75,
"open_balance_of_item": 2716.75,
"is_cleared": false,
"due_date": "2025-04-14T00:00:00.000+02:00",
"posting_description": "Möbel Testgruber",
"evidence_type": "invoice",
"tax_rate": 19.00,
"id": "20250101_352"
},
{
"open_item_number": "202501036",
"amount_debit": 6214.75,
"open_balance_of_item": 6214.75,
"is_cleared": false,
"due_date": "2025-02-18T00:00:00.000+01:00",
"posting_description": "Seltentest",
"id": "20250101_38"
},
// ... weitere Posten
]