Service Appointment Update Input
制限事項
リソースを使用して、次のものを変更することはできません。
- 親レコード ID (parentRecordId) とサービス予定 ID (serviceAppointmentId)
- キャンセル済みの予定。
- 過去の日付の予定。
- lead の詳細。
- マルチリソーススケジュールが有効になっている場合、1 回の要求で新しいリソースを追加し、さらにそれをプライマリリソースにすることはできません。1 回の要求で新しいリソースを追加してから、別の要求を実行してそのリソースをプライマリリソースとして追加します。
- JSON の例
-
1{ 2 "serviceAppointmentId": "08pxx0000004C92AAE", 3 "serviceAppointment": { 4 "workTypeId": "08pxx0000004C92AAE", 5 "serviceTerritoryId": "0Hh2xx0000004CAeCAM", 6 "schedStartTime": "2020-09-15T16:00:00+0000", 7 "schedEndTime": "2020-09-22T16:45:00+0000", 8 "street": "1 Market Street", 9 "city": "San Francisco", 10 "state": "CA", 11 "postalCode": "94105", 12 "country": "USA", 13 "appointmentType": "In Person", 14 "extendedFields": [ 15 { 16 "name": "Email", 17 "value": "rachel.adams@salesforce.com" 18 }, 19 { 20 "name": "Phone", 21 "value": "111111111" 22 }, 23 { 24 "name": "Description", 25 "value": "Test Description" 26 } 27 ], 28 "assignedResources": [ 29 { 30 "serviceResourceId": "0Hnxx0000004CAeCAM", 31 "isRequiredResource": true, 32 "isPrimaryResource": false, 33 "extendedFields": [] 34 }, 35 ] 36} - スケジュール済み時刻を更新する要求の例
-
1{ 2 "serviceAppointmentId": "08pxx0000004C92AAE", 3 "serviceAppointment": { 4 "schedStartTime": "2020-09-15T16:00:00+0000", 5 "schedEndTime": "2020-09-22T16:45:00+0000", 6} - 作業種別を更新する要求の例
-
1{ 2 "serviceAppointmentId": "08pxx0000004C92AAE", 3 "serviceAppointment": { 4 "workTypeId": "08qxx0000004C92AAE", 5} - サービステリトリーを更新する要求の例
-
1{ 2 "serviceAppointmentId": "08pxx0000004C92AAE", 3 "serviceAppointment": { 4 "serviceTerritoryId": "0Hhxx0000004CAeCAM" 5} - プロパティ
-
名前 型 説明 必須か省略可能 使用可能なバージョン assignedResources Assigned Resource Input[] サービス予定に割り当てられたサービスリソース。 予定を更新するときには、必要なリソースの完全なリストを渡します。
サービス予定に割り当てられたリソースを渡さないと、その割り当て済みリソースは API によって削除されます。たとえば、既存のサービス予定に割り当て済みリソース A と B があり、割り当て済みリソース B と C を渡したとします。その場合、API によって既存の作業種別とサービステリトリーに対してリソース B と C の作業可能性がチェックされ、両方が作業可能である場合には、次のようにサービス予定が更新されます。- リソース A — 削除される
- リソース B — 更新される
- リソース C — 作成される
ただし、割り当て済みリソースをまったく渡さなかった場合には、変更がないと見なされます。
省略可能 51.0 schedulingPolicyId String AppointmentSchedulingPolicy オブジェクトの ID。リクエストボディでスケジュールポリシーが渡されない場合、デフォルトの設定が使用されます。時���枠の決定時に使用される唯一のスケジュールポリシー設定は、取引先訪問時間の適用です。 省略可能 51.0 serviceAppointment Service Appointment Input[] 顧客のサービス作業を完了するための予定。 予定を更新するときには、更新する必要がある項目のみを渡します。
必須 51.0 serviceAppointmentId String 更新するサービス予定の ID。 必須 51.0