Freigeben über


Elead Sales Customers (Vorschau)

Diese API ermöglicht die Verwaltung von Aussichts-/Kundeninformationen innerhalb des Elead CRM. Diese API enthält die folgenden Funktionen und Features zum Verwalten von Kundeninformationen für Potenzielle/Kunden, Hinzufügen von Potenziellen/Kundeninformationen wie Name, Telefonnummern, E-Mail-Adressen und physischer Adresse und Zurückgeben der eindeutig zugewiesenen Elead-ID nach Post, Aktualisieren, Suchen und Abrufen von Potenziellen/Kundenkontaktinformationen, die mit einer vorhandenen Elead-ID verknüpft sind.

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
Email mbd_support@cdk.com
Connectormetadaten
Herausgeber CDK Global
Webseite https://fortellis.io
Datenschutzrichtlinie https://fortellis.io/privacy
Kategorien Daten

Was geschieht mit dieser API?

Diese API ermöglicht die Verwaltung von Aussichts-/Kundeninformationen innerhalb des Elead CRM.

Beabsichtigte Zielgruppe

Diese API richtet sich an Händler und Lieferantenpartner, die Aussichts-/Kundendaten innerhalb des Elead CRM verwalten müssen.

Funktionen und Features

Diese API enthält die folgenden Funktionen und Features zum Verwalten von Kundeninformationen.

  • Hinzufügen von Potenziellen/Kundeninformationen wie Name, Telefonnummern, E-Mail-Adressen und physischer Adresse
  • Aktualisieren von Kontaktinformationen für Interessenten/Kunden, die an eine vorhandene Elead-ID gebunden sind
  • Abrufen von Interessenten/Kunden anhand ihrer Elead-ID
  • Durchsuchen von Interessenten/Kunden anhand ihres Namens, ihrer E-Mail-Adresse oder Telefonnummer
  • Abrufen von Interessenten-/Kundenbesitzfahrzeugen mit ihrer Elead-ID

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/ba092364-accc-4ad9-865f-fac51c34cdb1

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Aktualisieren eines Kunden

Aktualisiert Prospekt-/Kundeninformationen

Erstellen eines Kunden

Erstellt eine Aussicht/einen Kunden

Fahrzeuge nach ID abrufen

Ruft einen Kunden-/Kundenfahrzeugdatensatz(n) anhand der Elead-Kunden-ID ab. Eine Elead-Kunden-ID wird derzeit wie folgt abgerufen:

  • Kunden über POST /sales/v1/elead/customers erstellen

  • Suchmöglichkeiten über GET /sales/v1/elead/opportunities/search

Kunden nach ID abrufen

Ruft einen Interessenten-/Kundendatensatz von der Elead-Kunden-ID ab. Eine Elead-Kunden-ID wird derzeit wie folgt abgerufen:

  • Kunden über POST /sales/v1/elead/customers erstellen

  • Suchmöglichkeiten über GET /sales/v1/elead/opportunities/search

Kunden suchen

Kunden suchen

Aktualisieren eines Kunden

Aktualisiert Prospekt-/Kundeninformationen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kunden-ID
customerId True string

Format - uuid.

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.

Akzeptieren
Accept string

Kopfzeile annehmen

Accept-Charset
Accept-Charset string

kopfzeile Accept-Charset

Accept-Encoding
Accept-Encoding string

kopfzeile Accept-Encoding

Accept-Language
Accept-Language string

kopfzeile Accept-Language

If-Match
If-Match string

kopfzeile If-Match

If-None-Match
If-None-Match string

If-None-Match Kopfzeile

Vorziehen
Prefer string

Vorzug des Kunden

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.

isBusiness
isBusiness boolean

true/false, ob dieser Kunde ein Unternehmen ist

businessName
businessName string

Geschäftsname, festlegen, wenn isBusiness wahr ist

businessContact
businessContact string

Name der Geschäftskontaktperson, festgelegt, wenn isBusiness wahr ist

title
title string

Titel des Kunden

Vorname
firstName string

Vorname des Kunden

MiddleName
middleName string

Zweiter Name des Kunden

lastName
lastName string

Nachname des Kunden

Spitzname
nickname string

Kundenspitzname

birthday
birthday date-time

Geburtstag des Kunden

address
address True string

E-Mail-Adresse des Kunden

emailType
emailType True string
doNotEmail
doNotEmail boolean

