DATEV — Application Owner Setup
Prerequisites
DATEV requires formal partner certification before you can access their APIs. This is NOT a self-service process.
Steps to get credentials
- Register at the DATEV Developer Portal: https://developer.datev.de/en
- Create an Enterprise Organization in the portal
- Apply for Schnittstellenanbieter (Interface Partner) status
- Contact your DATEV partner manager
- They will guide you through the application
- Receive Client ID and Client Secret after approval
- Implement and self-test in the sandbox environment
- Book a certification appointment with DATEV
- Pass technical certification — DATEV reviews your integration
- Go live with production credentials
Timeline
Expect 4-12 weeks from application to production access, depending on DATEV's review queue.
OAuth Configuration
| Setting | Value |
|---|---|
| Authorization URL (Sandbox) | https://login.datev.de/openidsandbox/authorize |
| Authorization URL (Production) | https://login.datev.de/openid/authorize |
| Token URL (Sandbox) | https://login.datev.de/openidsandbox/token |
| Token URL (Production) | https://login.datev.de/openid/token |
| Token Lifetime | 15 minutes (900 seconds) |
| Refresh Token Lifetime | 11 hours (standard) or 2 years (with offline_access scope) |
| Token Request Content-Type | application/x-www-form-urlencoded |
Required Scopes
| Scope | Purpose |
|---|---|
openid | OpenID Connect (required) |
offline_access | Long-lived refresh tokens (strongly recommended) |
datev:accounting:clients | List Mandanten |
datev:accounting:extf-files | Upload EXTF CSV files |
datev:accounting:documents | Upload documents to Belege Online |
datev:accounting:dxso-jobs | Upload XML invoice data |
Required Headers
Every API request must include:
Authorization: Bearer {access_token}
X-DATEV-Client-Id: {your_oauth_client_id}