ライフサイクルでのサービス要求の移行
サービス要求のライフサイクルの概要
次の図は、サービス要求のライフサイクルと、サービス要求を各ステージに移行するために使用されるエンドポイントを示しています。
コンポジット要求の制限事項
見積のみ、見積とサービス、およびサービスのみのサービス要求では、コンポジット要求でサービス要求を作成および送信できます。ただし、サービス要求をそのライフサイクルの別のステージ（進行中、却下済み、キャンセル済みなど）に移行することはできません。
管理されていないサービス要求では、1 つのコンポジット要求でサービス要求を作成、送信、請求、承認することができます。それと同じコンポジット要求で、サービス要求請求書を支払済みとしてマークすることもできます。
ServiceRequestOperationContext リソース
サービス要求をライフサイクルの次のステージに移行するエンドポイントは、ServiceRequestOperationContext リソースを使用します。このリソースには、ClaimCenter の ServiceRequest エンティティにマップされるフィールドが含まれています。ほとんどの場合、サービス要求のライフサイクルのエンドポイントの使用時には、指定が必須の 1 つのフィールド（reason フィールドなど）があり、これは、サービス要求を却下またはキャンセルするときに指定する必要があります。必須フィールドは以降のセクションで指定します。
保険会社が ClaimCenter でサービス要求ワークフローの動作を拡張した場合、保険会社は ServiceRequestOperationContext リソースも拡張して、必要に応じてシステム API から値が入力されるようにする必要があります。拡張されたベースコンフィギュレーションリソースの詳細については、スキーマコンフィギュレーションの概要を参照してください。
サービス要求の送信、受理、および却下
サービス要求の送信
見積のみのサービス要求、見積とサービスのサービス要求、またはサービスのみのサービス要求は、業者に送信する必要があります。（管理されていないサービス要求は、指定された業者に自動的に送信されるようにマークされます。）
サービス要求が業者に送信されたことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/submit
サービス要求を送信するときに、追加の必須情報はありません。応答には本文がなくてもかまいません。
以下は、サービス要求 cc:9 を送信します。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/submit
<no request body>ドラフトサービス要求が送信されると、その［進行中］フィールドが［要求済み］に設定されます。
サービス要求の受理
見積のみのサービス要求、見積とサービスのサービス要求、またはサービスのみのサービス要求が業者に送信されたら、業者はそれを受理することができます。これは、業者がサービス要求の引き受けに同意したことを意味します。（管理されていないサービス要求は、指定された業者によって自動的に受理されます。）
業者がサービス要求を受理したことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/accept
送信されたサービス要求を受理する場合、expectedCompletionDate を指定する必要があります。
以下は、サービス要求 cc:9 を受理します。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/accept
{
"data": {
"attributes": {
"expectedCompletionDate" : "2021-03-22"
}
}
}要求されたサービス要求が受理されると、その［進行中］フィールドが［進行中］に設定されます。
サービス要求の却下
見積のみのサービス要求、見積とサービスのサービス要求、またはサービスのみのサービス要求が業者に送信されたら、業者はそれを却下できます。これは、業者がサービス要求を引き受けるつもりがないことを意味します。
業者がサービス要求を却下したことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/decline
送信されたサービス要求を却下する場合、その理由を指定する必要があります。
以下は、サービス要求 cc:9 を却下します。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/decline
{
"data": {
"attributes": {
"reason" : "All mechanics are booked through the end of the month."
}
}
}要求されたサービス要求が却下されると、その［進行中］フィールドが［却下済み］に設定されます。
サービス要求の完了とキャンセル
サービス要求の完了
サービス要求が業者に受理されたら、その作業が完了したことを指定できます。
サービス要求の作業が完了したことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/complete-work
サービス要求の作業が完了したことを示すときに、追加の必須情報はありません。応答は本文なしにできます。
次の例は、サービス要求 cc:9 の作業が完了したことを示しています。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/work-complete
<no request body>「進行中」のサービス要求が完了すると、その［進行中］フィールドが［作業完了］に設定されます。
（業者の要求での）サービス要求のキャンセル
サービス要求が受理された後でも、業者によるキャンセルが可能です。
サービス要求の作業が業者の要求でキャンセルされたことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/cancel
受理したサービス要求をキャンセルする場合は、その理由を指定する必要があります。
次の例は、サービス要求 cc:9 を業者の要求でキャンセルしています。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/cancel
{
"data": {
"attributes": {
"reason" : "Vendor realized they cannot service this type of auto."
}
}
}「進行中」のサービス要求が業者によってキャンセルされると、その［進行中］フィールドが［却下済み］に設定されます。これは、サービス要求が最初に受理されずに却下された場合の設定状態と同じです。
（保険会社の要求での）サービス要求のキャンセル
サービス要求が受理された後でも、保険会社によるキャンセルが可能です。
サービス要求の作業が保険会社の要求でキャンセルされたことを示すには、以下を使用します。
- POST
/claims/{claimId}/service-requests/{serviceRequestId}/internal-cancel
受理したサービス要求をキャンセルする場合は、その理由を指定する必要があります。
次の例は、サービス要求 cc:9 を保険会社の要求でキャンセルしています。
POST /claim/v1/claims/demo_sample:20/service-requests/cc:9/internal-cancel
{
"data": {
"attributes": {
"reason" : "Claimant has decided not to request service."
}
}
}「進行中」のサービス要求が保険会社によってキャンセルされると、その［進行中］フィールドが［キャンセル済み］に設定されます。