true/false, um als "Keine E-Mail" zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte E-Mail-Adresse des Kunden ist

number
number True string

Telefonnummer

phoneType
phoneType True string
preferredTimeToContact
preferredTimeToContact True string
doNotCall
doNotCall boolean

true/false, um als "Nicht anrufen" zu kennzeichnen

doNotText
doNotText boolean

true/false, um als "Nicht-Text" zu kennzeichnen

preferCall
preferCall boolean

true/false, ob der Kunde lieber per Telefon kontaktiert werden möchte

preferText
preferText boolean

true/false, ob der Kunde lieber per Text kontaktiert werden möchte

AdresseZeile1
addressLine1 string

Kundenadresse Zeile 1

AdresseZeile2
addressLine2 string

Kundenadresse Zeile 2

city
city string

Stadt des Kunden

Staat
state string

Bundesland/Kanton des Kunden

zip
zip True string

Customer postal code (Postleitzahl des Kunden)

country
country string

Kundenland

Bezirk
county string

Kundenkreis

doNotMail
doNotMail boolean

true/false, um als Nicht-E-Mail zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte Adresse des Kunden ist

Gibt zurück

Body
Customer

Erstellen eines Kunden

Erstellt eine Aussicht/einen 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.

Akzeptieren
Accept string

Kopfzeile annehmen

Accept-Charset
Accept-Charset string

kopfzeile Accept-Charset

Accept-Encoding
Accept-Encoding string

kopfzeile Accept-Encoding

Accept-Language
Accept-Language string

kopfzeile Accept-Language

If-Match
If-Match string

kopfzeile If-Match

If-None-Match
If-None-Match string

If-None-Match Kopfzeile

Vorziehen
Prefer string

Vorzug des Kunden

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.

isBusiness
isBusiness boolean

true/false, ob dieser Kunde ein Unternehmen ist

businessName
businessName string

Geschäftsname, festlegen, wenn isBusiness wahr ist

businessContact
businessContact string

Name der Geschäftskontaktperson, festgelegt, wenn isBusiness wahr ist

title
title string

Titel des Kunden

Vorname
firstName string

Vorname des Kunden

MiddleName
middleName string

Zweiter Name des Kunden

lastName
lastName string

Nachname des Kunden

Spitzname
nickname string

Kundenspitzname

birthday
birthday date-time

Geburtstag des Kunden

address
address True string

E-Mail-Adresse des Kunden

emailType
emailType True string
doNotEmail
doNotEmail boolean

true/false, um als "Keine E-Mail" zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte E-Mail-Adresse des Kunden ist

number
number True string

Telefonnummer

phoneType
phoneType True string
preferredTimeToContact
preferredTimeToContact True string
doNotCall
doNotCall boolean

true/false, um als "Nicht anrufen" zu kennzeichnen

doNotText
doNotText boolean

true/false, um als "Nicht-Text" zu kennzeichnen

preferCall
preferCall boolean

true/false, ob der Kunde lieber per Telefon kontaktiert werden möchte

preferText
preferText boolean

true/false, ob der Kunde lieber per Text kontaktiert werden möchte

AdresseZeile1
addressLine1 string

Kundenadresse Zeile 1

AdresseZeile2
addressLine2 string

Kundenadresse Zeile 2

city
city string

Stadt des Kunden

Staat
state string

Bundesland/Kanton des Kunden

zip
zip True string

Customer postal code (Postleitzahl des Kunden)

country
country string

Kundenland

Bezirk
county string

Kundenkreis

doNotMail
doNotMail boolean

true/false, um als Nicht-E-Mail zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte Adresse des Kunden ist

Gibt zurück

Body
Customer

Fahrzeuge nach ID abrufen

Ruft einen Kunden-/Kundenfahrzeugdatensatz(n) anhand der Elead-Kunden-ID ab. Eine Elead-Kunden-ID wird derzeit wie folgt abgerufen:

  • Kunden über POST /sales/v1/elead/customers erstellen

  • Suchmöglichkeiten über GET /sales/v1/elead/opportunities/search

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kunden-ID
customerId True string

Format - uuid.

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.

Akzeptieren
Accept string

Kopfzeile annehmen

Accept-Charset
Accept-Charset string

kopfzeile Accept-Charset

Accept-Encoding
Accept-Encoding string

kopfzeile Accept-Encoding

Accept-Language
Accept-Language string

