For the German version, please scroll down to “Dokumentation (Deutsch)”
Important:
In any customer/user contact, the DKV Customer Service is the primary point of contact. The API Access cannot be requested via the API Portal.
If the prospective API user is not a DKV customer yet, the user should get in touch with DKV Sales Team or DKV Customer serivce, to become a DKV customer, by signing all relevant documents and especially the general terms and conditions related to the usage of our services.
Request Submission: The customer initiates the process by contacting customer service.
Service Request Creation: Customer service opens a service request for the API onboarding.
Credentials Issuance (7-10 Days):
It typically takes 7-10 days for the customer to receive their API credentials. A new created technical user, client id and his subscription key is sent via email, and the client secret is delivered via SMS.
The onboarding email also includes:
An overview of how to use the client ID and client secret for authenticating API requests.
Examples of Request Structure: Sample API requests to illustrate how to properly format requests and include authentication details.
This information helps customers understand how to correctly authenticate and structure their API requests.
Customer must provide to the DKV Customer service following information:
main company name
main customer number
mobile phone number
other customer numbers, who will be able to retrieve the data with newly created technical user
further legal documentation to be signed
The attributes of every existing technical user can be changed, excepted technical user name itself.
The request for this can be made via DKV Customer Service, please use the technical username (NOT the clientId) as reference for requesting any change.
Additional customer numbers can also be assigned to existing technical user.
The request for this can made via DKV Customer Service, please use the technical username (NOT the clientId) as reference for requesting any change.
The following services are available currently for free use, which shall however change in 2025:
transactions and passages
master data: service cards
master data: toll products
Important: A service for delivering of online authorization data (OLA service) is not automatically accessible to all users.
Access is granted based on specific authorization processes and requirements.
Using of the OLA service requires special approval of the DKV Sales Lead.
DKV Customer Service is the primary point of contact also in this case.
Once the credentials are received, the customer can use the Try It feature to test API functionality before full integration.
The customer onboarding can be ordered in Matrix42:
Enterprise API Customer Connection
Hier finden Sie die deutsche Dokumentation.
Wichtig:
Bei jedem Kunden- oder Benutzerkontakt ist der DKV Kundenservice der primäre Ansprechpartner. Der API-Zugang kann nicht über das API-Portal angefordert werden.
Falls der potenzielle API-Nutzer noch kein DKV-Kunde ist, sollte er sich mit dem DKV-Vertriebsteam oder dem DKV-Kundenservice in Verbindung setzen, um DKV-Kunde zu werden.
Dazu ist es notwendig, alle relevanten Dokumente, insbesondere die allgemeinen Geschäftsbedingungen zur Nutzung unserer Dienste, zu unterzeichnen.
Antragstellung: Der Kunde beginnt den Prozess, indem er den Kundenservice kontaktiert..
Erstellung eines Serviceauftrags: Der Kundenservice eröffnet einen Serviceauftrag für das API-Onboarding.
Verschicken der Zugangsdaten (7-10 Tage):
Es dauert in der Regel 7-10 Tage, bis der Kunde seine API-Zugangsdaten erhält.
Ein neu erstellter technischer Benutzer, die Client-ID und der Subscription Key werden per E-Mail versandt, während das Client Secret per SMS übermittelt wird.
The onboarding E-Mail also includes:
Eine Übersicht, wie die Client-ID und das Client Secret zur Authentifizierung von API-Anfragen genutzt werden..
Beispiele für die Struktur von Anfragen: Musteranfragen, die veranschaulichen, wie Anfragen richtig formatiert und Authentifizierungsdetails eingebunden werden.
Diese Informationen helfen den Kunden, zu verstehen, wie sie ihre API-Anfragen korrekt authentifizieren und strukturieren.
Der Kunde muss dem DKV Kundenservice folgende Informationen bereitstellen:
Hauptfirmenname
Hauptkundennummer
E-Mail-Adresse
Mobiltelefonnummerr
Weitere Kundennummern, die mit dem neu erstellten technischen Benutzer Daten abrufen können
Weitere rechtliche Dokumente zur Unterschrift
Die Attribute jedes bestehenden technischen Benutzers können geändert werden, mit Ausnahme des technischen Benutzernamens selbst.
Die Anfrage hierfür kann über den DKV Kundenservice gestellt werden, bitte verwenden Sie den technischen Benutzernamen (NICHT die Client-ID) als Referenz, um Änderungen anzufordern.
Zusätzliche Kundennummern können ebenfalls einem bestehenden technischen Benutzer zugeordnet werden.
Die Anfrage dafür kann über den DKV Kundenservice gestellt werden, bitte verwenden Sie den technischen Benutzernamen (NICHT die Client-ID) als Referenz, um Änderungen anzufordern.
Die folgenden Services sind derzeit kostenlos nutzbar, dies wird sich jedoch im Jahr 2025 ändern:
Transaktionen und Passagen
Kundenstammdaten - Servicekarten
Kundenstammdaten - Mautprodukte
Wichtig: Ein Service zur Bereitstellung von Online-Autorisierungsdaten (OLA-Service) ist nicht automatisch für alle Nutzer zugänglich.
Der Zugang wird basierend auf spezifischen Autorisierungsprozessen und Anforderungen gewährt.
Die Nutzung des OLA-Services erfordert eine spezielle Genehmigung durch den DKV-Vertriebsleiter.
Der DKV Kundenservice ist auch in diesem Fall der primäre Ansprechpartner.
Sobald die Zugangsdaten vorliegen, kann der Kunde die Try It -Funktion nutzen, um die API-Funktionalität vor der vollständigen Integration zu testen.
Eine Anbindung (Onboarding) kann mit einem Service request in Matrix42 beantragt werden: