다음을 통해 공유

CDK 드라이브 고객(미리 보기)

API를 사용하면 CDK 드라이브에서 서비스 고객을 찾고, 검색하고, 필터링할 수 있습니다. CDK 드라이브 내에서 고객은 차량을 판매했거나, 차량에 대한 전망을 가지고 있거나, 부품을 구입했거나, 대리점을 통해 차량을 수리하거나 서비스를 받았으며 CRM 시스템에 존재하는 개인입니다. 또한 이 커넥터를 사용하면 기본 고객 레코드를 만들 수 있습니다. 이를 통해 서비스 어드바이저는 이러한 워크플로를 고객과 연결할 수 있도록 하여 긍정적인 환경을 제공할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 CDK Global
URL https://serviceconnect.support.cdk.com
전자 메일 mbd_support@cdk.com
커넥터 메타데이터
게시자 CDK Global
웹 사이트 https://fortellis.io
개인 정보 보호 정책 https://fortellis.io/privacy
카테고리 데이터

약

CDKDrive 고객 API V1을 사용하면 CDK 드라이브에서 고객 레코드를 검색, 보기, 만들기 및 업데이트할 수 있습니다.

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

주요 개념

고객

고객은 CDK 드라이브 DMS에서 다음 조건 중 하나 이상을 충족하는 개인입니다.

  1. 대리점에서 차량 구매(또는 차량 구매 전망)
  2. 대리점에서 구매한 부품
  3. 수리 또는 서비스를 위해 대리점에 차량을 가져왔습니다.

잠재적 사용 사례

CDKDrive 고객 API를 사용하여 다음과 같은 상황을 처리하는 솔루션을 만듭니다.

  1. 고객 검색 및 고객 세부 정보 표시
  2. 고객 정보 만들기 또는 업데이트
  3. 고객의 기본 연락처 방법 업데이트
  4. CDKDrive 서비스 차량 API를 사용하여 차량과 연결하는 고객 정보 가져오기

관련 API

CDKDrive 고객 API는 독립적으로 또는 다음 API와 함께 사용할 수 있습니다.

거래

구매하거나 임대하는 고객 및 차량에 대한 정보를 사용하여 거래를 찾아서 만듭니다. CDKDrive 고객 API를 사용하여 고객 레코드를 거래와 연결할 수 있습니다. 거래 API: 대리점 직원을 가져옵니다.

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

CDKDRIVE 복구 주문

CDK 드라이브에서 서비스 쓰기 워크플로를 사용하도록 설정합니다. CDKDrive 고객 API를 사용하여 고객 레코드를 수리 주문과 연결할 수 있습니다.

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

CDKDRIVE 서비스 차량

CDK Drive에서 서비스 도메인 차량 정보를 만들고, 업데이트하고, 쿼리하고, 검색합니다. CDKDrive 서비스 차량 API를 사용하여 고객을 차량에 연결할 수 있습니다.

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

CDKDRIVE 고객 API 시작

Pre-requisites

계속하려면 다음이 필요합니다.

• 커넥터를 사용하려면 Fortellis 사용자여야 합니다.

• API를 호출하는 동안 사용할 클라이언트 ID 및 비밀을 생성하기 위해 Fortellis에서 솔루션을 만들어야 합니다.

자세한 설명서는 다음에서 찾을 수 있습니다.

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

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

고객 만들기

고객 만들기
고객 업데이트

고객 업데이트
고객 쿼리

고객 쿼리
고객 쿼리

고객 쿼리

고객 만들기

작업 ID:
createCustomer

고객 만들기

매개 변수

Name 키 필수 형식 Description
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
요청 ID
 Request-Id string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
첫 번째
 first True string

고객의 이름입니다.
중간
 middle string

고객의 중간 이름
마지막
 last True string

고객의 성입니다.
prefix
 prefix string

고객의 접두사
접미사
 suffix string

고객의 접미사
primaryPhone
 primaryPhone string

고객의 기본 전화 번호
homePhone
 homePhone string

고객의 집 전화 번호
휴대전화
 mobilePhone string

고객의 휴대폰 번호
호출기
 pager string

고객의 호출기 번호
pagerAccessCode
 pagerAccessCode string

고객의 호출기 액세스 코드
homeFax
 homeFax string

고객의 집 팩스 번호
workFax
 workFax string

고객의 회사 팩스 번호
email1
 email1 string

고객의 이메일 주소 1입니다. 다른 전자 메일 주소가 없는 경우 해당되지 않는 경우 NA를 입력하거나 고객 거부에 대한 CD를 입력할 수 있습니다.
emailDesc1
 emailDesc1 string

전자 메일 주소 1 설명입니다. email1에 입력한 경우 NA 또는 CD가 포함됩니다.
email2
 email2 string

고객의 이메일 주소 2
emailDesc2
 emailDesc2 string

전자 메일 주소 2 설명
email3
 email3 string

고객의 이메일 주소 3
emailDesc3
 emailDesc3 string

전자 메일 주소 3 설명
email4
 email4 string

