Delen via

CDK Drive Customer (preview)

Met de API kunt u serviceklanten zoeken, ophalen en filteren in CDK Drive. Binnen CDK Drive is een klant een persoon die een voertuig heeft verkocht, een prospect is op een voertuig, onderdelen heeft gekocht of zijn voertuig heeft gerepareerd of onderhouden via de dealer en bestaat in een CRM-systeem. Bovendien kunt u met deze connector een eenvoudige klantrecord maken. Dit helpt serviceadviseurs een positieve ervaring te bieden doordat deze werkstromen aan een klant kunnen worden gekoppeld.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam CDK Global
URL https://serviceconnect.support.cdk.com
E-mailen mbd_support@cdk.com
Connector-metagegevens
Uitgever CDK Global
Webpagina https://fortellis.io
Privacybeleid https://fortellis.io/privacy
Categorieën Gegevens

OVER

Met de CDKDrive Customer API V1 kunt u klantrecords zoeken, weergeven, maken en bijwerken in CDK Drive.

https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9

Sleutelbegrippen

Klanten

Een klant is een persoon in de DMS van het CDK-station die voldoet aan ten minste een van de volgende criteria:

  1. Een voertuig gekocht (of een prospect is om een voertuig aan te schaffen) bij de dealer
  2. Gekochte onderdelen van de dealer
  3. Een voertuig bij de dealer gebracht voor reparaties of service

Mogelijke gebruiksvoorbeelden

Gebruik de CDKDrive-klant-API om oplossingen te maken voor het afhandelen van situaties zoals:

  1. Een klant zoeken en klantgegevens weergeven
  2. Klantgegevens maken of bijwerken
  3. De voorkeurscontactmethoden van een klant bijwerken
  4. Klantgegevens ophalen om te koppelen aan voertuigen met de CDKDrive Service Vehicles-API

Gerelateerde API's

De CDKDrive-klant-API kan onafhankelijk of met een van de volgende API's worden gebruikt.

AANBIEDINGEN

Zoek en maak een deal met behulp van informatie over de klant en het voertuig dat ze kopen of leasen. De CDKDrive-klant-API kan worden gebruikt om klantrecords te koppelen aan deals. Deals-API: Vraag dealerschapsmedewerkers aan.

  1. https://apidocs-dev.fortellis.io/specs/91145f3f-2dd7-43fa-a63d-08908ef9e2e7

CDKDRIVE-REPARATIEORDERS

Schakel werkstromen voor het schrijven van services in op CDK Drive. De CDKDrive-klant-API kan worden gebruikt om klantrecords te koppelen aan reparatieorders.

https://apidocs.fortellis.io/specs/b0f20c99-ed1f-49de-a0e8-6776d2ee0fe3

CDKDRIVE-SERVICEVOERTUIGEN

Voertuiginformatie voor servicedomeinen maken, bijwerken, opvragen en ophalen in CDK Drive. U kunt klanten koppelen aan voertuigen met behulp van de CDKDrive Service Vehicles-API.

https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d

AAN DE SLAG MET DE CDKDRIVE-KLANT-API

Pre-requisites

U hebt het volgende nodig om door te gaan

• Als u de connector wilt gebruiken, moet u een Fortellis-gebruiker zijn.

• U moet een oplossing maken in Fortellis om de client-id en het geheim te genereren die moeten worden gebruikt tijdens het aanroepen van de API's

Gedetailleerde documentatie vindt u op

https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Een klant bijwerken

Een klant bijwerken
Een klant maken

Een klant maken
Een query uitvoeren op een klant

Een query uitvoeren op een klant
Query's uitvoeren op klanten

Query's uitvoeren op klanten

Een klant bijwerken

Bewerkings-id:
updateCustomer

Een klant bijwerken

Parameters

Name Sleutel Vereist Type Description
Klant-id
 customerId True string

De klant-id
Abonnements-id
 subscription_id True string

Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven.
Client-id
 client_id True string

Een client-id die uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Clientgeheim
 client_secret True string

Een clientgeheim dat uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Aanvraag-id
 Request-Id string

Indeling - guid. Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven
eTag
 If-Match True string

