CDK Drive Service Vehicles (préversion)
CDK Drive Service Vehicle Associates identification, type, status et customer information about a vehicle. L’API vous permet de créer, mettre à jour, interroger et récupérer des informations de véhicule de domaine de service dans CDK.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | CDK Global |
| URL | https://serviceconnect.support.cdk.com |
| Messagerie électronique | mbd_support@cdk.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | CDK Global |
| Site internet | https://fortellis.io |
| Politique de confidentialité | https://fortellis.io/privacy |
| Catégories | Data |
Lecteur CDK - Service - Véhicules Associe l’identification, le type, l’état et les informations client sur un véhicule.
Que fait cette API ? L’API vous permet de créer, mettre à jour, interroger et récupérer des informations sur le véhicule de domaine de service dans le lecteur CDK.
Le véhicule d’audience prévu est une dépendance pour les flux de travail de rendez-vous de service et de commande de réparation de service.
Conditions préalables
Vous aurez besoin des éléments suivants pour continuer
• Pour utiliser le connecteur, vous devez être un utilisateur Fortellis.
• Vous devez créer une solution dans Fortellis pour générer l’ID client et le secret à utiliser lors de l’appel des API
Cas d’usage potentiels
Utilisez l’API CDKDrive Service Vehicles pour créer des solutions pour gérer des situations telles que :
- Créer ou mettre à jour des informations sur le véhicule de service
- Lier un client à un véhicule de service
- Rechercher des véhicules de service existants par ID ou critères de filtre
Vous trouverez une documentation détaillée à l’adresse
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Créer un véhicule |
Créer un véhicule |
| Interroger des véhicules |
Interroger des véhicules |
| Interroger un véhicule par identificateur |
Interroger un véhicule par identificateur |
| Mettre à jour un véhicule |
Mettre à jour un véhicule |
Créer un véhicule
Créer un véhicule
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID client
|
client_id | True | string |
ID client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
Clé secrète client
|
client_secret | True | string |
Clé secrète client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
ID d’abonnement
|
subscription_id | True | string |
ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée. |
|
ID de demande
|
Request-Id | True | string |
Format - guid. ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée |
|
vin
|
vin | string |
Numéro d’idenitification du véhicule |
|
|
licensePlateNum
|
licensePlateNum | string |
Numéro de plaque d’immatriculation du véhicule |
|
|
makeCode
|
makeCode | True | string |
Le véhicule fait du code |
|
faire
|
make | string |
Le nom du véhicule |
|
|
modelCode
|
modelCode | True | string |
Code du modèle de véhicule |
|
model
|
model | string |
Nom du modèle de véhicule |
|
|
modelYear
|
modelYear | True | number |
Année du modèle de véhicule |
|
extérieurColor
|
exteriorColor | string |
Couleur extérieure du véhicule |
|
|
value
|
value | True | number |
Valeur de mesure |
|
Unités
|
units | True | string |
Unités de mesure |
|
status
|
status | True | string |
Le statut du véhicule est-il nouveau, utilisé ou certifié ? |
|
delivered
|
delivered | True | date |
Date de livraison du véhicule à son propriétaire actuel tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
inService
|
inService | True | date |
Date de vente au détail au propriétaire d’origine tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
garantieExpiration
|
warrantyExpiration | date |
Date d’expiration de la garantie du véhicule tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
|
ownerHref
|
ownerHref | string |
Lien hypertexte vers la ressource du client propriétaire |
|
|
primaryDriverHref
|
primaryDriverHref | string |
Lien hypertexte vers la ressource du client du pilote principal |
Retours
- Corps
- Vehicle
Interroger des véhicules
Interroger des véhicules
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Vin
|
vin | string |
Filtre les véhicules par VIN |
|
|
Numéro de plaque d’immatriculation
|
licensePlateNum | string |
Filtre les véhicules par numéro de plaque d’immatriculation |
|
|
ID client
|
customerId | string |
Filtre les véhicules par customerId |
|
|
ID d’abonnement
|
subscription_id | True | string |
ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée. |
|
ID client
|
client_id | True | string |
ID client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
Clé secrète client
|
client_secret | True | string |
Clé secrète client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
ID de demande
|
Request-Id | string |
Format - guid. ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée |
Retours
- Corps
- VehicleCollection
Interroger un véhicule par identificateur
Interroger un véhicule par identificateur
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du véhicule
|
vehicleId | True | string |
Identificateur du véhicule |
|
ID d’abonnement
|
subscription_id | True | string |
ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée. |
|
ID client
|
client_id | True | string |
ID client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
Clé secrète client
|
client_secret | True | string |
Clé secrète client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
ID de demande
|
Request-Id | string |
Format - guid. ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée |
Retours
- Corps
- Vehicle
Mettre à jour un véhicule
Mettre à jour un véhicule
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du véhicule
|
vehicleId | True | string |
Identificateur du véhicule |
|
ID d’abonnement
|
subscription_id | True | string |
ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée. |
|
ID client
|
client_id | True | string |
ID client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
Clé secrète client
|
client_secret | True | string |
Clé secrète client qui doit être unique au fournisseur de développement/solution qui crée la solution. |
|
ID de demande
|
Request-Id | string |
Format - guid. ID de corrélation qui doit être retourné à l’appelant pour indiquer le retour de la demande donnée |
|
|
Valeur eTag
|
If-Match | True | string |
Rend la demande de mise à jour des ressources conditionnelle. La valeur de somme de contrôle présentée avec If-Match doit correspondre à la valeur ETag actuelle de la ressource. |
|
vin
|
vin | string |
Numéro d’idenitification du véhicule |
|
|
licensePlateNum
|
licensePlateNum | string |
Numéro de plaque d’immatriculation du véhicule |
|
|
makeCode
|
makeCode | True | string |
Le véhicule fait du code |
|
faire
|
make | string |
Le nom du véhicule |
|
|
modelCode
|
modelCode | True | string |
Code du modèle de véhicule |
|
model
|
model | string |
Nom du modèle de véhicule |
|
|
modelYear
|
modelYear | True | number |
Année du modèle de véhicule |
|
extérieurColor
|
exteriorColor | string |
Couleur extérieure du véhicule |
|
|
value
|
value | True | number |
Valeur de mesure |
|
Unités
|
units | True | string |
Unités de mesure |
|
status
|
status | True | string |
Le statut du véhicule est-il nouveau, utilisé ou certifié ? |
|
delivered
|
delivered | True | date |
Date de livraison du véhicule à son propriétaire actuel tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
inService
|
inService | True | date |
Date de vente au détail au propriétaire d’origine tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
garantieExpiration
|
warrantyExpiration | date |
Date d’expiration de la garantie du véhicule tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
|
ownerHref
|
ownerHref | string |
Lien hypertexte vers la ressource du client propriétaire |
|
|
primaryDriverHref
|
primaryDriverHref | string |
Lien hypertexte vers la ressource du client du pilote principal |
Retours
- Corps
- Vehicle
Définitions
Véhicule
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
vehicleId
|
vehicleId | string |
L’idenifier de l’enregistrement du véhicule |
|
identification
|
identification | VehicleIdentification |
Identification du véhicule. Au moins une des propriétés d’identification doit être définie pour que l’entité soit valide. |
|
spécification
|
specification | VehicleSpecification | |
|
extérieurColor
|
exteriorColor | string |
Couleur extérieure du véhicule |
|
kilométrage
|
mileage | Measurement | |
|
status
|
status | string |
Le statut du véhicule est-il nouveau, utilisé ou certifié ? |
|
dattes
|
dates | Dates | |
|
ownerHref
|
ownerHref | string |
Lien hypertexte vers la ressource du client propriétaire |
|
primaryDriverHref
|
primaryDriverHref | string |
Lien hypertexte vers la ressource du client du pilote principal |
|
links
|
links | VehicleLinks |
VehicleIdentification
Identification du véhicule. Au moins une des propriétés d’identification doit être définie pour que l’entité soit valide.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
vin
|
vin | string |
Numéro d’idenitification du véhicule |
|
licensePlateNum
|
licensePlateNum | string |
Numéro de plaque d’immatriculation du véhicule |
VehicleLinks
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Détails d’un lien vers une ressource
|
self | LinkDescriptionObject |
VehicleCollection
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
items
|
items | array of Vehicle |
VehicleSpecification
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
makeCode
|
makeCode | string |
Le véhicule fait du code |
|
faire
|
make | string |
Le nom du véhicule |
|
modelCode
|
modelCode | string |
Code du modèle de véhicule |
|
model
|
model | string |
Nom du modèle de véhicule |
|
modelYear
|
modelYear | number |
Année du modèle de véhicule |
Mesure
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | number |
Valeur de mesure |
|
Unités
|
units | string |
Unités de mesure |
Dattes
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
delivered
|
delivered | date |
Date de livraison du véhicule à son propriétaire actuel tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
inService
|
inService | date |
Date de vente au détail au propriétaire d’origine tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
|
garantieExpiration
|
warrantyExpiration | date |
Date d’expiration de la garantie du véhicule tel que défini par RFC 3339, section 5.6, par exemple, 2017-07-21 |
LinkDescriptionObject
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
href
|
href | string |
URI cible |
|
method
|
method | string |
Verbe HTTP qui DOIT être utilisé pour effectuer une requête à la cible du lien |
|
title
|
title | string |
La propriété title fournit un titre pour le lien et est un outil de documentation utile pour faciliter la compréhension par les clients finaux |