Loading
メールアドレスがデフォルトのログイン方式となります 続きを読む
Insurance
InsPolicyService:createOutOfSequencePolicyVersion

InsPolicyService:createOutOfSequencePolicyVersion

このサービスを使用して、特定のポリシーの順序どおりでない支持を開始します。

クラス: InsPolicyService

方法: createOutOfSequencePolicyVersion

サービスでは、順序が不規則な支持に対して次のトランザクションが作成されます。

  • Out-of-Sequence Changed/Endorsed (変更/支持順序外): 支持の結果として保険契約の年の保険料が変更された合計。複数期間の保険契約が影響を受ける場合、期間ごとにトランザクションが作成されます。

  • Out-of-Sequence Endorsement (順序外の裏書): 裏書が実行されたときの支払スケジュールの保険料調整。現在の期間のみを対象とします。支払スケジュール入力日は、現在の日付または業務日 (過去の日付と現在の日付の間で順序が異なっている場合) です。将来の日付の場合、支払スケジュールの入力日は順序が不規則な支持の発効日になります。

    重要
    重要 参照保険契約番号は、期間全体のすべての保険契約バージョンで入力する必要があります。

操作手順

  1. サービスは、現在のポリシー、順序が不規則な支持の発効日、およびinputKeyによって指定された JSON をpolicyIdします。

  2. [createTransaction] が [true] の場合、サービスは Out-of-Sequence Changed/Endorsed 種別の順序どおりでないトランザクションとトランザクションの詳細を作成します。

  3. [includePaymentSchedule] が [true] の場合、サービスは支払スケジュールと支払スケジュールエントリの詳細を生成または更新します。計算は、対応するpaymentCalculationMethodおよびpaymentFrequencyオプションで選択された値に基づいて実行されます。支払スケジュールは、既存の支払スケジュールルールに従います。

    • 将来の日付の未払い支払スケジュールのみが更新されます。

    • 過去の支払スケジュール (支払済みまたは未払い) は更新されません。

    • 過去の支払および支払済み支払スケジュールの調整は、順序外承認トランザクションに含まれます。

  4. このサービスは、関連する保険契約バージョンで [IsPolicyEditLocked] 項目の値を [true] に更新します。順序の誤った支持トランザクションが完了するまで、すべてのポリシーバージョンがロックされます。

メモ
メモ

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

カスタム項目のサポート

  • Insurance Policy オブジェクトのカスタムフィールドを OutOfSequenceEndorsementCustomFields フィールドセットに保存します。

  • カスタムフィールドにキー/値のペアとして [additionalFields] セクションに入力します。「入力 JSON」を参照してください。

  • この OutOfSequenceEndorsementCustomFields 項目セットを使用して、順序が不規則な支持中にキャンセルされたポリシーバージョンから新しいポリシーバージョンにカスタムデータをコピーします。

リモートオプション

オプション

説明

policyId

必須。

新規または更新された情報に基づいてサービスが更新する既存のポリシーの ID。

createContactForParticipants

省略可能。

true または false

デフォルトは true です。

falseの場合、サービスは取引先責任者レコードを作成しません。

createInsuredItemsRelationships

省略可能。

true または false

このオプションが [true] の場合、[instanceKey] > [保険項目間のparentInstanceKeyリレーション] のリストを指定します。

このオプションでは、親 > 子および親 > 子 > 孫の被保険者項目リレーションがサポートされます。

createTransaction

省略可能。

true または false

デフォルトは false です。

true の場合、サービスはトランザクションを作成します。

effectiveDate

必須。

"YYYY-MM-DD HH:MM:SS" または %OmniScriptDataElement%

順序の誤った支持の変更が適用される開始日。

includePaymentSchedule

省略可能。

ポリシーの支払スケジュールが作成または更新された場合にtrueします。

デフォルトは false です。

inputKey

必須。

%theJSONyouneed%

ポリシーを作成または更新するために必要な入力が含まれる JSON。次のいずれかの値を指定できます。

  • postDataCustomClassName

  • postDataDRBundleName

    次のいずれかのオプションを指定しない場合、値はデフォルトで postDataCustomClassName になります。
paymentCalculationMethod includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料計算方法の値を上書きします。
paymentFrequency includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料頻度の値を上書きします。
paymentType includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料支払種別の値を上書きします。
postDataCustomClassName

省略可能。

サービスが新しいポリシーバージョンを保存するために使用するカスタムクラスの名前。

このオプションまたはpostDataDRBundleNameを指定する必要があります。

デフォルト値は PostInsurancePolicy です。

postDataDRBundleName

省略可能。

サービスが新しいポリシーバージョンを保存するために使用する OmniStudio データマッパーの名前。

このオプションまたはpostDataCustomClassNameを指定する必要があります。

  • どちらも指定しない場合、サービスはpostDataCustomClassNameのデフォルト値を使用します。

transactionType

省略可能。

transactionType に値が指定されていない場合は、デフォルトで Out-of-Sequence Changed/Endorsed になります。

term

サービスが作成するポリシーの期間。

InsPolicyService:createOutOfSequencePolicyVersion では、年間保険契約期間のみがサポートされます。

Input JSON

サービスは、商品 JSON 内に指定されたinputKeyを検索します。入力 JSON の例を次に示します。

"newPolicyJSON": {
  "accountId": "001f400000RrQSrAAN",
  "term": "Annual",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "vlocity_ins__Type__c": "AUTO",
  },
}

オプション JSON のサンプルを次に示します。

{
   
    "effectiveDate": "2023-03-01",
    "inputKey": "quotepolicyJson",
    "policyId": "0YT3t000000uUz6GAE",
    "includePaymentSchedule": true,
    "createTransaction": true,
    "paymentFrequency": "Monthly",
    "paymentCalculationMethod": "Modal"
  }

出力 JSON

サービスが順序どおりでない支持を開始し、ジョブ ID が正常に生成された場合の出力 JSON の例を次に示します。

 {
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
 "error": "OK"
}

サービスでエラーが返された場合の出力 JSON の例を次に示します。

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
読み込み中
Salesforce Help | Article