In 5 Schritten zur ersten DATEV-API-Antwort
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 ]
Als Kunde registrieren
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.
Professional oder Enterprise
Das Testsystem (Sandbox mit echten DATEV-Testdaten) ist ab dem Professional-Plan enthalten.
- Geteiltes DATEV-Testsystem inklusive
- 17 vorbereitete Testmandanten
- Buchungen, Debitoren, Geschäftsjahre
- Alle DATEVconnect-APIs verfügbar
- Valides SSL, weltweit erreichbar
Was passiert nach der Registrierung?
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.
Login ins Partnerportal
Melde dich mit deinen Zugangsdaten im Cloud Gateway Partnerportal an. Hier verwaltest du Kanzlei-Anbindungen, siehst Logs und findest die Testsystem-Credentials.
partner.cloudgateway.riecken.io
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.
Auf DATEV Testsystem klicken
Im Bereich „DATEV Testsystem" findest du das geteilte Sandbox-System mit 17 vorbereiteten Testmandanten, Buchungsdaten aus 2023–2025 und offenen Posten.
Was ist das Testsystem?
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.
Credentials anzeigen & speichern
Im Testsystem-Bereich siehst du Benutzername und Passwort für die HTTP Basic Authentication. Speichere diese – du brauchst sie ab Schritt 5.
HTTP Basic Auth
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.
Erste API-Calls ausführen
Jetzt geht es los. Drei aufeinander aufbauende Calls zeigen dir den typischen Workflow: Mandanten abrufen → Geschäftsjahr auswählen → offene Posten laden.
Mandantenliste abrufen
GET /clients
Der 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
]
Geschäftsjahre abrufen
GET /clients/{id}/fiscal-years
Fü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
}
]
Offene Posten (Debitoren) abrufen
GET /…/accounts-receivable
Der 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
]