Loading
保險
InsEnrollmentService:getRatedProducts

InsEnrollmentService:getRatedProducts

使用服務傳回指定登記者及其下屬的符合資格產品清單。計畫的比率類型為 Composite 時,會顯示每個產品的比率帶價格。

類別:InsEnrollmentService

方法:getRatedProducts

重要
重要

尋找要傳回與註冊無關之評分產品陣列的服務嗎?您在錯誤的地方。

您想要 InsProductService:getRatedProducts。

運作方式

  1. 此服務會取得登入系統的登記者或 contactID 和登記者的 userId 日期,以及今天的日期。contractId

  2. 服務會取得登記者和相依 (若適用) 資訊。它也會尋找對今天日期有效的契約,亦即今天在註冊開始日期與註冊結束日期之內。

  3. 根據登記者資訊和契約,服務會取得登記者和相依人可註冊的所有產品清單。

  4. 服務會使用篩選選項來進一步篩選可用產品的清單。

  5. 服務會計算每個產品的比率。評分流程以計畫層級評分類型設定或在產品層級設定的整合程序為基礎。

    • 如果等級類型設定為 Composite,即比率帶。資訊用於剖析契約條列層級中 PricingLogData__c 的資料。

    • 如果等級類型設定為 Age,則會從與產品連結的計算程序計算價格。此服務支援 InsProductService.getRatedProducts 中支援的所有遠端選項。若要深入瞭解,請參閱 InsProductService:getRatedProducts。

遠端選項

選項

描述

effectiveDate

“YYYY-MM-DD HH:MM:SS” 或 %OmniScriptDataElement%

預設為今天日期。

服務會提取在 EffectiveDate__c 和 EndDate__c 和 IsActive 之間有 effectiveDate 的產品。

filters

Product2FieldName:Value,Product2FieldName:%Element Name%

使用 API 名稱加上冒號加上值或變數。例如,在 OmniScript 中,變數可以是元素的名稱,例如輸入選項清單。

使用逗號分隔多個篩選參數。

篩選條件可包含 Product2 物件上的任何欄位。

includeFilterAttrValues

true 或 false

預設為 false。

在輸出 JSON 中,這會連同產品陣列一起新增 filterAttrValues 物件。此物件包含標記為可篩選的根產品屬性,以及可能的值清單。某些 UI 範本會使用此清單來篩選大型產品集。不包含子系產品屬性。

includeInputKeys

只有計算程序使用的輸入索引鍵在結果中具有值。

includeRawCalculationResult

true 或 false

預設為 false。

在 RawPriceData 金鑰中包含計算程序的完整結果。

mergeList

true 或 false

預設為 false。

使用相同的評分程序,依產品將評分程序呼叫分組,以最佳化評分呼叫。它會使用輸入物件陣列進行一個等級呼叫。

當提取大量產品清單時,這相當有用。多個等級呼叫可以達到 SQL 限制。評分程序結構已最佳化,以處理輸入物件陣列,並將所需的 SQL 查詢數目最小化。

不支援包含彙總步驟的計算程序。

productClasses

“ProductClassName1,ProductClassName2”

產品類別名稱的逗號分隔清單。將產品清單限制為以下產品類別。

stage

作為等級 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":{  
               ...
            }
         ]
      }
 
正在載入
Salesforce Help | Article