詳細情報:
InsPolicyService:createOutOfSequencePolicyVersion
このサービスを使用して、特定のポリシーの順序どおりでない支持を開始します。
クラス: InsPolicyService
方法: createOutOfSequencePolicyVersion
サービスでは、順序が不規則な支持に対して次のトランザクションが作成されます。
-
Out-of-Sequence Changed/Endorsed (変更/支持順序外): 支持の結果として保険契約の年の保険料が変更された合計。複数期間の保険契約が影響を受ける場合、期間ごとにトランザクションが作成されます。
-
Out-of-Sequence Endorsement (順序外の裏書): 裏書が実行されたときの支払スケジュールの保険料調整。現在の期間のみを対象とします。支払スケジュール入力日は、現在の日付または業務日 (過去の日付と現在の日付の間で順序が異なっている場合) です。将来の日付の場合、支払スケジュールの入力日は順序が不規則な支持の発効日になります。
重要 参照保険契約番号は、期間全体のすべての保険契約バージョンで入力する必要があります。
操作手順
-
サービスは、現在のポリシー、順序が不規則な支持の発効日、および
inputKeyによって指定された JSON をpolicyIdします。 -
[
createTransaction] が [true] の場合、サービスはOut-of-Sequence Changed/Endorsed種別の順序どおりでないトランザクションとトランザクションの詳細を作成します。 -
[
includePaymentSchedule] が [true] の場合、サービスは支払スケジュールと支払スケジュールエントリの詳細を生成または更新します。計算は、対応するpaymentCalculationMethodおよびpaymentFrequencyオプションで選択された値に基づいて実行されます。支払スケジュールは、既存の支払スケジュールルールに従います。-
将来の日付の未払い支払スケジュールのみが更新されます。
-
過去の支払スケジュール (支払済みまたは未払い) は更新されません。
-
過去の支払および支払済み支払スケジュールの調整は、順序外承認トランザクションに含まれます。
-
-
このサービスは、関連する保険契約バージョンで [
IsPolicyEditLocked] 項目の値を [true] に更新します。順序の誤った支持トランザクションが完了するまで、すべてのポリシーバージョンがロックされます。
このサービスでは、元の保険契約バージョンの期間が 365 日未満 (うるう年の日数が 366 日未満) の場合、順序どおりでない承認もサポートされます。「保険契約の考慮事項と制限」を参照してください。
カスタム項目のサポート
-
Insurance Policy オブジェクトのカスタムフィールドを OutOfSequenceEndorsementCustomFields フィールドセットに保存します。
-
カスタムフィールドにキー/値のペアとして [
additionalFields] セクションに入力します。「入力 JSON」を参照してください。 -
この OutOfSequenceEndorsementCustomFields 項目セットを使用して、順序が不規則な支持中にキャンセルされたポリシーバージョンから新しいポリシーバージョンにカスタムデータをコピーします。
リモートオプション
オプション |
説明 |
|---|---|
policyId
|
必須。 新規または更新された情報に基づいてサービスが更新する既存のポリシーの ID。 |
createContactForParticipants
|
省略可能。 |
createInsuredItemsRelationships
|
省略可能。
このオプションが [ このオプションでは、親 > 子および親 > 子 > 孫の被保険者項目リレーションがサポートされます。 |
createTransaction
|
省略可能。
デフォルトは
|
effectiveDate
|
必須。
順序の誤った支持の変更が適用される開始日。 |
includePaymentSchedule
|
省略可能。 ポリシーの支払スケジュールが作成または更新された場合に デフォルトは |
inputKey
|
必須。
ポリシーを作成または更新するために必要な入力が含まれる JSON。次のいずれかの値を指定できます。
|
paymentCalculationMethod
|
includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料計算方法の値を上書きします。 |
paymentFrequency
|
includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料頻度の値を上書きします。 |
paymentType
|
includePaymentSchedule が true の場合は必須です。このオプションは、保険契約の保険料支払種別の値を上書きします。 |
postDataCustomClassName
|
省略可能。 サービスが新しいポリシーバージョンを保存するために使用するカスタムクラスの名前。 このオプションまたは デフォルト値は PostInsurancePolicy です。 |
postDataDRBundleName
|
省略可能。 サービスが新しいポリシーバージョンを保存するために使用する OmniStudio データマッパーの名前。 このオプションまたは
|
transactionType
|
省略可能。
|
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"
}