Loading
保險
InsPolicyService:createOutOfSequencePolicyVersion

您位於此處：

  1. Salesforce 說明
  2. 文件
  3. 數位保險

InsPolicyService:createOutOfSequencePolicyVersion

使用此服務來針對指定的原則起始未依序的贊同。

類別:InsPolicyService

方法:createOutOfSequencePolicyVersion

服務會為未依序的贊同建立以下交易:

  • 序列外已變更/已贊同:保單年度的保費總變更為背書結果。若多期保單受到影響,系統會為每個期限建立交易。

  • 順序不足的贊同:執行贊同時付款排程的保費調整。僅適用於目前的期限。付款排程進入日期是當過去日期與目前日期之間失序生效時的目前日期或營運日期。針對未來日期,付款排程進入日期是未依序贊同的生效日期。

    重要
    重要 必須填入所有跨詞彙之保單版本的「參照保單號碼」。

運作方式

  1. 服務會取得目前原則的 policyId、順序不足贊同的生效日期,以及由 inputKey 指定的 JSON。

  2. 如果 createTransaction 為 true,則服務會建立類型為 Out-of-Sequence Changed/Endorsed 與交易詳細資料的超序交易。

  3. 如果 includePaymentSchedule 為 true,則服務會產生或更新付款排程和付款排程項目詳細資料。系統會根據針對對應的 paymentCalculationMethod 和 paymentFrequency 選項選取的值執行計算。付款排程遵循現有的付款排程規則:

    • 只會更新未來日期的未支付付款排程。

    • 過去的付款排程不會更新,無論已付款或未付款。

    • 過時付款與已付款付款排程的任何調整都會包含在「順序不足」贊同交易中。

  4. 服務會將 IsPolicyEditLocked 欄位的值更新為相關保單版本上的 true。所有原則版本都會鎖定,直到順序不足的贊同交易完成為止。

備註
備註

此外,此服務支援原始原則版本的持續期間少於 365 天,或低於 366 天的超序贊同。請參閱保單的 考量事項與限制。

支援自訂欄位

  • 將「保單」物件的自訂欄位儲存在 OutOfSequenceEndorsementCustomFields 欄位集中。

  • 在 additionalFields 區段中將自訂欄位填入為金鑰/值配對。請參閱 輸入 JSON。

  • 使用此 OutOfSequenceEndorsementCustomFields 欄位集,在超出序列的贊同期間,將自訂資料從取消的原則版本複製到新原則版本。

遠端選項

選項

描述
policyId

必要。

服務根據新或更新的資訊更新之現有原則的識別碼。
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 僅支援年度保單條款。

輸入 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

以下是服務起始順序不足贊同並成功產生工作識別碼時的範例輸出 JSON:

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

以下是服務傳回錯誤時的範例輸出 JSON:

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
正在載入
Salesforce Help | Article