您位於此處:
InsEnrollmentServiceStd:enrollNewHires
在契約期限的中間,將新普查成員註冊至其所選的計畫。
類別:InsEnrollmentServiceStd
方法:enrollNewHires
實例
| groupCensusID | contractID | groupCensusMemberIds | primaryRoleName | dependentRoleName |
|---|---|---|---|---|
| groupCensusID1 | ctrlD1 | censusMemberPrimary1 | PolicyHolder | |
| censusMemberDependent1 | 成員 | |||
| censusMemberDependent2 | 成員 |
| policyID | 涵蓋範圍 | PolicyParticipant | policyParticipant.role |
|---|---|---|---|
| policyID101 | coverage1, coverage2 | censusMemberPrimary1 | self |
| censusMemberDependent1 | 配偶 | ||
| censusMemberDependent2 | 子系 |
運作方式
- 服務搜尋「群組普查成員」:
- 指定
groupCensusId的所有成員,或 - 僅限在
groupCensusMemberIds清單中指定的成員。
- 指定
- 群組普查的每個主要
groupCensusMemberIds都應對應PolicyStartDate欄位。PolicyStartDate應在「契約開始日期」與「契約結束日期」之間。- 如果任何主要
groupCensusMemberIds未填入PolicyStartDate,則服務會引發錯誤,其中包含groupCensusMemberIds清單與訊息:「指定PolicyStartDate的有效日期。」 - 如果任何主要
groupCensusMemberIds的PolicyStartDate不在「契約開始日期」與「契約結束日期」之間,則服務會引發錯誤,其中包含groupCensusMemberIds清單和訊息:「指定在 ContractStartDate 和 ContractEndDate 內的PolicyStartDate」。
- 如果任何主要
- 在服務驗證所有主要普查成員後,其會搜尋與在
GroupCensusMemberPlan中每個成員連結的預先註冊計畫的PolicyStartDate資訊。 - 會退回每個成員的計畫產品。
- 如果產品符合資格 (是
Contract和ContractGroupPlans的一部分),則會建立「保單」。 - 「保單涵蓋範圍」(
InsurancePolicyCoverages) 是針對計畫中指定的涵蓋範圍項目所建立。 - 您可以為群組普查中的群組普查成員建立個人帳戶。為了支援「個人帳戶」流程,此服務會透過群組普查成員執行以下動作:
- 如果有可用的
AccountIds(從GroupCensusMember取得),則服務會使用AccountId作為InsurancePolicy.NameInsured,並建立InsurancePolicyParticipants' PrimaryParticipantAccountId和RelatedParticipantAccountId。 - 如果
AccountId為空值,則服務會使用groupAccountId作為InsurancePolicy.NameInsured,並使用contactId作為InsurancePolicyParticipants' PrimaryParticipantContactId與RelatedParticipantContactId。
- 如果有可用的
- 「保單」僅會針對主要成員建立,而非其下屬。「保單」中的從屬詳細資料會儲存為:
- 從屬資訊會在名為「
InsurancePolicyParticipants」的個別物件中建立。也會為主要成員建立記錄。服務會將這些記錄與「保單」建立關聯。 - 「保單參與者」(
InsurancePolicyParticipant) 的primaryParticipantAccountId和relatedParticipantAccountId欄位也會使用群組普查成員的AccountId欄位和當AccountId為空值時的「連絡人」欄位來填入。
- 從屬資訊會在名為「
- 「保單」的生效日期將與主要成員的
PolicyStartDate生效日期相同。 - 「保費」會根據成員在契約期限內註冊的天數進行按比例分配。例如:等級為 :16.00 的總保費。契約期間:365 天 (開始日期:2023 年 1 月 10 日到結束日期:2024 年 1 月 9 日)成員的保單開始日期:2022 年 2 月 28 日契約中新進成員的總天數:316比例保費:16* (316/365) = 13.85
- 保單涵蓋範圍:
- 如果家庭成員在成員註冊期間註冊選用涵蓋範圍,則個別的
InsurancePolicyCoverage記錄會對應至每個已註冊的選用涵蓋範圍。每個對應至選用涵蓋範圍的InsurancePolicyCoverage記錄都會將註冊的「保單參與者」儲存在InsurancePolicyCoverage物件的vlocity_ins_fsc__InsurancePolicyParticipantId__c欄位中。 - 針對每個產品的家庭強制涵蓋範圍,有一個單一
InsurancePolicyCoverage記錄。
- 如果家庭成員在成員註冊期間註冊選用涵蓋範圍,則個別的
- 保單保費:如果
saveMemberPremium設定為true,則InsurancePolicyParticipant記錄會包含該原則的StandardPremiumAmount值。此金額按比例分配 (且計算方式與步驟 10 中的「保費」相同)。備註 設定運算式集或計算程序,將成員層級保費金額設定為「包含在計算中」輸出選項設為「memberPremium」欄位。
設定等級程序,將生效日期作為選項傳遞至運算式集或計算程序。
- 運算式集或計算程序遠端選項的索引鍵:
effectiveDate - 運算式集或計算程序遠端選項的值:
%options:effectiveDate% - 其功能:此整合程序會將此值作為選項傳遞至
InsProductService:getRatedProduct服務。此資料用於提取運算式集或計算程序的正確版本,以及整合程序用於分級的矩陣。
遠端選項
| 選項 | 描述 |
|---|---|
contractId
|
必要。 成員所屬契約的識別碼,以及成員註冊在 |
dependentRoleName
|
選擇性。 預設值為
|
groupCensusId
|
如果未使用 包含所有普查成員以進行註冊的普查識別碼。 |
groupCensusMemberIds
|
如果未使用 要註冊的特定普查成員識別碼清單,以逗號分隔。 |
isBatchMode
|
選擇性。 預設值為 以非同步方式建立原則。 |
primaryRoleName
|
選擇性。 預設值為 |
saveMemberPremium
|
選擇性。 預設值為 此值表示要為所有 如果值為 |
輸入 JSON
以下是範例輸入 JSON:
{
"Input": {
"groupCensusId": "0rfRO00000005OUYAY",
"contractId": "800RO000000WG4mYAG"
},
"Options":{
"isBatchMode":false
}
}輸出 JSON
以下是範例輸出 JSON:
{
"policyIds":[
"0036F00002Q4wlSQAR",
"0036F00002Q4wlSQAQ"
]
}