kopfzeile Accept-Language

If-Match
If-Match string

kopfzeile If-Match

If-None-Match
If-None-Match string

If-None-Match Kopfzeile

Vorziehen
Prefer string

Vorzug des Kunden

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.

Gibt zurück

Kunden nach ID abrufen

Ruft einen Interessenten-/Kundendatensatz von der Elead-Kunden-ID ab. Eine Elead-Kunden-ID wird derzeit wie folgt abgerufen:

  • Kunden über POST /sales/v1/elead/customers erstellen

  • Suchmöglichkeiten über GET /sales/v1/elead/opportunities/search

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kunden-ID
customerId True string

Format - uuid.

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.

Akzeptieren
Accept string

Kopfzeile annehmen

Accept-Charset
Accept-Charset string

kopfzeile Accept-Charset

Accept-Encoding
Accept-Encoding string

kopfzeile Accept-Encoding

Accept-Language
Accept-Language string

kopfzeile Accept-Language

If-Match
If-Match string

kopfzeile If-Match

If-None-Match
If-None-Match string

If-None-Match Kopfzeile

Vorziehen
Prefer string

Vorzug des Kunden

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.

Gibt zurück

Body
Customer

Kunden suchen

Kunden suchen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seite
page integer

Format - int32.

Seitenformat
pageSize integer

Format - int32.

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.

Akzeptieren
Accept string

Kopfzeile annehmen

Accept-Charset
Accept-Charset string

kopfzeile Accept-Charset

Accept-Encoding
Accept-Encoding string

kopfzeile Accept-Encoding

Accept-Language
Accept-Language string

kopfzeile Accept-Language

If-Match
If-Match string

kopfzeile If-Match

If-None-Match
If-None-Match string

If-None-Match Kopfzeile

Vorziehen
Prefer string

Vorzug des Kunden

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.

Vorname
firstName string

Suchzeichenfolge für den Vornamen des Kunden

lastName
lastName string

Suchzeichenfolge für den Nachnamen des Kunden

Telefonnummer
phoneNumber string

Suchzeichenfolge für die Telefonnummer des Kunden

E-Mail-Adresse
emailAddress string

Suchzeichenfolge für die E-Mail-Adresse des Kunden

Gibt zurück

Definitionen

Customer

Name Pfad Typ Beschreibung
id
id uuid

Eindeutiger Kundenbezeichner

isBusiness
isBusiness boolean

true/false, ob dieser Kunde ein Unternehmen ist

businessName
businessName string

Geschäftsname, festlegen, wenn isBusiness wahr ist

businessContact
businessContact string

Name der Geschäftskontaktperson, festgelegt, wenn isBusiness wahr ist

title
title string

Titel des Kunden

Vorname
firstName string

Vorname des Kunden

MiddleName
middleName string

Zweiter Name des Kunden

lastName
lastName string

Nachname des Kunden

Spitzname
nickname string

Kundenspitzname

birthday
birthday date-time

Geburtstag des Kunden

E-Mails
emails array of CustomerEmail

Kunden-E-Mail-Adresse(n)

phones
phones array of CustomerPhone

Telefonnummern des Kunden

address
address CustomerAddress
Verknüpfungen
links array of LinkDescriptionObject

Eine Sammlung von HATEOAS-Links

Kunden-E-Mail

Name Pfad Typ Beschreibung
address
address string

E-Mail-Adresse des Kunden

emailType
emailType string
doNotEmail
doNotEmail boolean

true/false, um als "Keine E-Mail" zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte E-Mail-Adresse des Kunden ist

CustomerPhone

Name Pfad Typ Beschreibung
number
number string

Telefonnummer

phoneType
phoneType string
preferredTimeToContact
preferredTimeToContact string
doNotCall
doNotCall boolean

true/false, um als "Nicht anrufen" zu kennzeichnen

doNotText
doNotText boolean

true/false, um als "Nicht-Text" zu kennzeichnen

preferCall
preferCall boolean

true/false, ob der Kunde lieber per Telefon kontaktiert werden möchte

preferText
preferText boolean

true/false, ob der Kunde lieber per Text kontaktiert werden möchte

CustomerAddress

Name Pfad Typ Beschreibung
AdresseZeile1
addressLine1 string

Kundenadresse Zeile 1

AdresseZeile2
addressLine2 string

Kundenadresse Zeile 2

city
city string

Stadt des Kunden