Hiermee wordt de aanvraag voor resource-updates voorwaardelijk. De controlesomwaarde die wordt weergegeven If-Match moet overeenkomen met de huidige ETag-waarde van de resource.
eerste
 first True string

De voornaam van de klant
midden
 middle string

De middelste naam van de klant
laatste
 last True string

De achternaam van de klant
prefix
 prefix string

Het voorvoegsel van de klant
achtervoegsel
 suffix string

Het achtervoegsel van de klant
primaryPhone
 primaryPhone string

Het primaire telefoonnummer van de klant
huistelefoon
 homePhone string

Het telefoonnummer voor thuisgebruik van de klant
mobiele telefoon
 mobilePhone string

Het mobiele telefoonnummer van de klant
Pager
 pager string

Het paginanummer van de klant
pagerAccessCode
 pagerAccessCode string

De pager-toegangscode van de klant
homeFax
 homeFax string

Het faxnummer voor thuisgebruik van de klant
workFax
 workFax string

Het faxnummer van het werk van de klant
e-mail1
 email1 string

E-mailadres 1 van de klant. U kunt NA invoeren voor niet-van toepassing of cd voor klant geweigerd als er geen ander e-mailadres aanwezig is
emailDesc1
 emailDesc1 string

Beschrijving van e-mailadres 1. Bevat NA of CD als deze zijn ingevoerd in e-mail1.
e-mail2
 email2 string

E-mailadres 2 van de klant
emailDesc2
 emailDesc2 string

Beschrijving van e-mailadres 2
e-mail3
 email3 string

E-mailadres 3 van de klant
emailDesc3
 emailDesc3 string

Beschrijving van e-mailadres 3
e-mail4
 email4 string

E-mailadres 4 van de klant
emailDesc4
 emailDesc4 string

Beschrijving van e-mailadres 4
e-mail5
 email5 string

E-mailadres 5 van de klant
emailDesc5
 emailDesc5 string

Beschrijving van e-mailadres 5
e-mail6
 email6 string

E-mailadres 6 van de klant
emailDesc6
 emailDesc6 string

Beschrijving van e-mailadres 6
preferredMethod
 preferredMethod string

De voorkeursmethode voor contact voor de klant
blockPhoneFlag
 blockPhoneFlag boolean

Geeft aan of telefoongesprekken wel of niet worden gebeld
blockEmailFlag
 blockEmailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd
blockMailFlag
 blockMailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd
straat
 street string

Kan straat, straat, weg, enz. zijn. Dit element omvat ook het huisnummer en kamer/appartement/flat/vloernummer.
city
 city string

Kan stad, dorp, stad, stadsdeel, etc. zijn. Dit is de poststad en niet noodzakelijkerwijs de woonplaats of plaats van zaken.
graafschap
 county string

Verwerkt administratieve districten, zoals Amerikaanse of Amerikaanse provincies die niet worden gebruikt voor e-mailadresseringsdoeleinden. Subregio is niet bedoeld voor afleveradressen.
state
 state string

Een staat, provincie, provincie (in Ierland), Land (in Duitsland), departement (in Frankrijk), enz.
postalCode
 postalCode string

Postcode. Meestal landbreed, maar soms specifiek voor de stad (bijvoorbeeld '2' in 'Dublin 2, Ierland'-adressen).
country
 country string

De ISO-landcode van het land

Retouren

Body
Customer

Een klant maken

Bewerkings-id:
createCustomer

Een klant maken

Parameters

Name Sleutel Vereist Type Description
Client-id
 client_id True string

Een client-id die uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Clientgeheim
 client_secret True string

Een clientgeheim dat uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Abonnements-id
 subscription_id True string

Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven.
Aanvraag-id
 Request-Id string

Indeling - guid. Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven
eerste
 first True string

De voornaam van de klant
midden
 middle string

De middelste naam van de klant
laatste
 last True string

De achternaam van de klant
prefix
 prefix string

Het voorvoegsel van de klant
achtervoegsel
 suffix string

Het achtervoegsel van de klant
primaryPhone
 primaryPhone string

Het primaire telefoonnummer van de klant
huistelefoon
 homePhone string

Het telefoonnummer voor thuisgebruik van de klant
mobiele telefoon
 mobilePhone string

