您位於此處:
InsEnrollmentService:getRatedProducts
使用服務傳回指定登記者及其下屬的符合資格產品清單。計畫的比率類型為 Composite 時,會顯示每個產品的比率帶價格。
運作方式
-
此服務會取得登入系統的登記者或
contactID和登記者的userId日期,以及今天的日期。contractId -
服務會取得登記者和相依 (若適用) 資訊。它也會尋找對今天日期有效的契約,亦即今天在註冊開始日期與註冊結束日期之內。
-
根據登記者資訊和契約,服務會取得登記者和相依人可註冊的所有產品清單。
-
服務會使用篩選選項來進一步篩選可用產品的清單。
-
服務會計算每個產品的比率。評分流程以計畫層級評分類型設定或在產品層級設定的整合程序為基礎。
-
如果等級類型設定為
Composite,即比率帶。資訊用於剖析契約條列層級中PricingLogData__c的資料。 -
如果等級類型設定為
Age,則會從與產品連結的計算程序計算價格。此服務支援InsProductService.getRatedProducts中支援的所有遠端選項。若要深入瞭解,請參閱 InsProductService:getRatedProducts。
-
遠端選項
選項 |
描述 |
|---|---|
|
預設為今天日期。 服務會提取在 |
|
使用 API 名稱加上冒號加上值或變數。例如,在 OmniScript 中,變數可以是元素的名稱,例如輸入選項清單。 使用逗號分隔多個篩選參數。 篩選條件可包含 |
|
預設為 在輸出 JSON 中,這會連同產品陣列一起新增 |
|
只有計算程序使用的輸入索引鍵在結果中具有值。 |
|
預設為 在 |
|
預設為 使用相同的評分程序,依產品將評分程序呼叫分組,以最佳化評分呼叫。它會使用輸入物件陣列進行一個等級呼叫。 當提取大量產品清單時,這相當有用。多個等級呼叫可以達到 SQL 限制。評分程序結構已最佳化,以處理輸入物件陣列,並將所需的 SQL 查詢數目最小化。 不支援包含彙總步驟的計算程序。 |
|
“ProductClassName1,ProductClassName2” 產品類別名稱的逗號分隔清單。將產品清單限制為以下產品類別。 |
|
作為等級 IP 中的開關使用。 |
輸入 JSON
如果使用 censusId 作為輸入,則服務會取得下列輸入 JSON (顯示範例識別碼):
{"userId": "xxxx",
"contactId": "xxxx",
"contractId": "xxx"}服務會從普查成員物件 (特別是從 member.AttributeSelectedValue__c 欄位) 提取 userInputs。這些屬性必須符合產品的預期輸入。
或者,您可以以下列方式定義自己的 userInputs:
"additionalInputs":
{
"stage": "Quote"
},
{"userId": "xxxx",
"contactId": "xxxx",
"contractId": "xxx",
"userInputs":
[
{"vBirthdate": "1969-09-20",
"FamilyTier": "Employee Only"}
]
} 輸出 JSON
服務使用 產品 JSON 結構模型傳回評分產品陣列。這包括子系產品下所包含的任何子系涵蓋範圍規格 (若有的話)。其中也包含每個產品所有比率帶的價格資料。
在此範例中,登記者的已契約選項會傳回三個產品及其比率帶等級價格 (請參閱 RateBandTierPriceData 節點)。此處的等級類型設定為 Composite。
{
"totalSize":3,
"records":[
{
"displaySequence":-1,
"CalculatedPriceData":{
"Family":900.5,
"Self + Child":555.5,
"Self + Spouse":590,
"Self":245
},
"Id":"01tf4000002ApR0AAK",
"Name":"Bronze PPO 5000 (HSA)",
"Family":"Commercial",
"ProductCode":"SG-PPO-5000-HSA",
"LineOfBusiness__c":"Group Health",
"MarketSegment__c":"Small Group",
"Type__c":"Medical",
"SubType__c":"HDHP",
"IsRecommended__c":false,
"Tier__c":"Bronze",
"ImageId__c":"01tf4000002ApR0AAK",
"PricingSource__c":"GrandTotal",
"RecordTypeName__c":"Product",
"IsConfigurable__c":false,
"productId":"01tf4000002ApR0AAK",
"Price":"",
"ImageId":"/sfc/servlet.shepherd/version/renditionDownload?rendition=ORIGINAL_Png&versionId=068f4000002yjYiAAI",
"planId":"a0sf4000001u0CmAAI",
"planRateType":"Composite",
"RateBandTierPriceData":{
"Self":{
"Price":245,
"Sequence":"1",
"Label":"Employee"
},
"Self + Spouse":{
"Price":590,
"Sequence":"2",
"Label":"Employee + Spouse"
},
"Self + Child":{
"Price":555.5,
"Sequence":"3",
"Label":"Employee + Child"
},
"Family":{
"Price":900.5,
"Sequence":"5",
"Label":"Family"
}
},
"childProducts":{
...
},
"attributeCategories":{
...
} {
"displaySequence":-1,
"CalculatedPriceData":{
"Family":1100.5,
"Self + Child":755.5,
"Self + Spouse":790,
"Self":445
},
"Id":"01tf4000002ApR8AAK",
"Name":"Gold PPO 35",
"Family":"Commercial",
"ProductCode":"SG-PPO-35",
"LineOfBusiness__c":"Group Health",
"MarketSegment__c":"Small Group",
"Type__c":"Medical",
"SubType__c":"PPO",
"IsRecommended__c":false,
"Tier__c":"Gold",
"ImageId__c":"01tf4000002ApR8AAK",
"PricingSource__c":"GrandTotal",
"RecordTypeName__c":"Product",
"IsConfigurable__c":true,
"PricingFormula__c":"Premium",
"productId":"01tf4000002ApR8AAK",
"ImageId":"/sfc/servlet.shepherd/version/renditionDownload?rendition=ORIGINAL_Png&versionId=068f4000002yjYjAAI",
"planId":"a0sf4000001u0ClAAI",
"planRateType":"Composite",
"RateBandTierPriceData":{
"Self":{
"Price":445,
"Sequence":"1",
"Label":"Employee"
},
"Self + Spouse":{
"Price":790,
"Sequence":"2",
"Label":"Employee + Spouse"
},
"Self + Child":{
"Price":755.5,
"Sequence":"3",
"Label":"Employee + Child"
},
"Family":{
"Price":1100.5,
"Sequence":"5",
"Label":"Family"
}
},
"childProducts":{
...
},
"attributeCategories":{
...
}
},
{
"displaySequence":-1,
"CalculatedPriceData":{
"Family":1000.5,
"Self + Child":655.5,
"Self + Spouse":690,
"Self":345
},
"Id":"01tf4000002ApQXAA0",
"Name":"Silver HMO 500",
"Family":"Commercial",
"ProductCode":"SG-HMO-500",
"LineOfBusiness__c":"Group Health",
"MarketSegment__c":"Small Group",
"Type__c":"Medical",
"SubType__c":"HMO",
"IsRecommended__c":false,
"Tier__c":"Silver",
"ImageId__c":"01tf4000002ApQXAA0",
"PricingSource__c":"GrandTotal",
"RecordTypeName__c":"Product",
"IsConfigurable__c":false,
"productId":"01tf4000002ApQXAA0",
"Price":"",
"ImageId":"/sfc/servlet.shepherd/version/renditionDownload?rendition=ORIGINAL_Png&versionId=068f4000002yjYkAAI",
"planId":"a0sf4000001u0CkAAI",
"planRateType":"Composite",
"RateBandTierPriceData":{
"Self":{
"Price":345,
"Sequence":"1",
"Label":"Employee"
},
"Self + Spouse":{
"Price":690,
"Sequence":"2",
"Label":"Employee + Spouse"
},
"Self + Child":{
"Price":655.5,
"Sequence":"3",
"Label":"Employee + Child"
},
"Family":{
"Price":1000.5,
"Sequence":"5",
"Label":"Family"
}
},
"attributeCategories":{
...
}
]
}