Staat
state string

Bundesland/Kanton des Kunden

zip
zip string

Customer postal code (Postleitzahl des Kunden)

country
country string

Kundenland

Bezirk
county string

Kundenkreis

doNotMail
doNotMail boolean

true/false, um als Nicht-E-Mail zu kennzeichnen

isPreferred
isPreferred boolean

true/false, ob dies die bevorzugte Adresse des Kunden ist

SearchCustomersResponse

Name Pfad Typ Beschreibung
items
items array of SearchCustomer

Eine Sammlung von Kundensuchergebnissen

totalItems
totalItems integer

Gesamtanzahl der Kunden für die angegebene Suche

totalPages
totalPages integer

Gesamtanzahl der Seiten von Kunden für die angegebene Suche

pageNumber
pageNumber integer

Aktuelle Seitenzahl für diese Gruppe von seitenseitigen Ergebnissen

pageSize
pageSize integer

Seitengröße für diese Gruppe von seitenseitigen Ergebnissen

Verknüpfungen
links array of LinkDescriptionObject

Eine Sammlung von HATEOAS-Links

SearchCustomer

Name Pfad Typ Beschreibung
id
id uuid

Eindeutiger Bezeichner für diesen Kunden

Vorname
firstName string

Vorname des Kunden

lastName
lastName string

Nachname des Kunden

E-Mails
emails array of CustomerEmail

Kunden-E-Mail-Adresse(n)

phones
phones array of CustomerPhone

Telefonnummern des Kunden

address
address CustomerAddress
Rang
rank float

Relevanzbewertung dieses Kundensuchergebnisses

CustomerVehicleCollection

Name Pfad Typ Beschreibung
id
id uuid

Eindeutiger Bezeichner für dieses Fahrzeug

exteriorColor
exteriorColor string

Außenfarbe des Fahrzeugs

interiorColor
interiorColor string

Innenfarbe des Fahrzeugs

Fahrleistung
mileage integer

Kilometerstand des Fahrzeugs

milesPerWeek
milesPerWeek integer

Durchschnittlich gefahrene Meilen pro Woche

Jahr
year integer

Herstellungsjahr

machen
make string

Fahrzeugmarke

Modell
model string

Name des Fahrzeugs

trim
trim integer

Beschreibung der Kürzung

Vin
vin string

Fahrzeugidentifikationsnummer

options
options CustomerVehicleOptions

Fahrzeugoptionen

vehicleOwner
vehicleOwner CustomerVehicleOwner

Fahrzeugbesitzer

CustomerVehicleOptions

Fahrzeugoptionen

Name Pfad Typ Beschreibung
fuelType
fuelType string

Kraftstofftyp

interiorType
interiorType string

Innentyp

vehicleCondition
vehicleCondition string

Fahrzeugzustand

bodyStyle
bodyStyle string

Fahrzeugkörperstil

engineDescription
engineDescription string

Typ des Moduls

modelCode
modelCode string

Modellcode

numberOfCylinders
numberOfCylinders integer

Anzahl der Zylinder

numberOfDoors
numberOfDoors byte

Anzahl der Türen

Übertragung
transmission string

Übertragungstyp

isAutomaticTransmission
isAutomaticTransmission boolean

true/false, ob das Fahrzeug über ein Automatisches Getriebe verfügt

hasAirBags
hasAirBags boolean

wahr/falsch, ob das Fahrzeug Lufttaschen hat

hasCruiseControl
hasCruiseControl boolean

true/false, ob das Fahrzeug Kreuzfahrtschiff hat

hasAirConditioning
hasAirConditioning boolean

true/false, ob das Fahrzeug Klimaanlage hat

CustomerVehicleOwner

Fahrzeugbesitzer

Name Pfad Typ Beschreibung
isActive
isActive boolean

true/false, ob der Besitzer aktiv ist

customerId
customerId uuid

Eindeutiger Bezeichner für den Fahrzeugbesitzer

vehicleId
vehicleId uuid

Eindeutiger Bezeichner für das Fahrzeug

LinkDescriptionObject

Name Pfad Typ Beschreibung
href
href string

Der Ziel-URI

rel
rel string

Der Verknüpfungsbeziehungstyp

method
method string

Das HTTP-Verb, das zum Senden einer Anforderung an das Ziel des Links verwendet werden muss

title
title string

Der Titel, der das Objekt beschreibt