CDK Drive Service Vehicles (Vorschau)
CDK Drive Service Vehicles Associates Identifikation, Typ, Status und Kundeninformationen zu einem Fahrzeug. Mit der API können Sie Informationen zum Dienstdomänenfahrzeug in CDK erstellen, aktualisieren, abfragen und abrufen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | CDK Global |
| URL | https://serviceconnect.support.cdk.com |
| mbd_support@cdk.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | CDK Global |
| Webseite | https://fortellis.io |
| Datenschutzrichtlinie | https://fortellis.io/privacy |
| Kategorien | Daten |
CDK Drive - Service - Vehicles Associates Identifikation, Typ, Status und Kundeninformationen zu einem Fahrzeug.
Was geschieht mit dieser API? Mit der API können Sie Informationen zum Dienstdomänenfahrzeug im CDK-Laufwerk erstellen, aktualisieren, abfragen und abrufen.
Beabsichtigtes Zielgruppenfahrzeug ist eine Abhängigkeit von Workflows für Servicetermin- und Servicereparaturauftragsworkflows.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren.
• Um den Connector zu verwenden, müssen Sie ein Fortellis-Benutzer sein.
• Sie müssen eine Lösung in Fortellis erstellen, um Client-ID und geheimen Schlüssel zu generieren, die beim Aufrufen der APIs verwendet werden sollen.
Potenzielle Anwendungsfälle
Verwenden Sie die CDKDrive Service Vehicles-API, um Lösungen für die Behandlung von Situationen zu erstellen, z. B.:
- Erstellen oder Aktualisieren von Dienstfahrzeuginformationen
- Verknüpfen eines Kunden mit einem Servicefahrzeug
- Suchen nach vorhandenen Servicefahrzeugen nach ID- oder Filterkriterien
Detaillierte Dokumentation finden Sie unter
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abfragen eines Fahrzeugs anhand des Bezeichners |
Abfragen eines Fahrzeugs anhand des Bezeichners |
| Abfragen von Fahrzeugen |
Abfragen von Fahrzeugen |
| Aktualisieren eines Fahrzeugs |
Aktualisieren eines Fahrzeugs |
| Erstellen eines Fahrzeugs |
Erstellen eines Fahrzeugs |
Abfragen eines Fahrzeugs anhand des Bezeichners
Abfragen eines Fahrzeugs anhand des Bezeichners
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fahrzeug-ID
|
vehicleId | True | string |
Der Fahrzeugbezeichner |
|
Subscription Id (Abonnement-ID)
|
subscription_id | True | string |
Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
Client-ID
|
client_id | True | string |
Eine Client-ID, die für Entwickler/Lösungsanbieter eindeutig sein sollte, um die Lösung zu erstellen. |
|
Geheimer Clientschlüssel
|
client_secret | True | string |
Ein geheimer Clientschlüssel, der für Entwickler/Lösungsanbieter eindeutig sein sollte, der die Lösung erstellt. |
|
Anforderungs-ID
|
Request-Id | string |
Format - GUID. Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
Gibt zurück
- Body
- Vehicle
Abfragen von Fahrzeugen
Abfragen von Fahrzeugen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vin
|
vin | string |
Filtert Fahrzeuge nach VIN |
|
|
Kennzeichennummer
|
licensePlateNum | string |
Filtert Fahrzeuge nach Kennzeichen |
|
|
Kunden-ID
|
customerId | string |
Filtert Fahrzeuge nach customerId |
|
|
Subscription Id (Abonnement-ID)
|
subscription_id | True | string |
Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
Client-ID
|
client_id | True | string |
Eine Client-ID, die für Entwickler/Lösungsanbieter eindeutig sein sollte, um die Lösung zu erstellen. |
|
Geheimer Clientschlüssel
|
client_secret | True | string |
Ein geheimer Clientschlüssel, der für Entwickler/Lösungsanbieter eindeutig sein sollte, der die Lösung erstellt. |
|
Anforderungs-ID
|
Request-Id | string |
Format - GUID. Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
Gibt zurück
- Body
- VehicleCollection
Aktualisieren eines Fahrzeugs
Aktualisieren eines Fahrzeugs
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Fahrzeug-ID
|
vehicleId | True | string |
Der Fahrzeugbezeichner |
|
Subscription Id (Abonnement-ID)
|
subscription_id | True | string |
Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
Client-ID
|
client_id | True | string |
Eine Client-ID, die für Entwickler/Lösungsanbieter eindeutig sein sollte, um die Lösung zu erstellen. |
|
Geheimer Clientschlüssel
|
client_secret | True | string |
Ein geheimer Clientschlüssel, der für Entwickler/Lösungsanbieter eindeutig sein sollte, der die Lösung erstellt. |
|
Anforderungs-ID
|
Request-Id | string |
Format - GUID. Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
|
eTag-Wert
|
If-Match | True | string |
Legt die Anforderung für die Ressourcenaktualisierung bedingt fest. Der Prüfsummenwert, der mit If-Match angezeigt wird, muss mit dem aktuellen ETag-Wert der Ressource übereinstimmen. |
|
Vin
|
vin | string |
Die Fahrzeug-Idenitificationsnummer |
|
|
licensePlateNum
|
licensePlateNum | string |
Die Kennzeichennummer des Fahrzeugs |
|
|
makeCode
|
makeCode | True | string |
Der Fahrzeug-Code |
|
machen
|
make | string |
Der Fahrzeugname |
|
|
modelCode
|
modelCode | True | string |
Der Fahrzeugmodellcode |
|
Modell
|
model | string |
Der Name des Fahrzeugmodells |
|
|
modelYear
|
modelYear | True | number |
Das Fahrzeugmodelljahr |
|
exteriorColor
|
exteriorColor | string |
Die Außenfarbe des Fahrzeugs |
|
|
value
|
value | True | number |
Der Messwert |
|
Einheiten
|
units | True | string |
Maßeinheiten |
|
status
|
status | True | string |
Ist der Status des Fahrzeugs neu, gebraucht oder zertifiziert? |
|
abgegeben
|
delivered | True | date |
Lieferdatum des Fahrzeugs an seinen aktuellen Eigentümer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
inService
|
inService | True | date |
Verkaufsdatum an den ursprünglichen Besitzer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
warrantyExpiration
|
warrantyExpiration | date |
Ablaufdatum der Garantie gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
|
ownerHref
|
ownerHref | string |
Der Link zur Kundenressource des Besitzers |
|
|
primaryDriverHref
|
primaryDriverHref | string |
Der Link zur primären Treiber-Kundenressource |
Gibt zurück
- Body
- Vehicle
Erstellen eines Fahrzeugs
Erstellen eines Fahrzeugs
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Client-ID
|
client_id | True | string |
Eine Client-ID, die für Entwickler/Lösungsanbieter eindeutig sein sollte, um die Lösung zu erstellen. |
|
Geheimer Clientschlüssel
|
client_secret | True | string |
Ein geheimer Clientschlüssel, der für Entwickler/Lösungsanbieter eindeutig sein sollte, der die Lösung erstellt. |
|
Subscription Id (Abonnement-ID)
|
subscription_id | True | string |
Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
Anforderungs-ID
|
Request-Id | True | string |
Format - GUID. Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
Vin
|
vin | string |
Die Fahrzeug-Idenitificationsnummer |
|
|
licensePlateNum
|
licensePlateNum | string |
Die Kennzeichennummer des Fahrzeugs |
|
|
makeCode
|
makeCode | True | string |
Der Fahrzeug-Code |
|
machen
|
make | string |
Der Fahrzeugname |
|
|
modelCode
|
modelCode | True | string |
Der Fahrzeugmodellcode |
|
Modell
|
model | string |
Der Name des Fahrzeugmodells |
|
|
modelYear
|
modelYear | True | number |
Das Fahrzeugmodelljahr |
|
exteriorColor
|
exteriorColor | string |
Die Außenfarbe des Fahrzeugs |
|
|
value
|
value | True | number |
Der Messwert |
|
Einheiten
|
units | True | string |
Maßeinheiten |
|
status
|
status | True | string |
Ist der Status des Fahrzeugs neu, gebraucht oder zertifiziert? |
|
abgegeben
|
delivered | True | date |
Lieferdatum des Fahrzeugs an seinen aktuellen Eigentümer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
inService
|
inService | True | date |
Verkaufsdatum an den ursprünglichen Besitzer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
warrantyExpiration
|
warrantyExpiration | date |
Ablaufdatum der Garantie gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
|
ownerHref
|
ownerHref | string |
Der Link zur Kundenressource des Besitzers |
|
|
primaryDriverHref
|
primaryDriverHref | string |
Der Link zur primären Treiber-Kundenressource |
Gibt zurück
- Body
- Vehicle
Definitionen
Fahrzeug
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
vehicleId
|
vehicleId | string |
Der Idenfizierer des Fahrzeugdatensatzes |
|
Identifizierung
|
identification | VehicleIdentification |
Fahrzeugidentifikation. Mindestens eine der Identifikationseigenschaften muss definiert werden, damit die Entität gültig ist. |
|
Spezifikation
|
specification | VehicleSpecification | |
|
exteriorColor
|
exteriorColor | string |
Die Außenfarbe des Fahrzeugs |
|
Fahrleistung
|
mileage | Measurement | |
|
status
|
status | string |
Ist der Status des Fahrzeugs neu, gebraucht oder zertifiziert? |
|
Datteln
|
dates | Dates | |
|
ownerHref
|
ownerHref | string |
Der Link zur Kundenressource des Besitzers |
|
primaryDriverHref
|
primaryDriverHref | string |
Der Link zur primären Treiber-Kundenressource |
|
Verknüpfungen
|
links | VehicleLinks |
VehicleIdentification
Fahrzeugidentifikation. Mindestens eine der Identifikationseigenschaften muss definiert werden, damit die Entität gültig ist.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Vin
|
vin | string |
Die Fahrzeug-Idenitificationsnummer |
|
licensePlateNum
|
licensePlateNum | string |
Die Kennzeichennummer des Fahrzeugs |
VehicleLinks
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Details einer Verknüpfung zu einer Ressource
|
self | LinkDescriptionObject |
VehicleCollection
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
items
|
items | array of Vehicle |
Fahrzeugspezifikation
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
makeCode
|
makeCode | string |
Der Fahrzeug-Code |
|
machen
|
make | string |
Der Fahrzeugname |
|
modelCode
|
modelCode | string |
Der Fahrzeugmodellcode |
|
Modell
|
model | string |
Der Name des Fahrzeugmodells |
|
modelYear
|
modelYear | number |
Das Fahrzeugmodelljahr |
Messung
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | number |
Der Messwert |
|
Einheiten
|
units | string |
Maßeinheiten |
Datteln
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
abgegeben
|
delivered | date |
Lieferdatum des Fahrzeugs an seinen aktuellen Eigentümer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
inService
|
inService | date |
Verkaufsdatum an den ursprünglichen Besitzer gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
|
warrantyExpiration
|
warrantyExpiration | date |
Ablaufdatum der Garantie gemäß RFC 3339, Abschnitt 5.6, z. B. 2017-07-21 |
LinkDescriptionObject
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
href
|
href | string |
Der Ziel-URI |
|
method
|
method | string |
Das HTTP-Verb, das zum Senden einer Anforderung an das Ziel des Links verwendet werden muss |
|
title
|
title | string |
Die Titeleigenschaft stellt einen Titel für den Link bereit und ist ein hilfreiches Dokumentationstool, um das Verständnis durch die Endbenutzer zu erleichtern. |