サービス要求の作成

サービス要求を作成するには、以下のエンドポイントを使用します。

POST /claims/{claimId}/service-requests

サービス要求が作成されると、その［進行中］フィールドが［ドラフト］に設定されます。

最小作成条件

少なくとも、サービス要求は以下を指定する必要があります。

「サービスのみ」や「管理されていない」などのサービス要求の種類（kind フィールド）
業者（specialist フィールド）
サービス指図（instruction フィールド）。少なくとも以下を含める必要があります。
- 顧客（customer フィールド）
- サービスが実行される場所（serviceAddress フィールド）
- 実行される一連のサービス（services 配列）
要求された見積完了日。サービス要求が「見積のみ」または「見積とサービス」の場合。
要求されたサービスクローズ日。サービス要求が「サービスのみ」の場合。

各必須フィールドのその他の詳細

サービス要求ではサービス要求の種類を指定する必要があります。これは kind フィールドで指定され、ServiceRequestKind タイプリストにある以下のようなタイプコードを設定する必要があります。

quoteonly
quoteandservice
serviceonly
unmanaged

サービス要求では業者を指定する必要があります。これは specialist フィールドで指定されます。

既存のクレーム連絡先を指定する場合には、id フィールドをリストして、ここにクレーム連絡先 ID を設定します。
新しいクレーム連絡先を作成する場合には、refid フィールドをリストして、included セクションで新しいクレーム連絡先を指定します。

サービス要求にはサービス指図を含める必要があります。これは instruction フィールドで指定されます。少なくとも、サービス指図には顧客、サービスが実行される場所、一連のサービスを含める必要があります。

顧客は customer フィールドで指定されます。これは既存のクレーム連絡先または新しいクレーム連絡先への参照となる必要があります。クレーム連絡先は以下を使用して指定できます。

id（ClaimCenter にすでに存在する場合）
policySystemId（保険契約管理システムに存在する場合）
refid（まだ存在しておらず、POST の included セクションで作成する場合）

サービスが実行される場所は serviceAddress フィールドで指定されます。住所は以下を使用して指定できます。

id（ClaimCenter にすでに存在する場合）
インライン（ClaimCenter にまだ存在していない場合）

実行される一連のサービスは services 配列で指定されます。この配列内の各エントリは、サービスのコードを指定します。これらのコードは vendorservicetree.xml ファイルにあるもので、ここには Studio からアクセスできます。各サービスはサービスツリーのリーフレベルのサービスである必要があります。また、各サービスにはサービス要求の種類との互換性も必要です。サービスの互換性は vendorservicedetails.xml ファイルで定義されます。ここにも Studio からアクセスできます。

サービス要求の種類が quoteonly または quoteandservice の場合は、requestedQuoteCompletionDate で要求された見積完了日を指定する必要もあります。

サービス要求の種類が serviceonly の場合は、requestedServiceCompletionDate で要求されたサービスクローズ日を指定する必要もあります。

「サービスのみ」のサービス要求の例

次のペイロードは、サンプルデータのクレーム 235-53-365889（ID は cc:33）に対する最小限の「サービスのみ」のサービス要求の例を示しています。このサービス要求は、Robert Farley さん（クレーム連絡先 cc:13）向けに、1313 Mockingbird Lane in Arcadia, California にある Joe's Auto Body Shop（クレーム連絡先 cc:16）によって実行されます。実行されるサービスは 1 つで、スクラップ（autoothersalvage）です。このサービスは 2021 年 3 月 3 日までに完了するように要求されています。

POST http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:20/service-requests

{
  "data": {
    "attributes": {	
       "kind": {
           "code": "serviceonly"
       },
       "specialist": {
           "id": "cc:16"
       },
       "instruction": {
         "customer": {
           "id": "cc:13"
         },
         "serviceAddress": {
                        "addressLine1": "1313 Mockingbird Lane",
                        "city": "Arcadia",
                        "country": "US",
                        "postalCode": "91006",
                        "state": {
                            "code": "CA",
                            "name": "California"
                          }
         },
         "services": [
           {
             "code": "autoothersalvage"
           }
         ]					
      },
      "requestedServiceCompletionDate": "2021-03-19"
    }
  }
}

「管理されていない」サービス要求の例

次のペイロードは、サンプルデータのクレーム 235-53-365889（ID は cc:33）に対する最小限の「管理されていない」サービス要求の例を示しています。このサービス要求は、Robert Farley さん（クレーム連絡先 cc:13）向けに、1313 Mockingbird Lane in Arcadia, California にある Joe's Auto Body Shop（クレーム連絡先 cc:16）によって実行されます。実行されるサービスは 1 つで、レッカーサービス（autoothertowing）です。

POST http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:20/service-requests

{
  "data": {
    "attributes": {	
       "kind": {
           "code": "unmanaged"
       },
       "specialist": {
           "id": "cc:16"
       },
       "instruction": {
         "customer": {
           "id": "cc:13"
         },
         "serviceAddress": {
                        "addressLine1": "1313 Mockingbird Lane",
                        "city": "Arcadia",
                        "country": "US",
                        "postalCode": "91006",
                        "state": {
                            "code": "CA",
                            "name": "California"
                          }
         },
         "services": [
           {
             "code": "autoothertowing"
           }
         ]					
      }
    }
  }
}