Het mobiele telefoonnummer van de klant
Pager
 pager string

Het paginanummer van de klant
pagerAccessCode
 pagerAccessCode string

De pager-toegangscode van de klant
homeFax
 homeFax string

Het faxnummer voor thuisgebruik van de klant
workFax
 workFax string

Het faxnummer van het werk van de klant
e-mail1
 email1 string

E-mailadres 1 van de klant. U kunt NA invoeren voor niet-van toepassing of cd voor klant geweigerd als er geen ander e-mailadres aanwezig is
emailDesc1
 emailDesc1 string

Beschrijving van e-mailadres 1. Bevat NA of CD als deze zijn ingevoerd in e-mail1.
e-mail2
 email2 string

E-mailadres 2 van de klant
emailDesc2
 emailDesc2 string

Beschrijving van e-mailadres 2
e-mail3
 email3 string

E-mailadres 3 van de klant
emailDesc3
 emailDesc3 string

Beschrijving van e-mailadres 3
e-mail4
 email4 string

E-mailadres 4 van de klant
emailDesc4
 emailDesc4 string

Beschrijving van e-mailadres 4
e-mail5
 email5 string

E-mailadres 5 van de klant
emailDesc5
 emailDesc5 string

Beschrijving van e-mailadres 5
e-mail6
 email6 string

E-mailadres 6 van de klant
emailDesc6
 emailDesc6 string

Beschrijving van e-mailadres 6
preferredMethod
 preferredMethod string

De voorkeursmethode voor contact voor de klant
blockPhoneFlag
 blockPhoneFlag boolean

Geeft aan of telefoongesprekken wel of niet worden gebeld
blockEmailFlag
 blockEmailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd
blockMailFlag
 blockMailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd
straat
 street string

Kan straat, straat, weg, enz. zijn. Dit element omvat ook het huisnummer en kamer/appartement/flat/vloernummer.
city
 city string

Kan stad, dorp, stad, stadsdeel, etc. zijn. Dit is de poststad en niet noodzakelijkerwijs de woonplaats of plaats van zaken.
graafschap
 county string

Verwerkt administratieve districten, zoals Amerikaanse of Amerikaanse provincies die niet worden gebruikt voor e-mailadresseringsdoeleinden. Subregio is niet bedoeld voor afleveradressen.
state
 state string

Een staat, provincie, provincie (in Ierland), Land (in Duitsland), departement (in Frankrijk), enz.
postalCode
 postalCode string

Postcode. Meestal landbreed, maar soms specifiek voor de stad (bijvoorbeeld '2' in 'Dublin 2, Ierland'-adressen).
country
 country string

De ISO-landcode van het land

Retouren

Body
Customer

Een query uitvoeren op een klant

Bewerkings-id:
queryCustomerById

Een query uitvoeren op een klant

Parameters

Name Sleutel Vereist Type Description
Klant-id
 customerId True string

De klant-id
Abonnements-id
 subscription_id True string

Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven.
Client-id
 client_id True string

Een client-id die uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Clientgeheim
 client_secret True string

Een clientgeheim dat uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Aanvraag-id
 Request-Id string

Indeling - guid. Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven

Retouren

Body
Customer

Query's uitvoeren op klanten

Bewerkings-id:
queryCustomers

Query's uitvoeren op klanten

Parameters

Name Sleutel Vereist Type Description
Naam
 name string

Klanten filteren op naam
E-mailen
 email string

Klanten filteren op e-mailadres
Telefoon
 phone string

Hiermee filtert u klanten op telefoonnummer
Abonnements-id
 subscription_id True string

Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven.
Client-id
 client_id True string

Een client-id die uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Clientgeheim
 client_secret True string

Een clientgeheim dat uniek moet zijn voor ontwikkelaar/oplossingsprovider die de oplossing bouwt.
Aanvraag-id
 Request-Id string

Indeling - guid. Een correlatie-id die moet worden geretourneerd naar de aanroeper om de retour van de opgegeven aanvraag aan te geven

Retouren

Body
CustomerCollection

Definities

Customer

Name Pad Type Description
customerId
 customerId string

De id van de klantrecord
naam
 name Name
