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

  1. Register at the DATEV Developer Portal: https://developer.datev.de/en
  2. Create an Enterprise Organization in the portal
  3. Apply for Schnittstellenanbieter (Interface Partner) status
    • Contact your DATEV partner manager
    • They will guide you through the application
  4. Receive Client ID and Client Secret after approval
  5. Implement and self-test in the sandbox environment
  6. Book a certification appointment with DATEV
  7. Pass technical certification — DATEV reviews your integration
  8. Go live with production credentials

Timeline

Expect 4-12 weeks from application to production access, depending on DATEV's review queue.

OAuth Configuration

SettingValue
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 Lifetime15 minutes (900 seconds)
Refresh Token Lifetime11 hours (standard) or 2 years (with offline_access scope)
Token Request Content-Typeapplication/x-www-form-urlencoded

Required Scopes

ScopePurpose
openidOpenID Connect (required)
offline_accessLong-lived refresh tokens (strongly recommended)
datev:accounting:clientsList Mandanten
datev:accounting:extf-filesUpload EXTF CSV files
datev:accounting:documentsUpload documents to Belege Online
datev:accounting:dxso-jobsUpload XML invoice data

Required Headers

Every API request must include:

Authorization: Bearer {access_token}
X-DATEV-Client-Id: {your_oauth_client_id}

References