CDK Drive Service Vehicles (プレビュー)
CDK Drive Service Vehicles は、車両に関する ID、タイプ、ステータス、および顧客情報を関連付けます。 AP Iを使用すると、CDK でサービス ドメイン車両情報を作成、更新、クエリ、および取得できます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | CDK Global |
| [URL] | https://serviceconnect.support.cdk.com |
| メール | mbd_support@cdk.com |
| Connector Metadata | |
|---|---|
| 発行者 | CDK Global |
| Web サイト | https://fortellis.io |
| プライバシー ポリシー | https://fortellis.io/privacy |
| カテゴリ | データ |
CDK Drive - Service - Vehicles は、車両に関する ID、タイプ、ステータス、および顧客情報を関連付けます。
この API の機能 AP Iを使用すると、CDK Drive でサービス ドメイン車両情報を作成、更新、クエリ、および取得できます。
対象車両は、サービス予定およびサービス修理注文ワークフローの依存関係です。
前提条件
続行するには、次のものが必要です
• コネクタを使用するには、Fortellis ユーザーである必要があります。
• API の呼び出し中に使用されるクライアント ID とシークレットを生成するには、Fortellis でソリューションを作成する必要があります
潜在的なユース ケース
CDKDrive Service Vehicles API を使用して、次のような状況を処理するソリューションを作成します。
- サービス車両情報を作成または更新する
- 顧客をサービス車両にリンクする
- ID またはフィルター基準で既存のサービス車両を検索する
詳細なドキュメントは次のサイトで確認できます
https://apidocs.fortellis.io/specs/54b70ee1-ac17-4be2-9314-45c947692c5d
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| 識別子で車両を照会する |
識別子で車両を照会する |
| 車両を作成する |
車両を作成する |
| 車両を更新する |
車両を更新する |
| 車両を照会する |
車両を照会する |
識別子で車両を照会する
識別子で車両を照会する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
車両 ID
|
vehicleId | True | string |
車両の識別子 |
|
サブスクリプション ID
|
subscription_id | True | string |
指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID。 |
|
クライアント ID
|
client_id | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント ID。 |
|
クライアント シークレット
|
client_secret | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント シークレット。 |
|
要求 ID
|
Request-Id | string |
形式 - GUID。 指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID |
戻り値
- 本文
- Vehicle
車両を作成する
車両を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クライアント ID
|
client_id | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント ID。 |
|
クライアント シークレット
|
client_secret | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント シークレット。 |
|
サブスクリプション ID
|
subscription_id | True | string |
指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID。 |
|
要求 ID
|
Request-Id | True | string |
形式 - GUID。 指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID |
|
VIN
|
vin | string |
車両の ID 番号 |
|
|
licensePlateNum
|
licensePlateNum | string |
車両のライセンス プレート番号 |
|
|
makeCode
|
makeCode | True | string |
車両メーカー コード |
|
メーカー
|
make | string |
車両メーカー名 |
|
|
modelCode
|
modelCode | True | string |
車両モデル コード |
|
モデル
|
model | string |
車両モデル名 |
|
|
modelYear
|
modelYear | True | number |
車両の製造年 |
|
exteriorColor
|
exteriorColor | string |
車両外装色 |
|
|
値
|
value | True | number |
測定値 |
|
単位
|
units | True | string |
測定の単位 |
|
状態
|
status | True | string |
車両の状態は新品、中古、または認定済みですか？ |
|
配送済み
|
delivered | True | date |
RFC 3339、セクション 5.6 で定義されている、現在の所有者への車両の納期 (例：2017-07-21) |
|
inService
|
inService | True | date |
RFC 3339、セクション 5.6 で定義されている、元の所有者への小売販売日 (例：2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339、セクション 5.6 で定義されている車両の保証有効期限 (例：2017-07-21) |
|
|
ownerHref
|
ownerHref | string |
所有者の顧客リソースへのハイパーリンク |
|
|
primaryDriverHref
|
primaryDriverHref | string |
主ドライバーの顧客リソースへのハイパーリンク |
戻り値
- 本文
- Vehicle
車両を更新する
車両を更新する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
車両 ID
|
vehicleId | 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 値と一致する必要があります。 |
|
VIN
|
vin | string |
車両の ID 番号 |
|
|
licensePlateNum
|
licensePlateNum | string |
車両のライセンス プレート番号 |
|
|
makeCode
|
makeCode | True | string |
車両メーカー コード |
|
メーカー
|
make | string |
車両メーカー名 |
|
|
modelCode
|
modelCode | True | string |
車両モデル コード |
|
モデル
|
model | string |
車両モデル名 |
|
|
modelYear
|
modelYear | True | number |
車両の製造年 |
|
exteriorColor
|
exteriorColor | string |
車両外装色 |
|
|
値
|
value | True | number |
測定値 |
|
単位
|
units | True | string |
測定の単位 |
|
状態
|
status | True | string |
車両の状態は新品、中古、または認定済みですか？ |
|
配送済み
|
delivered | True | date |
RFC 3339、セクション 5.6 で定義されている、現在の所有者への車両の納期 (例：2017-07-21) |
|
inService
|
inService | True | date |
RFC 3339、セクション 5.6 で定義されている、元の所有者への小売販売日 (例：2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339、セクション 5.6 で定義されている車両の保証有効期限 (例：2017-07-21) |
|
|
ownerHref
|
ownerHref | string |
所有者の顧客リソースへのハイパーリンク |
|
|
primaryDriverHref
|
primaryDriverHref | string |
主ドライバーの顧客リソースへのハイパーリンク |
戻り値
- 本文
- Vehicle
車両を照会する
車両を照会する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
VIN
|
vin | string |
VIN で車両をフィルタリングする |
|
|
ライセンス プレート番号
|
licensePlateNum | string |
ライセンス プレート番号で車両をフィルタリングする |
|
|
顧客 ID
|
customerId | string |
customerId で車両をフィルタリングする |
|
|
サブスクリプション ID
|
subscription_id | True | string |
指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID。 |
|
クライアント ID
|
client_id | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント ID。 |
|
クライアント シークレット
|
client_secret | True | string |
ソリューションを構築する開発者/ソリューション プロバイダーに対して一意である必要があるクライアント シークレット。 |
|
要求 ID
|
Request-Id | string |
形式 - GUID。 指定した要求の戻りを示すために呼び出し元に返す必要がある関連付け ID |
戻り値
- 本文
- VehicleCollection
定義
車両
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
vehicleId
|
vehicleId | string |
車両レコードの識別子 |
|
識別子
|
identification | VehicleIdentification |
車両の識別子。 エンティティを有効にするには、少なくとも 1 つの識別プロパティを定義する必要があります。 |
|
仕様
|
specification | VehicleSpecification | |
|
exteriorColor
|
exteriorColor | string |
車両外装色 |
|
旅費
|
mileage | Measurement | |
|
状態
|
status | string |
車両の状態は新品、中古、または認定済みですか？ |
|
管理する
|
dates | Dates | |
|
ownerHref
|
ownerHref | string |
所有者の顧客リソースへのハイパーリンク |
|
primaryDriverHref
|
primaryDriverHref | string |
主ドライバーの顧客リソースへのハイパーリンク |
|
リンク
|
links | VehicleLinks |
VehicleIdentification
車両の識別子。 エンティティを有効にするには、少なくとも 1 つの識別プロパティを定義する必要があります。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
VIN
|
vin | string |
車両の ID 番号 |
|
licensePlateNum
|
licensePlateNum | string |
車両のライセンス プレート番号 |
VehicleLinks
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
リソースへのリンクの詳細
|
self | LinkDescriptionObject |
VehicleCollection
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
項目
|
items | array of Vehicle |
VehicleSpecification
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
makeCode
|
makeCode | string |
車両メーカー コード |
|
メーカー
|
make | string |
車両メーカー名 |
|
modelCode
|
modelCode | string |
車両モデル コード |
|
モデル
|
model | string |
車両モデル名 |
|
modelYear
|
modelYear | number |
車両の製造年 |
測定
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | number |
測定値 |
|
単位
|
units | string |
測定の単位 |
日付
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
配送済み
|
delivered | date |
RFC 3339、セクション 5.6 で定義されている、現在の所有者への車両の納期 (例：2017-07-21) |
|
inService
|
inService | date |
RFC 3339、セクション 5.6 で定義されている、元の所有者への小売販売日 (例：2017-07-21) |
|
warrantyExpiration
|
warrantyExpiration | date |
RFC 3339、セクション 5.6 で定義されている車両の保証有効期限 (例：2017-07-21) |
LinkDescriptionObject
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
href
|
href | string |
ターゲット URI |
|
メソッド
|
method | string |
リンクのターゲットに要求を作成するために使用する必要がある HTTP 動詞 |
|
タイトル
|
title | string |
タイトル プロパティは、リンクのタイトルを提供し、エンド クライアントによる理解を容易にするための便利なドキュメント ツール |