Loading
システム管理者に対するフィッシング耐性MFA・全従業員ユーザーMFAの適用のお知らせ 続きを読む
Insurance
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

このサービスを使用して、既存のポリシーから更新ポリシーを作成します。

クラス: InsPolicyService

方法: createRenewalPolicy

しくみ

  1. サービスは、更新するポリシーのpolicyIdを受け入れます。

    メモ
    メモ

    このサービスは、価格を再計算するための追加の評価係数を決定するuserInputsを渡します 。また、このサービスではadditionalFieldsノードを使用して、ポリシーオブジェクトの追加項目を入力します。追加項目がない場合は、このサービスに含まれません。

  2. サービスは、更新された保険契約の発効日と有効期限を確認します。提供されていない場合、サービスは次のロジックを使用してこれらの日付を計算します。

    • 発効日 = 元の保険契約の有効期限 + 1 日

    • 有効期限 = 新しい保険契約の発効日 + 新しい保険契約の期間

  3.  aggByKey オプションと includeInputKey オプションを使用してポリシー商品の価格を再設定します。

  4. サービスはincludePaymentScheduleとincludeRevenueScheduleを使用して、更新済みポリシーで支払スケジュールと収益スケジュールを作成する必要があるかどうかを判断します。オプションが指定されていない場合、同じ設定が前のポリシーから継承されます。

  5. サービスはポリシーを作成し、更新済みポリシーとしてマークします。

メモ
メモ

このサービスでは、元の保険契約バージョンの期間が 365 日未満 (うるう年の期間が 366 日未満) の保険契約の更新もサポートされます。ただし、更新時の保険契約の期間は 365 日、うるう年の場合は 366 日です。「保険契約の考慮事項と制限」を参照してください。

入力:

入力

説明

policyId

必須

更新する保険契約の ID。

userInputs

省略可能

ポリシーに関連付けられた商品の詳細。すべての製品で、 userInputs オブジェクトのターゲット形式は、製品ビューの [API] タブのサービスリストから取得されます。オブジェクトキーの形式は ProductCode.AttributeCode ProductCode  です。ここで、 ProductCode  は商品のコード、関連付けられた補償範囲仕様、保険品目仕様、または評価結果です。

userInputs が指定されていない場合、更新サービスは既存のポリシーの情報を取得して、更新されたポリシーに再現します。

additionalFields

省略可能

このサービスに含まれていない追加項目のキーと値のペア。次の項目がポリシーオブジェクトに入力されます。

リモートオプション

メモ
メモ InsProductService:repriceProduct で使用されるすべてのリモートオプションもこのサービスで使用できます。

リモートオプション

説明

renewalExpirationDate

省略可能

更新された保険契約の有効期限。指定しない場合、次のロジックを使用して値が設定されます。

新しい契約の発効日 + 新しい契約の期間

renewalEffectiveDate

省略可能

更新された保険契約の発効日。指定しない場合、値は次のロジックを使用して計算されます。

既存の保険契約の有効期限 + 1 日

Insurance Industries Extension パッケージを使用している場合、[renewalEffectiveDate] オプションのタイムスタンプ値は無視されます。代わりに、発効日のタイムスタンプ値は選択した発効日の午前 12 時に設定され、有効期限の値は選択した失効日の午後 11 時 59 分に設定されます。タイムスタンプは、ユーザーの指定されたタイムゾーンを使用して設定されます。

aggByKey

必須

PRODUCT.instanceKey

サービスはこのオプションを計算手順への入力として送信し、それを使用して集計で計算を完了します。

たとえば、自動車保険契約には、各被保険者車両に複数の運転者が添付されています。被保険者の車両には、保険契約のインスタンスごとに個別の instanceKey があります。aggByKey は、車両のすべてのインスタンスキーを取得し、instanceKey ごとに補償保険料の配列を作成します。この配列は保険料が正しく計算されるように計算手順に渡されます。

サービスはこの値を使用してポリシーの価格を再設定します。

calculateTaxesAndFees

省略可能。

デフォルト値は true です。

税金と手数料を計算するには、true に設定します。

createTransaction

省略可能。

True または False

デフォルトは False です。

true の場合、収益スケジュールサービスで使用されるトランザクションが作成されます。

includeInputKeys

必須

サービスが計算手順に渡す、または計算手順から渡すキーと値のペアのカンマ区切り文字列。

これらのキーと値のペアは、 CalculatedPriceData オブジェクト内の出力商品オブジェクトに含まれます。これは、計算結果を解析するのに役立ちます。

結果に値が含まれるのは、計算手順で使用されるキーのみです。

サービスは includeInputKeys  を使用してポリシーの価格を再設定します。

includePaymentSchedule

省略可能

true の場合、更新された保険契約に基づいて支払スケジュールが作成されます。値が指定されていない場合、元の保険契約に更新された保険契約がある場合のみ、その保険契約に基づいて支払スケジュールが作成されます。

includeRevenueSchedule

省略可能

true の場合、更新されたポリシーに基づいて収益スケジュールが作成されます。値が指定されていない場合は、元の保険契約に更新済み保険契約がある場合のみ、更新済み保険契約に基づいて支払スケジュールが作成されます。

paymentCalculationMethod

値 includePaymentSchedule が true の場合は必須です。

ポリシーの Premium Calculation Method 値を上書きします。

paymentFrequency

値 includePaymentScheduleが true の場合は必須です。

ポリシーの PremiumFrequency 値を上書きします。

paymentType

値 includePaymentScheduleが true の場合は必須です。

ポリシーの Premium Payment Type 値を上書きします。

ratingDate

更新された保険契約の価格設定の評価手順を決定します。提供されていない場合、更新された保険契約の発効日に基づいて価格設定が行われます。

メモ
メモ データ型が日付であるため、 ratingField に特定の時間を渡すことはできません。そのため、評価のタイムスタンプはデフォルトで午前 12 時になります。

term

省略可能

保険契約の期間。リモートオプションで提供されていない場合renewalExpirationDateは、計算に役立ちます。InsPolicyService:createRenewalPolicy では、年間契約条件のみがサポートされます。

useLocalTimezone

True または False

デフォルト値は true です。

この値を true に設定すると、ポリシーが作成されたローカルタイムゾーンが使用されます。

この値が false に設定されている場合、サービスはタイムゾーンとして GMT を使用します。

Input JSON

入力 JSON の例を次に示します。

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

出力 JSON

出力 JSON の例を次に示します。

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
読み込み中
Salesforce Help | Article