contactMethods
 contactMethods ContactMethods
postadres
 postalAddress PostalAddress
preferredContact
 preferredContact string

De voorkeursmethode voor contactpersonen
koppelingen
 links CustomerLinks

ContactMethods

Name Pad Type Description
primaryPhone
 primaryPhone string

Het primaire telefoonnummer van de klant
huistelefoon
 homePhone string

Het telefoonnummer voor thuisgebruik van de klant
mobiele telefoon
 mobilePhone string

Het mobiele telefoonnummer van de klant
Pager
 pager string

Het paginanummer van de klant
pagerAccessCode
 pagerAccessCode string

De pager-toegangscode van de klant
homeFax
 homeFax string

Het faxnummer voor thuisgebruik van de klant
workFax
 workFax string

Het faxnummer van het werk van de klant
e-mail1
 email1 string

E-mailadres 1 van de klant. U kunt NA invoeren voor niet-van toepassing of cd voor klant geweigerd als er geen ander e-mailadres aanwezig is
emailDesc1
 emailDesc1 string

Beschrijving van e-mailadres 1. Bevat NA of CD als deze zijn ingevoerd in e-mail1.
e-mail2
 email2 string

E-mailadres 2 van de klant
emailDesc2
 emailDesc2 string

Beschrijving van e-mailadres 2
e-mail3
 email3 string

E-mailadres 3 van de klant
emailDesc3
 emailDesc3 string

Beschrijving van e-mailadres 3
e-mail4
 email4 string

E-mailadres 4 van de klant
emailDesc4
 emailDesc4 string

Beschrijving van e-mailadres 4
e-mail5
 email5 string

E-mailadres 5 van de klant
emailDesc5
 emailDesc5 string

Beschrijving van e-mailadres 5
e-mail6
 email6 string

E-mailadres 6 van de klant
emailDesc6
 emailDesc6 string

Beschrijving van e-mailadres 6
preferredMethod
 preferredMethod string

De voorkeursmethode voor contact voor de klant
blockPhoneFlag
 blockPhoneFlag boolean

Geeft aan of telefoongesprekken wel of niet worden gebeld
blockEmailFlag
 blockEmailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd
blockMailFlag
 blockMailFlag boolean

Geeft aan of e-mailadvertenties al dan niet moeten worden geblokkeerd

PostalAddress

Name Pad Type Description
straat
 street string

Kan straat, straat, weg, enz. zijn. Dit element omvat ook het huisnummer en kamer/appartement/flat/vloernummer.
city
 city string

Kan stad, dorp, stad, stadsdeel, etc. zijn. Dit is de poststad en niet noodzakelijkerwijs de woonplaats of plaats van zaken.
graafschap
 county string

Verwerkt administratieve districten, zoals Amerikaanse of Amerikaanse provincies die niet worden gebruikt voor e-mailadresseringsdoeleinden. Subregio is niet bedoeld voor afleveradressen.
state
 state string

Een staat, provincie, provincie (in Ierland), Land (in Duitsland), departement (in Frankrijk), enz.
postalCode
 postalCode string

Postcode. Meestal landbreed, maar soms specifiek voor de stad (bijvoorbeeld '2' in 'Dublin 2, Ierland'-adressen).
country
 country string

De ISO-landcode van het land
Name Pad Type Description
Details van een koppeling naar een resource
 self LinkDescriptionObject

CustomerCollection

Name Pad Type Description
items
 items array of Customer

Naam

Name Pad Type Description
eerste
 first string

De voornaam van de klant
midden
 middle string

De middelste naam van de klant
laatste
 last string

De achternaam van de klant
prefix
 prefix string

Het voorvoegsel van de klant
achtervoegsel
 suffix string

Het achtervoegsel van de klant
companyName
 companyName string

Als de klant een bedrijf vertegenwoordigt, wordt de bedrijfsnaam overwogen

LinkDescriptionObject

Name Pad Type Description
href
 href string

De doel-URI
method
 method string

Het HTTP-woord dat moet worden gebruikt om een aanvraag naar het doel van de koppeling te maken
title
 title string

De titeleigenschap biedt een titel voor de koppeling en is een handig documentatieprogramma om inzicht te krijgen door eindclients