고객의 전자 메일 주소 4
emailDesc4
 emailDesc4 string

전자 메일 주소 4 설명
email5
 email5 string

고객의 이메일 주소 5
emailDesc5
 emailDesc5 string

전자 메일 주소 5 설명
email6
 email6 string

고객의 이메일 주소 6
emailDesc6
 emailDesc6 string

전자 메일 주소 6 설명
preferredMethod
 preferredMethod string

고객을 위한 기본 연락 방법
blockPhoneFlag
 blockPhoneFlag boolean

전화 전화 광고 여부를 나타냅니다.
blockEmailFlag
 blockEmailFlag boolean

전자 메일 광고를 차단할지 여부를 나타냅니다.
blockMailFlag
 blockMailFlag boolean

메일 광고를 차단할지 여부를 나타냅니다.
street
 street string

거리, 도로, 도로 등이 될 수 있습니다. 이 요소에는 집 번호와 방/아파트/평면/층 번호도 포함됩니다.
city
 city string

도시, 마을, 마을, 자치구 등이 될 수 있습니다. 이것은 우편 도시이며 반드시 거주지 또는 사업장소가 아닙니다.
군
 county string

메일 주소 지정 용도로 사용되지 않는 미국 또는 영국 카운티와 같은 관리 구역을 처리합니다. 하위 리소스는 배달 주소를 위한 것이 아닙니다.
주
 state string

주, 지방, 카운티(아일랜드), 토지(독일), 출국(프랑스) 등
postalCode
 postalCode string

우편번호. 일반적으로 국가 전체이지만 때로는 도시와 관련이 있습니다(예: '더블린 2, 아일랜드' 주소의 '2').
country
 country string

국가의 ISO 국가 코드

반환

몸
Customer

고객 업데이트

작업 ID:
updateCustomer

고객 업데이트

매개 변수

Name 키 필수 형식 Description
고객 ID
 customerId True string

고객 식별자
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
요청 ID
 Request-Id string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
eTag
 If-Match True string

리소스 업데이트 요청을 조건부로 만듭니다. If-Match 제공된 체크섬 값은 리소스의 현재 ETag 값과 일치해야 합니다.
첫 번째
 first True string

고객의 이름입니다.
중간
 middle string

고객의 중간 이름
마지막
 last True string

고객의 성입니다.
prefix
 prefix string

고객의 접두사
접미사
 suffix string

고객의 접미사
primaryPhone
 primaryPhone string

고객의 기본 전화 번호
homePhone
 homePhone string

고객의 집 전화 번호
휴대전화
 mobilePhone string

고객의 휴대폰 번호
호출기
 pager string

고객의 호출기 번호
pagerAccessCode
 pagerAccessCode string

고객의 호출기 액세스 코드
homeFax
 homeFax string

고객의 집 팩스 번호
workFax
 workFax string

고객의 회사 팩스 번호
email1
 email1 string

고객의 이메일 주소 1입니다. 다른 전자 메일 주소가 없는 경우 해당되지 않는 경우 NA를 입력하거나 고객 거부에 대한 CD를 입력할 수 있습니다.
emailDesc1
 emailDesc1 string

전자 메일 주소 1 설명입니다. email1에 입력한 경우 NA 또는 CD가 포함됩니다.
email2
 email2 string

고객의 이메일 주소 2
emailDesc2
 emailDesc2 string

전자 메일 주소 2 설명
email3
 email3 string

고객의 이메일 주소 3
emailDesc3
 emailDesc3 string

전자 메일 주소 3 설명
email4
 email4 string

고객의 전자 메일 주소 4
emailDesc4
 emailDesc4 string

전자 메일 주소 4 설명
email5
 email5 string

고객의 이메일 주소 5
emailDesc5
 emailDesc5 string

전자 메일 주소 5 설명
email6
 email6 string

고객의 이메일 주소 6
emailDesc6
 emailDesc6 string

전자 메일 주소 6 설명
preferredMethod
 preferredMethod string

고객을 위한 기본 연락 방법
blockPhoneFlag
 blockPhoneFlag boolean

전화 전화 광고 여부를 나타냅니다.
blockEmailFlag
 blockEmailFlag boolean

전자 메일 광고를 차단할지 여부를 나타냅니다.
blockMailFlag
 blockMailFlag boolean

메일 광고를 차단할지 여부를 나타냅니다.
street
 street string

거리, 도로, 도로 등이 될 수 있습니다. 이 요소에는 집 번호와 방/아파트/평면/층 번호도 포함됩니다.
city
 city string

도시, 마을, 마을, 자치구 등이 될 수 있습니다. 이것은 우편 도시이며 반드시 거주지 또는 사업장소가 아닙니다.
군
 county string

메일 주소 지정 용도로 사용되지 않는 미국 또는 영국 카운티와 같은 관리 구역을 처리합니다. 하위 리소스는 배달 주소를 위한 것이 아닙니다.
주
 state string

주, 지방, 카운티(아일랜드), 토지(독일), 출국(프랑스) 등
postalCode
 postalCode string

