Cliente de unidad CDK (versión preliminar)
La API le permitirá buscar, recuperar y filtrar clientes del servicio en la unidad CDK. Dentro de CDK Drive, un cliente es un individuo que ha sido vendido un vehículo, es un prospecto en un vehículo, ha comprado piezas, o ha tenido su vehículo reparado o servicio a través del concesionario y existe en un sistema CRM. Además, este conector le permitirá crear un registro de cliente básico. Esto ayuda a los asesores de servicio a proporcionar una experiencia positiva al permitir que esos flujos de trabajo estén vinculados a un cliente.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | CDK Global |
| URL | https://serviceconnect.support.cdk.com |
| Correo Electrónico | mbd_support@cdk.com |
| Metadatos del conector | |
|---|---|
| Publicador | CDK Global |
| Sitio web | https://fortellis.io |
| Directiva de privacidad | https://fortellis.io/privacy |
| Categorías | Data |
ACERCA DE
La API de cliente de CDKDrive V1 permite buscar, ver, crear y actualizar registros de cliente en la unidad CDK.
https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9
Conceptos clave
Clientela
Un cliente es un individuo de la unidad CDK DMS que cumple al menos uno de los criterios siguientes:
- Adquirido un vehículo (o es un prospecto para comprar un vehículo) del concesionario
- Piezas compradas del concesionario
- Llevar un vehículo al concesionario para reparaciones o servicio
Casos de uso potenciales
Use la API de cliente de CDKDrive para crear soluciones para controlar situaciones como:
- Buscar un cliente y mostrar los detalles del cliente
- Creación o actualización de la información del cliente
- Actualizar los métodos de contacto preferidos de un cliente
- Obtención de información del cliente para vincular con vehículos con la API de vehículos de servicio CDKDrive
API relacionadas
La API del cliente de CDKDrive se puede usar de forma independiente o con cualquiera de las siguientes API.
OFERTAS
Busque y cree una oferta con información sobre el cliente y el vehículo que están comprando o alquilando. La API del cliente de CDKDrive se puede usar para asociar registros de clientes con ofertas. API de ofertas: obtener empleados de concesionarios.
PEDIDOS DE REPARACIÓN DE CDKDRIVE
Habilite los flujos de trabajo de escritura de servicio en la unidad CDK. La API de cliente de CDKDrive se puede usar para asociar registros de clientes con pedidos de reparación.
https://apidocs.fortellis.io/specs/b0f20c99-ed1f-49de-a0e8-6776d2ee0fe3
VEHÍCULOS DE SERVICIO CDKDRIVE
Cree, actualice, consulte y recupere la información del vehículo del dominio de servicio en la unidad CDK. Puede vincular clientes a vehículos mediante la API de vehículos de servicio CDKDrive.
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
INTRODUCCIÓN A LA API DEL CLIENTE DE CDKDRIVE
Requisitos previos
Necesitará lo siguiente para continuar.
• Para usar el conector, debe ser un usuario de Fortellis.
• Debe crear una solución en Fortellis para generar el identificador de cliente y el secreto que se usarán al llamar a las API.
Puede encontrar documentación detallada en
https://apidocs.fortellis.io/specs/0d488dd1-c609-4618-9061-68be8b61c2a9
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización de un cliente |
Actualización de un cliente |
| Consulta de un cliente |
Consulta de un cliente |
| Consultar clientes |
Consultar clientes |
| Crear un cliente |
Crear un cliente |
Actualización de un cliente
Actualización de un cliente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cliente
|
customerId | True | string |
Identificador del cliente |
|
Id. de suscripción
|
subscription_id | True | string |
Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud especificada. |
|
Identificador de cliente
|
client_id | True | string |
Identificador de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Secreto del cliente
|
client_secret | True | string |
Secreto de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Id. de solicitud
|
Request-Id | string |
Formato: guid. Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud dada. |
|
|
eTag
|
If-Match | True | string |
Hace que la solicitud de actualización de recursos sea condicional. El valor de suma de comprobación presentado con If-Match debe coincidir con el valor ETag actual del recurso. |
|
Primero
|
first | True | string |
Nombre del cliente |
|
medio
|
middle | string |
Nombre intermedio del cliente |
|
|
último
|
last | True | string |
Apellidos del cliente |
|
prefix
|
prefix | string |
Prefijo del cliente |
|
|
sufijo
|
suffix | string |
Sufijo del cliente |
|
|
primaryPhone
|
primaryPhone | string |
Número de teléfono principal del cliente |
|
|
homePhone
|
homePhone | string |
Número de teléfono particular del cliente |
|
|
mobilePhone
|
mobilePhone | string |
Número de teléfono móvil del cliente |
|
|
buscapersonas
|
pager | string |
Número de buscapersonas del cliente |
|
|
pagerAccessCode
|
pagerAccessCode | string |
El código de acceso del buscapersonas del cliente |
|
|
homeFax
|
homeFax | string |
Número de fax principal del cliente |
|
|
workFax
|
workFax | string |
Número de fax del trabajo del cliente |
|
|
email1
|
email1 | string |
Dirección de correo electrónico 1 del cliente. Puede escribir NA para no aplicable o CD para El cliente rechazado si no hay ninguna otra dirección de correo electrónico presente. |
|
|
emailDesc1
|
emailDesc1 | string |
Dirección de correo electrónico 1 descripción. Contendrá NA o CD si se escribe en email1. |
|
|
email2
|
email2 | string |
Dirección de correo electrónico 2 del cliente |
|
|
emailDesc2
|
emailDesc2 | string |
Descripción de la dirección de correo electrónico 2 |
|
|
email3
|
email3 | string |
Dirección de correo electrónico 3 del cliente |
|
|
emailDesc3
|
emailDesc3 | string |
Descripción de la dirección de correo electrónico 3 |
|
|
email4
|
email4 | string |
Dirección de correo electrónico 4 del cliente |
|
|
emailDesc4
|
emailDesc4 | string |
Descripción de la dirección de correo electrónico 4 |
|
|
email5
|
email5 | string |
Dirección de correo electrónico 5 del cliente |
|
|
emailDesc5
|
emailDesc5 | string |
Descripción de la dirección de correo electrónico 5 |
|
|
email6
|
email6 | string |
Dirección de correo electrónico 6 del cliente |
|
|
emailDesc6
|
emailDesc6 | string |
Descripción de la dirección de correo electrónico 6 |
|
|
preferredMethod
|
preferredMethod | string |
Método preferido de contacto para el cliente |
|
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Indica si se va a anunciar por teléfono o no |
|
|
blockEmailFlag
|
blockEmailFlag | boolean |
Indica si se va a bloquear o no la publicidad por correo electrónico. |
|
|
blockMailFlag
|
blockMailFlag | boolean |
Indica si se va a bloquear o no la publicidad de correo |
|
|
street
|
street | string |
Puede ser calle, avenida, carretera, etc. Este elemento también incluye el número de casa y el número de habitación/apartamento/piso/piso. |
|
|
city
|
city | string |
Puede ser ciudad, pueblo, ciudad, municipio, etc. Esta es la ciudad postal y no necesariamente el lugar de residencia o lugar de negocios. |
|
|
condado
|
county | string |
Controla distritos administrativos como condados de EE. UU. o Reino Unido que no se usan con fines de direccionamiento de correo electrónico. La subdivisión no está pensada para direcciones de entrega. |
|
|
estado
|
state | string |
Un estado, provincia, condado (en Irlanda), Tierra (en Alemania), salida (en Francia), etc. |
|
|
postalCode
|
postalCode | string |
Código postal. Normalmente en todo el país, pero a veces específico de la ciudad (por ejemplo, "2" en direcciones de Dublín 2, Irlanda). |
|
|
country
|
country | string |
Código de país ISO del país |
Devoluciones
- Body
- Customer
Consulta de un cliente
Consulta de un cliente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cliente
|
customerId | True | string |
Identificador del cliente |
|
Id. de suscripción
|
subscription_id | True | string |
Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud especificada. |
|
Identificador de cliente
|
client_id | True | string |
Identificador de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Secreto del cliente
|
client_secret | True | string |
Secreto de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Id. de solicitud
|
Request-Id | string |
Formato: guid. Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud dada. |
Devoluciones
- Body
- Customer
Consultar clientes
Consultar clientes
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | string |
Filtra los clientes por nombre |
|
|
Correo Electrónico
|
string |
Filtra a los clientes por dirección de correo electrónico |
||
|
Teléfono
|
phone | string |
Filtra los clientes por número de teléfono |
|
|
Id. de suscripción
|
subscription_id | True | string |
Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud especificada. |
|
Identificador de cliente
|
client_id | True | string |
Identificador de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Secreto del cliente
|
client_secret | True | string |
Secreto de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Id. de solicitud
|
Request-Id | string |
Formato: guid. Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud dada. |
Devoluciones
- Body
- CustomerCollection
Crear un cliente
Crear un cliente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de cliente
|
client_id | True | string |
Identificador de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Secreto del cliente
|
client_secret | True | string |
Secreto de cliente que debe ser único para el desarrollador o proveedor de soluciones que compila la solución. |
|
Id. de suscripción
|
subscription_id | True | string |
Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud especificada. |
|
Id. de solicitud
|
Request-Id | string |
Formato: guid. Identificador de correlación que se debe devolver al autor de la llamada para indicar el retorno de la solicitud dada. |
|
|
Primero
|
first | True | string |
Nombre del cliente |
|
medio
|
middle | string |
Nombre intermedio del cliente |
|
|
último
|
last | True | string |
Apellidos del cliente |
|
prefix
|
prefix | string |
Prefijo del cliente |
|
|
sufijo
|
suffix | string |
Sufijo del cliente |
|
|
primaryPhone
|
primaryPhone | string |
Número de teléfono principal del cliente |
|
|
homePhone
|
homePhone | string |
Número de teléfono particular del cliente |
|
|
mobilePhone
|
mobilePhone | string |
Número de teléfono móvil del cliente |
|
|
buscapersonas
|
pager | string |
Número de buscapersonas del cliente |
|
|
pagerAccessCode
|
pagerAccessCode | string |
El código de acceso del buscapersonas del cliente |
|
|
homeFax
|
homeFax | string |
Número de fax principal del cliente |
|
|
workFax
|
workFax | string |
Número de fax del trabajo del cliente |
|
|
email1
|
email1 | string |
Dirección de correo electrónico 1 del cliente. Puede escribir NA para no aplicable o CD para El cliente rechazado si no hay ninguna otra dirección de correo electrónico presente. |
|
|
emailDesc1
|
emailDesc1 | string |
Dirección de correo electrónico 1 descripción. Contendrá NA o CD si se escribe en email1. |
|
|
email2
|
email2 | string |
Dirección de correo electrónico 2 del cliente |
|
|
emailDesc2
|
emailDesc2 | string |
Descripción de la dirección de correo electrónico 2 |
|
|
email3
|
email3 | string |
Dirección de correo electrónico 3 del cliente |
|
|
emailDesc3
|
emailDesc3 | string |
Descripción de la dirección de correo electrónico 3 |
|
|
email4
|
email4 | string |
Dirección de correo electrónico 4 del cliente |
|
|
emailDesc4
|
emailDesc4 | string |
Descripción de la dirección de correo electrónico 4 |
|
|
email5
|
email5 | string |
Dirección de correo electrónico 5 del cliente |
|
|
emailDesc5
|
emailDesc5 | string |
Descripción de la dirección de correo electrónico 5 |
|
|
email6
|
email6 | string |
Dirección de correo electrónico 6 del cliente |
|
|
emailDesc6
|
emailDesc6 | string |
Descripción de la dirección de correo electrónico 6 |
|
|
preferredMethod
|
preferredMethod | string |
Método preferido de contacto para el cliente |
|
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Indica si se va a anunciar por teléfono o no |
|
|
blockEmailFlag
|
blockEmailFlag | boolean |
Indica si se va a bloquear o no la publicidad por correo electrónico. |
|
|
blockMailFlag
|
blockMailFlag | boolean |
Indica si se va a bloquear o no la publicidad de correo |
|
|
street
|
street | string |
Puede ser calle, avenida, carretera, etc. Este elemento también incluye el número de casa y el número de habitación/apartamento/piso/piso. |
|
|
city
|
city | string |
Puede ser ciudad, pueblo, ciudad, municipio, etc. Esta es la ciudad postal y no necesariamente el lugar de residencia o lugar de negocios. |
|
|
condado
|
county | string |
Controla distritos administrativos como condados de EE. UU. o Reino Unido que no se usan con fines de direccionamiento de correo electrónico. La subdivisión no está pensada para direcciones de entrega. |
|
|
estado
|
state | string |
Un estado, provincia, condado (en Irlanda), Tierra (en Alemania), salida (en Francia), etc. |
|
|
postalCode
|
postalCode | string |
Código postal. Normalmente en todo el país, pero a veces específico de la ciudad (por ejemplo, "2" en direcciones de Dublín 2, Irlanda). |
|
|
country
|
country | string |
Código de país ISO del país |
Devoluciones
- Body
- Customer
Definiciones
Cliente
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
customerId
|
customerId | string |
Identificador del registro de cliente |
|
nombre
|
name | Name | |
|
contactMethods
|
contactMethods | ContactMethods | |
|
postalAddress
|
postalAddress | PostalAddress | |
|
preferredContact
|
preferredContact | string |
Método de contacto preferido |
|
Enlaces
|
links | CustomerLinks |
ContactMethods
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
primaryPhone
|
primaryPhone | string |
Número de teléfono principal del cliente |
|
homePhone
|
homePhone | string |
Número de teléfono particular del cliente |
|
mobilePhone
|
mobilePhone | string |
Número de teléfono móvil del cliente |
|
buscapersonas
|
pager | string |
Número de buscapersonas del cliente |
|
pagerAccessCode
|
pagerAccessCode | string |
El código de acceso del buscapersonas del cliente |
|
homeFax
|
homeFax | string |
Número de fax principal del cliente |
|
workFax
|
workFax | string |
Número de fax del trabajo del cliente |
|
email1
|
email1 | string |
Dirección de correo electrónico 1 del cliente. Puede escribir NA para no aplicable o CD para El cliente rechazado si no hay ninguna otra dirección de correo electrónico presente. |
|
emailDesc1
|
emailDesc1 | string |
Dirección de correo electrónico 1 descripción. Contendrá NA o CD si se escribe en email1. |
|
email2
|
email2 | string |
Dirección de correo electrónico 2 del cliente |
|
emailDesc2
|
emailDesc2 | string |
Descripción de la dirección de correo electrónico 2 |
|
email3
|
email3 | string |
Dirección de correo electrónico 3 del cliente |
|
emailDesc3
|
emailDesc3 | string |
Descripción de la dirección de correo electrónico 3 |
|
email4
|
email4 | string |
Dirección de correo electrónico 4 del cliente |
|
emailDesc4
|
emailDesc4 | string |
Descripción de la dirección de correo electrónico 4 |
|
email5
|
email5 | string |
Dirección de correo electrónico 5 del cliente |
|
emailDesc5
|
emailDesc5 | string |
Descripción de la dirección de correo electrónico 5 |
|
email6
|
email6 | string |
Dirección de correo electrónico 6 del cliente |
|
emailDesc6
|
emailDesc6 | string |
Descripción de la dirección de correo electrónico 6 |
|
preferredMethod
|
preferredMethod | string |
Método preferido de contacto para el cliente |
|
blockPhoneFlag
|
blockPhoneFlag | boolean |
Indica si se va a anunciar por teléfono o no |
|
blockEmailFlag
|
blockEmailFlag | boolean |
Indica si se va a bloquear o no la publicidad por correo electrónico. |
|
blockMailFlag
|
blockMailFlag | boolean |
Indica si se va a bloquear o no la publicidad de correo |
PostalAddress
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
street
|
street | string |
Puede ser calle, avenida, carretera, etc. Este elemento también incluye el número de casa y el número de habitación/apartamento/piso/piso. |
|
city
|
city | string |
Puede ser ciudad, pueblo, ciudad, municipio, etc. Esta es la ciudad postal y no necesariamente el lugar de residencia o lugar de negocios. |
|
condado
|
county | string |
Controla distritos administrativos como condados de EE. UU. o Reino Unido que no se usan con fines de direccionamiento de correo electrónico. La subdivisión no está pensada para direcciones de entrega. |
|
estado
|
state | string |
Un estado, provincia, condado (en Irlanda), Tierra (en Alemania), salida (en Francia), etc. |
|
postalCode
|
postalCode | string |
Código postal. Normalmente en todo el país, pero a veces específico de la ciudad (por ejemplo, "2" en direcciones de Dublín 2, Irlanda). |
|
country
|
country | string |
Código de país ISO del país |
CustomerLinks
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Detalles de un vínculo a un recurso
|
self | LinkDescriptionObject |
CustomerCollection
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of Customer |
Nombre
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Primero
|
first | string |
Nombre del cliente |
|
medio
|
middle | string |
Nombre intermedio del cliente |
|
último
|
last | string |
Apellidos del cliente |
|
prefix
|
prefix | string |
Prefijo del cliente |
|
sufijo
|
suffix | string |
Sufijo del cliente |
|
companyName
|
companyName | string |
Si el cliente representa una empresa, se considerará el nombre de la compañía. |
LinkDescriptionObject
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
href
|
href | string |
URI de destino |
|
method
|
method | string |
Verbo HTTP que debe usarse para realizar una solicitud al destino del vínculo. |
|
title
|
title | string |
La propiedad title proporciona un título para el vínculo y es una herramienta de documentación útil para facilitar la comprensión por parte de los clientes finales. |