アクティブなクレームとアーカイブ済みクレームの検索

フリーテキスト検索の要求ペイロード

POST /claim/v1/search/claims-freetext 呼び出しの要求オブジェクトには本文を含める必要があります。この本文では、フリーテキスト検索を使用する検索パラメータを指定する必要があります。フィールド name は、フリーテキスト検索インデックスから結果を返します。次に例を示します。

{
  "data": {
    "attributes": {
      "address": {
        "addressLine1": "1313 Monroe Lane",
        "city": "Pomona",
        "country": "US",
        "state": {
          "code": "CA",
        }
      },
      "name": "Ray Newton",
      "nameSearchType": {
        "code": "any",
      },
      "phoneNumber": "555 413 4545"
    }
  }
}

フリーテキスト検索の使用方法については、『ClaimCenter アプリケーションガイド』を参照してください。

アーカイブ済みクレームの検索

アーカイブ済みクレームを検索するには、フィールド archivedSearch を追加し、このフィールドを true に設定します。archivedSearch フィールドを含まない（または archivedSearch が false に設定された）要求ペイロードでは、アクティブなクレームのみを自動検索します。

{
    "status": 400,
    "errorCode": "com.guidewire.pl.modules.rest.framework.v1.exceptions.OperationNotCurrentlyAllowedException",
    "userMessage": "The operation is not currently allowed for this resource"
}

名前と納税者番号による検索

ペイロードに firstName、lastName、companyName、taxID のいずれかが含まれる場合、デフォルトの動作では、その名、姓、会社名、納税者番号を持つ保険金請求者が存在するクレームを検索します。

nameSearchType パラメータを使用して、個人の検索もできます。検索対象となる個人は、被保険者とその他の被保険者のいずれかである個人や、クレームに対して役割を持つ個人です。これを行うには、ClaimSearchNameSearchType コードに対して以下のいずれかのコードを指定します。

• addinsured（その他の被保険者）
• any（クレームに対する何らかの役割。その他の被保険者、保険金請求者、被保険者以外の役割を含む）
• claimant（デフォルトの動作）
• insured

例えば、次のペイロードでは被保険者の名が「Ray」で姓が「Newton」であるすべてのクレームを検索します。nameSearchType は ClaimSearchNameSearchType コードのフィールドを使用します。

POST /claim/v1/search/claims-v2 

{
  "data": {
    "attributes": {
      "firstName": "Ray",
      "lastName": "Newton",
      "nameSearchType": {
        "code": "insured"
      }
    }
  }
}

次のペイロードでは、被保険者の会社名が Wright Construction であるすべてのアーカイブ済みクレームを検索します。

{
  "data": {
    "attributes": {
      "archivedSearch": true,
      "companyName": "Wright Construction",
    }
  }
}

空のクレーム検索の応答ペイロード

システム API では検索パラメータを指定する必要はありませんが、検索パラメータが存在しないと ClaimCenter はクレーム検索を実行しません。検索パラメータを指定せずにクレーム検索を実行しようとすると、ユーザーインターフェイスまたはシステム API 経由で ClaimCenter が次のエラーメッセージを返します。

Please specify Claim #, Policy #, any Contact field, Assigned To Group, Assigned To User, Created By, Cat #, VIN or License Plate

このメッセージは主に、ユーザーインターフェイスのクレーム検索向けです。/claim/v1/search/claims-v2 エンドポイントでは使用できないフィールド（Assigned To Group、Assigned To User、Created By など）に言及しているのはこのためです。

アクティブなクレームの検索結果

次の例では、Bill Kinman さんに関連付けられたすべてのクレームを保険契約者が検索しています。

• adjusterName：クレームの担当者ユーザーを示す
• assignedGroup：クレームにアサインされたグループを示す
• claimID
• claimNumber
• claimants のリスト
• flagged フィールド：担当者がクレームに一意のフラグステートメントを提示したかどうかを示す
• futurePayments：送信される支払スケジュール
• insuredName
• クレームの LossDate
• 総額の paid
• クレームの policyNumber
• クレームに残っている remainingReserves
• クレームの status：未了かクローズ済みかを示す

{
    "count": 1,
    "data": [
        {
            "attributes": {
                "adjusterName": "Andy Applegate",
                "assignedGroup": "Auto1 - TeamA",
                "claimId": "cc:SO",
                "claimNumber": "235-53-425891",
                "claimants": [
                    "Bill Kinman"
                ],
                "flagged": true,
                "futurePayments": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "insuredName": "Bill Kinman",
                "lossDate": "2021-02-28T00:00:00.000Z",
                "paid": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "policyNumber": "4775949863-02",
                "remainingReserves": {
                    "amount": "0.00",
                    "currency": "usd"
                },
                "status": {
                    "code": "open",
                    "name": "Open"
                }
            }
        },

アーカイブ済みクレームの検索結果

アーカイブ済みクレームの検索結果はアクティブなクレームの検索結果と類似していますが、アーカイブ関連のフィールドも含まれます。アーカイブ関連のフィールドには以下が含まれます。

• クレームの archiveState：クレームがアーカイブ済みなのか、アクティブなクレームの状態に戻っているのかを示す
• クレームが archived であったのかどうか（常に true）
• archivedAdjuster：アーカイブを実行した担当者を示す
• claimInfoID：claimInfo オブジェクトの識別番号を示しており、これを使用してアーカイブ済みクレームを取得できる