우편번호. 일반적으로 국가 전체이지만 때로는 도시와 관련이 있습니다(예: '더블린 2, 아일랜드' 주소의 '2').
country
 country string

국가의 ISO 국가 코드

반환

몸
Customer

고객 쿼리

작업 ID:
queryCustomerById

고객 쿼리

매개 변수

Name 키 필수 형식 Description
고객 ID
 customerId True string

고객 식별자
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
요청 ID
 Request-Id string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.

반환

몸
Customer

고객 쿼리

작업 ID:
queryCustomers

고객 쿼리

매개 변수

Name 키 필수 형식 Description
이름
 name string

이름으로 고객을 필터링합니다.
전자 메일
 email string

전자 메일 주소로 고객 필터링
Phone
 phone string

전화 번호로 고객을 필터링합니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
요청 ID
 Request-Id string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.

반환

몸
CustomerCollection

정의

고객

Name 경로 형식 Description
customerId
 customerId string

고객 레코드의 식별자입니다.
이름
 name Name
contactMethods
 contactMethods ContactMethods
우편 주소
 postalAddress PostalAddress
preferredContact
 preferredContact string

기본 연락처 방법
links
 links CustomerLinks

ContactMethods

Name 경로 형식 Description
primaryPhone
 primaryPhone string

고객의 기본 전화 번호
homePhone
 homePhone string

고객의 집 전화 번호
휴대전화
 mobilePhone string

고객의 휴대폰 번호
호출기
 pager string

고객의 호출기 번호
pagerAccessCode
 pagerAccessCode string

고객의 호출기 액세스 코드
homeFax
 homeFax string

고객의 집 팩스 번호
workFax
 workFax string

고객의 회사 팩스 번호
email1
 email1 string

고객의 이메일 주소 1입니다. 다른 전자 메일 주소가 없는 경우 해당되지 않는 경우 NA를 입력하거나 고객 거부에 대한 CD를 입력할 수 있습니다.
emailDesc1
 emailDesc1 string

전자 메일 주소 1 설명입니다. email1에 입력한 경우 NA 또는 CD가 포함됩니다.
email2
 email2 string

고객의 이메일 주소 2
emailDesc2
 emailDesc2 string

전자 메일 주소 2 설명
email3
 email3 string

고객의 이메일 주소 3
emailDesc3
 emailDesc3 string

전자 메일 주소 3 설명
email4
 email4 string

고객의 전자 메일 주소 4
emailDesc4
 emailDesc4 string

전자 메일 주소 4 설명
email5
 email5 string

고객의 이메일 주소 5
emailDesc5
 emailDesc5 string

전자 메일 주소 5 설명
email6
 email6 string

고객의 이메일 주소 6
emailDesc6
 emailDesc6 string

전자 메일 주소 6 설명
preferredMethod
 preferredMethod string

고객을 위한 기본 연락 방법
blockPhoneFlag
 blockPhoneFlag boolean

전화 전화 광고 여부를 나타냅니다.
blockEmailFlag
 blockEmailFlag boolean

전자 메일 광고를 차단할지 여부를 나타냅니다.
blockMailFlag
 blockMailFlag boolean

메일 광고를 차단할지 여부를 나타냅니다.

PostalAddress

Name 경로 형식 Description
street
 street string

거리, 도로, 도로 등이 될 수 있습니다. 이 요소에는 집 번호와 방/아파트/평면/층 번호도 포함됩니다.
city
 city string

도시, 마을, 마을, 자치구 등이 될 수 있습니다. 이것은 우편 도시이며 반드시 거주지 또는 사업장소가 아닙니다.
군
 county string

메일 주소 지정 용도로 사용되지 않는 미국 또는 영국 카운티와 같은 관리 구역을 처리합니다. 하위 리소스는 배달 주소를 위한 것이 아닙니다.
주
 state string

주, 지방, 카운티(아일랜드), 토지(독일), 출국(프랑스) 등
postalCode
 postalCode string

우편번호. 일반적으로 국가 전체이지만 때로는 도시와 관련이 있습니다(예: '더블린 2, 아일랜드' 주소의 '2').
country
 country string

국가의 ISO 국가 코드
Name 경로 형식 Description
리소스에 대한 링크의 세부 정보
 self LinkDescriptionObject

CustomerCollection

Name 경로 형식 Description
items
 items array of Customer

이름

Name 경로 형식 Description
첫 번째
 first string

고객의 이름입니다.
중간
 middle string

고객의 중간 이름
마지막
 last string

고객의 성입니다.
prefix
 prefix string

고객의 접두사
접미사
 suffix string

고객의 접미사
companyName
 companyName string

고객이 회사를 나타내는 경우 회사 이름이 고려됩니다.

LinkDescriptionObject

Name 경로 형식 Description
href
 href string

대상 URI
method
 method string

링크 대상에 대한 요청을 만드는 데 사용해야 하는 HTTP 동사입니다.
title
 title string

타이틀 속성은 링크에 대한 제목을 제공하며 최종 클라이언트의 이해를 용이하게 하는 유용한 설명서 도구입니다.