CDK Drive Customer (Vorschau)
Mit der API können Sie Dienstkunden im CDK-Laufwerk suchen, abrufen und filtern. Innerhalb von CDK Drive ist ein Kunde eine Person, die ein Fahrzeug verkauft hat, eine Aussicht auf ein Fahrzeug ist, Teile gekauft hat oder ihr Fahrzeug über die Händler repariert oder gewartet hat und in einem CRM-System existiert. Darüber hinaus können Sie mit diesem Connector einen einfachen Kundendatensatz erstellen. Dies hilft Serviceberatern dabei, eine positive Erfahrung zu erzielen, indem diese Workflows an einen Kunden gebunden werden können.
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 |
ÜBER
Mit der CDKDrive-Kunden-API V1 können Sie Kundendatensätze im CDK-Laufwerk durchsuchen, anzeigen, erstellen und aktualisieren.
https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9
Wichtige Konzepte
Kundschaft
Ein Kunde ist eine Einzelperson im CDK Drive DMS, die mindestens einen der folgenden Kriterien erfüllt:
- Ein Fahrzeug erworben (oder eine Aussicht auf den Kauf eines Fahrzeugs) vom Händler
- Gekaufte Teile aus der Händlerschaft
- Brachte ein Fahrzeug in die Händlerschaft für Reparaturen oder Service
Potenzielle Anwendungsfälle
Verwenden Sie die CDKDrive-Kunden-API, um Lösungen für die Behandlung von Situationen zu erstellen, z. B.:
- Suchen nach einem Kunden und Anzeigen von Kundendetails
- Erstellen oder Aktualisieren von Kundeninformationen
- Aktualisieren der bevorzugten Kontaktmethoden eines Kunden
- Abrufen von Kundeninformationen zum Verknüpfen mit Fahrzeugen mit der CDKDrive Service Vehicles API
Verwandte APIs
Die CDKDrive-Kunden-API kann unabhängig oder mit einer der folgenden APIs verwendet werden.
ANGEBOTE
Suchen und erstellen Sie einen Deal mithilfe von Informationen über den Kunden und das Fahrzeug, das sie kaufen oder leasing. Die CDKDrive-Kunden-API kann verwendet werden, um Kundendatensätze mit Deals zu verknüpfen. Deals-API: Abrufen von Händlermitarbeitern.
CDKDRIVE REPARATURAUFTRÄGE
Aktivieren Sie Dienstschreibworkflows auf CDK-Laufwerk. Die CDKDrive-Kunden-API kann verwendet werden, um Kundendatensätze mit Reparaturaufträgen zu verknüpfen.
https://apidocs.fortellis.io/specs/b0f20c99-ed1f-49de-a0e8-6776d2ee0fe3
CDKDRIVE SERVICE VEHICLES
Erstellen, Aktualisieren, Abfragen und Abrufen von Dienstdomänen-Fahrzeuginformationen im CDK-Laufwerk. Sie können Kunden über die CDKDrive Service Vehicles-API mit Fahrzeugen verknüpfen.
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
ERSTE SCHRITTE MIT DER CDKDRIVE-KUNDEN-API
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.
Detaillierte Dokumentation finden Sie unter
https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abfragen eines Kunden |
Abfragen eines Kunden |
| Aktualisieren eines Kunden |
Aktualisieren eines Kunden |
| Erstellen eines Kunden |
Erstellen eines Kunden |
| Kunden abfragen |
Kunden abfragen |
Abfragen eines Kunden
Abfragen eines Kunden
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kunden-ID
|
customerId | True | string |
Der Kundenbezeichner |
|
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
- Customer
Aktualisieren eines Kunden
Aktualisieren eines Kunden
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kunden-ID
|
customerId | True | string |
Der Kundenbezeichner |
|
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
|
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. |
|
erste
|
first | True | string |
Der Vorname des Kunden |
|
Mitte
|
middle | string |
Der zweite Name des Kunden |
|
|
last
|
last | True | string |
Der Nachname des Kunden |
|
prefix
|
prefix | string |
Das Präfix des Kunden |
|
|
Nachsilbe
|
suffix | string |
Das Suffix des Kunden |
|
|
primaryPhone
|
primaryPhone | string |
Die primäre Telefonnummer des Kunden |
|
|
homePhone
|
homePhone | string |
Die private Telefonnummer des Kunden |
|
|
mobilePhone
|
mobilePhone | string |
Die Mobiltelefonnummer des Kunden |
|
|
Piepser
|
pager | string |
Die Pagernummer des Kunden |
|
|
pagerAccessCode
|
pagerAccessCode | string |
Der Pager-Zugriffscode des Kunden |
|
|
homeFax
|
homeFax | string |
Die Private Faxnummer des Kunden |
|
|
workFax
|
workFax | string |
Die Geschäftliche Faxnummer des Kunden |
|
|
email1
|
email1 | string |
E-Mail-Adresse 1 des Kunden. Sie können NV für nicht anwendbare oder CD für abgelehnte Kunden eingeben, wenn keine andere E-Mail-Adresse vorhanden ist. |
|
|
emailDesc1
|
emailDesc1 | string |
E-Mail-Adresse 1 Beschreibung. Enthält NV oder CD, wenn sie in E-Mail1 eingegeben wird. |
|
|
email2
|
email2 | string |
E-Mail-Adresse 2 des Kunden |
|
|
emailDesc2
|
emailDesc2 | string |
E-Mail-Adresse 2 Beschreibung |
|
|
email3
|
email3 | string |
E-Mail-Adresse 3 des Kunden |
|
|
emailDesc3
|
emailDesc3 | string |
E-Mail-Adresse 3 Beschreibung |
|
|
email4
|
email4 | string |
E-Mail-Adresse 4 des Kunden |
|
|
emailDesc4
|
emailDesc4 | string |
E-Mail-Adresse 4 Beschreibung |
|
|
email5
|
email5 | string |
E-Mail-Adresse 5 des Kunden |
|
|
emailDesc5
|
emailDesc5 | string |
E-Mail-Adresse 5 Beschreibung |
|
|
email6
|
email6 | string |
E-Mail-Adresse 6 des Kunden |
|
|
emailDesc6
|
emailDesc6 | string |
E-Mail-Adresse 6 Beschreibung |
|
|
preferredMethod
|
preferredMethod | string |
Die bevorzugte Methode des Kontakts für den Kunden |
|
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Gibt an, ob Telefonwerbung telefonisiert werden soll. |
|
|
blockEmailFlag
|
blockEmailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
|
|
blockMailFlag
|
blockMailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
|
|
Straße
|
street | string |
Kann Straße, Straße, Straße usw. sein. Dieses Element enthält auch die Hausnummer und die Zimmer/Wohnung/Wohnung/Bodennummer. |
|
|
city
|
city | string |
Kann Stadt, Dorf, Stadt, Stadt, Bezirk usw. sein. Dies ist die Poststadt und nicht notwendigerweise der Wohnort oder Geschäftsort. |
|
|
Bezirk
|
county | string |
Behandelt Verwaltungsbezirke wie U.S. oder U.K. Countys, die nicht für E-Mail-Adressierungszwecke verwendet werden. Der Unterbereich ist nicht für Lieferadressen vorgesehen. |
|
|
Staat
|
state | string |
Ein Staat, eine Provinz, ein County (in Irland), Land (in Deutschland), departement (in Frankreich) usw. |
|
|
postalCode
|
postalCode | string |
Postleitzahl. In der Regel länderweit, aber manchmal spezifisch für die Stadt (z. B. "2" in "Dublin 2, Irland" Adressen). |
|
|
country
|
country | string |
Der ISO-Ländercode des Landes |
Gibt zurück
- Body
- Customer
Erstellen eines Kunden
Erstellen eines Kunden
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 | string |
Format - GUID. Eine Korrelations-ID, die an den Aufrufer zurückgesendet werden soll, um die Rückgabe der angegebenen Anforderung anzugeben. |
|
|
erste
|
first | True | string |
Der Vorname des Kunden |
|
Mitte
|
middle | string |
Der zweite Name des Kunden |
|
|
last
|
last | True | string |
Der Nachname des Kunden |
|
prefix
|
prefix | string |
Das Präfix des Kunden |
|
|
Nachsilbe
|
suffix | string |
Das Suffix des Kunden |
|
|
primaryPhone
|
primaryPhone | string |
Die primäre Telefonnummer des Kunden |
|
|
homePhone
|
homePhone | string |
Die private Telefonnummer des Kunden |
|
|
mobilePhone
|
mobilePhone | string |
Die Mobiltelefonnummer des Kunden |
|
|
Piepser
|
pager | string |
Die Pagernummer des Kunden |
|
|
pagerAccessCode
|
pagerAccessCode | string |
Der Pager-Zugriffscode des Kunden |
|
|
homeFax
|
homeFax | string |
Die Private Faxnummer des Kunden |
|
|
workFax
|
workFax | string |
Die Geschäftliche Faxnummer des Kunden |
|
|
email1
|
email1 | string |
E-Mail-Adresse 1 des Kunden. Sie können NV für nicht anwendbare oder CD für abgelehnte Kunden eingeben, wenn keine andere E-Mail-Adresse vorhanden ist. |
|
|
emailDesc1
|
emailDesc1 | string |
E-Mail-Adresse 1 Beschreibung. Enthält NV oder CD, wenn sie in E-Mail1 eingegeben wird. |
|
|
email2
|
email2 | string |
E-Mail-Adresse 2 des Kunden |
|
|
emailDesc2
|
emailDesc2 | string |
E-Mail-Adresse 2 Beschreibung |
|
|
email3
|
email3 | string |
E-Mail-Adresse 3 des Kunden |
|
|
emailDesc3
|
emailDesc3 | string |
E-Mail-Adresse 3 Beschreibung |
|
|
email4
|
email4 | string |
E-Mail-Adresse 4 des Kunden |
|
|
emailDesc4
|
emailDesc4 | string |
E-Mail-Adresse 4 Beschreibung |
|
|
email5
|
email5 | string |
E-Mail-Adresse 5 des Kunden |
|
|
emailDesc5
|
emailDesc5 | string |
E-Mail-Adresse 5 Beschreibung |
|
|
email6
|
email6 | string |
E-Mail-Adresse 6 des Kunden |
|
|
emailDesc6
|
emailDesc6 | string |
E-Mail-Adresse 6 Beschreibung |
|
|
preferredMethod
|
preferredMethod | string |
Die bevorzugte Methode des Kontakts für den Kunden |
|
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Gibt an, ob Telefonwerbung telefonisiert werden soll. |
|
|
blockEmailFlag
|
blockEmailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
|
|
blockMailFlag
|
blockMailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
|
|
Straße
|
street | string |
Kann Straße, Straße, Straße usw. sein. Dieses Element enthält auch die Hausnummer und die Zimmer/Wohnung/Wohnung/Bodennummer. |
|
|
city
|
city | string |
Kann Stadt, Dorf, Stadt, Stadt, Bezirk usw. sein. Dies ist die Poststadt und nicht notwendigerweise der Wohnort oder Geschäftsort. |
|
|
Bezirk
|
county | string |
Behandelt Verwaltungsbezirke wie U.S. oder U.K. Countys, die nicht für E-Mail-Adressierungszwecke verwendet werden. Der Unterbereich ist nicht für Lieferadressen vorgesehen. |
|
|
Staat
|
state | string |
Ein Staat, eine Provinz, ein County (in Irland), Land (in Deutschland), departement (in Frankreich) usw. |
|
|
postalCode
|
postalCode | string |
Postleitzahl. In der Regel länderweit, aber manchmal spezifisch für die Stadt (z. B. "2" in "Dublin 2, Irland" Adressen). |
|
|
country
|
country | string |
Der ISO-Ländercode des Landes |
Gibt zurück
- Body
- Customer
Kunden abfragen
Kunden abfragen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | string |
Filtert Kunden nach Namen |
|
|
Email
|
string |
Filtert Kunden nach E-Mail-Adresse |
||
|
Telefonnummer
|
phone | string |
Filtert Kunden nach Telefonnummer |
|
|
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
- CustomerCollection
Definitionen
Customer
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
customerId
|
customerId | string |
Der Bezeichner des Kundendatensatzes |
|
name
|
name | Name | |
|
contactMethods
|
contactMethods | ContactMethods | |
|
postalAddress
|
postalAddress | PostalAddress | |
|
preferredContact
|
preferredContact | string |
Die bevorzugte Kontaktmethode |
|
Verknüpfungen
|
links | CustomerLinks |
ContactMethods
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
primaryPhone
|
primaryPhone | string |
Die primäre Telefonnummer des Kunden |
|
homePhone
|
homePhone | string |
Die private Telefonnummer des Kunden |
|
mobilePhone
|
mobilePhone | string |
Die Mobiltelefonnummer des Kunden |
|
Piepser
|
pager | string |
Die Pagernummer des Kunden |
|
pagerAccessCode
|
pagerAccessCode | string |
Der Pager-Zugriffscode des Kunden |
|
homeFax
|
homeFax | string |
Die Private Faxnummer des Kunden |
|
workFax
|
workFax | string |
Die Geschäftliche Faxnummer des Kunden |
|
email1
|
email1 | string |
E-Mail-Adresse 1 des Kunden. Sie können NV für nicht anwendbare oder CD für abgelehnte Kunden eingeben, wenn keine andere E-Mail-Adresse vorhanden ist. |
|
emailDesc1
|
emailDesc1 | string |
E-Mail-Adresse 1 Beschreibung. Enthält NV oder CD, wenn sie in E-Mail1 eingegeben wird. |
|
email2
|
email2 | string |
E-Mail-Adresse 2 des Kunden |
|
emailDesc2
|
emailDesc2 | string |
E-Mail-Adresse 2 Beschreibung |
|
email3
|
email3 | string |
E-Mail-Adresse 3 des Kunden |
|
emailDesc3
|
emailDesc3 | string |
E-Mail-Adresse 3 Beschreibung |
|
email4
|
email4 | string |
E-Mail-Adresse 4 des Kunden |
|
emailDesc4
|
emailDesc4 | string |
E-Mail-Adresse 4 Beschreibung |
|
email5
|
email5 | string |
E-Mail-Adresse 5 des Kunden |
|
emailDesc5
|
emailDesc5 | string |
E-Mail-Adresse 5 Beschreibung |
|
email6
|
email6 | string |
E-Mail-Adresse 6 des Kunden |
|
emailDesc6
|
emailDesc6 | string |
E-Mail-Adresse 6 Beschreibung |
|
preferredMethod
|
preferredMethod | string |
Die bevorzugte Methode des Kontakts für den Kunden |
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Gibt an, ob Telefonwerbung telefonisiert werden soll. |
|
blockEmailFlag
|
blockEmailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
|
blockMailFlag
|
blockMailFlag | boolean |
Gibt an, ob E-Mail-Werbung blockiert werden soll. |
PostalAddress
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Straße
|
street | string |
Kann Straße, Straße, Straße usw. sein. Dieses Element enthält auch die Hausnummer und die Zimmer/Wohnung/Wohnung/Bodennummer. |
|
city
|
city | string |
Kann Stadt, Dorf, Stadt, Stadt, Bezirk usw. sein. Dies ist die Poststadt und nicht notwendigerweise der Wohnort oder Geschäftsort. |
|
Bezirk
|
county | string |
Behandelt Verwaltungsbezirke wie U.S. oder U.K. Countys, die nicht für E-Mail-Adressierungszwecke verwendet werden. Der Unterbereich ist nicht für Lieferadressen vorgesehen. |
|
Staat
|
state | string |
Ein Staat, eine Provinz, ein County (in Irland), Land (in Deutschland), departement (in Frankreich) usw. |
|
postalCode
|
postalCode | string |
Postleitzahl. In der Regel länderweit, aber manchmal spezifisch für die Stadt (z. B. "2" in "Dublin 2, Irland" Adressen). |
|
country
|
country | string |
Der ISO-Ländercode des Landes |
CustomerLinks
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Details einer Verknüpfung zu einer Ressource
|
self | LinkDescriptionObject |
CustomerCollection
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
items
|
items | array of Customer |
Name
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
erste
|
first | string |
Der Vorname des Kunden |
|
Mitte
|
middle | string |
Der zweite Name des Kunden |
|
last
|
last | string |
Der Nachname des Kunden |
|
prefix
|
prefix | string |
Das Präfix des Kunden |
|
Nachsilbe
|
suffix | string |
Das Suffix des Kunden |
|
companyName
|
companyName | string |
Wenn der Kunde ein Unternehmen darstellt, wird der Firmenname berücksichtigt. |
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 von Endbenutzern zu erleichtern. |