Loading
Assicurazioni
InsEnrollmentService:getRatedProducts

InsEnrollmentService:getRatedProducts

Utilizzare il servizio per restituire un elenco di prodotti idonei per un determinato iscritto e i suoi dipendenti. I prezzi della fascia di tariffa per ogni prodotto vengono visualizzati quando il tipo di tariffa del piano è Composite.

Classe: InsEnrollmentService

Metodo: getRatedProducts

Importante
Importante

Cerchi il servizio che restituisce una matrice di prodotti valutati non correlati all'iscrizione? Sei nel posto sbagliato.

Si desidera InsProductService:getRatedProducts.

Come funziona

  1. Questo servizio prende il userId o contactID e il contractId dell'iscritto che ha eseguito l'accesso al sistema e la data odierna.

  2. Il servizio riceve le informazioni sull'iscritto e sui dipendenti (se applicabile). Trova anche un contratto valido per la data odierna, ovvero la data odierna rientra nella data di inizio e fine iscrizione.

  3. In base alle informazioni dell'iscritto e al contratto, il servizio riceve un elenco di tutti i prodotti a cui l'iscritto e le persone a carico possono iscriversi.

  4. Il servizio utilizza l'opzione di filtro per filtrare ulteriormente l'elenco dei prodotti disponibili.

  5. Il servizio calcola il tasso di ogni prodotto. Il processo di valutazione si basa sull'impostazione del tipo di valutazione a livello di piano o sulla procedura di integrazione impostata a livello di prodotto.

    • Se il tipo di valutazione è impostato su Composite, le informazioni sulla fascia di traffico vengono utilizzate per analizzare i dati di PricingLogData__c a livello di voce di contratto.

    • Se il tipo di valutazione è impostato su Age, il prezzo viene calcolato in base alla procedura di calcolo collegata al prodotto. Questo servizio supporta tutte le opzioni remote supportate in InsProductService.getRatedProducts. Per ulteriori informazioni, leggere InsProductService:getRatedProducts.

Opzioni remote

Opzione

Descrizione

effectiveDate

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

Per impostazione predefinita, la data odierna.

Service estrae i prodotti con un'effectiveDate tra EffectiveDate__c e EndDate__c e IsActive.

filters

Product2FieldName:Value,Product2FieldName:%Element Name%

Utilizzare il nome API con i due punti seguiti da un valore o da una variabile. Ad esempio, in un OmniScript, una variabile può essere il nome di un elemento, ad esempio un elenco di selezione di input.

Separare più parametri di filtro con virgole.

I filtri possono includere qualsiasi campo dell'oggetto Product2.

includeFilterAttrValues

true o false

Per impostazione predefinita, false.

Nel JSON di output, insieme alla matrice di prodotti, viene aggiunto l'oggetto filterAttrValues. Questo oggetto contiene gli attributi del prodotto radice contrassegnati come filtrabili, con il possibile elenco di valori. Questo elenco è utilizzato da alcuni modelli di interfaccia utente per filtrare insiemi di prodotti di grandi dimensioni. Gli attributi dei prodotti secondari non sono inclusi.

includeInputKeys

Solo le chiavi di input utilizzate dalla procedura di calcolo hanno un valore nei risultati.

includeRawCalculationResult

true o false

Per impostazione predefinita, false.

Include tutti i risultati della procedura di calcolo nella chiave RawPriceData.

mergeList

true o false

Per impostazione predefinita, false.

Ottimizza le chiamate di valutazione raggruppando le chiamate delle procedure di valutazione per prodotti utilizzando la stessa procedura di valutazione. Esegue una chiamata di valutazione con una matrice di oggetti di input.

Questo è utile quando si estrae un grande elenco di prodotti. Più chiamate di valutazione possono superare i limiti SQL. L'architettura della procedura di valutazione è ottimizzata per gestire una matrice di oggetti di input e ridurre al minimo il numero di query SQL necessarie.

Le procedure di calcolo con fasi di aggregazione non sono supportate.

productClasses

“ProductClassName1,ProductClassName2”

Elenco separato da virgole dei nomi delle classi di prodotto. Limita l'elenco dei prodotti a queste classi di prodotti.

stage

Utilizzato come interruttore in IP di valutazione.

Input JSON

Il servizio accetta il seguente JSON di input se il censusId viene utilizzato come input (vengono visualizzati gli ID di esempio):

{"userId": "xxxx",
"contactId": "xxxx",
"contractId": "xxx"}

Il servizio recupera i userInputs dall'oggetto membro del censimento, in particolare dal campo member.AttributeSelectedValue__c. Questi attributi devono corrispondere agli input previsti per il prodotto.

In alternativa, è possibile definire i propri userInput nel modo seguente:

"additionalInputs": 
{
    "stage": "Quote"
},
{"userId": "xxxx",
"contactId": "xxxx",
"contractId": "xxx",
"userInputs": 
    [
        {"vBirthdate": "1969-09-20",
        "FamilyTier": "Employee Only"}
    ]
}            

JSON di output

Il servizio restituisce una matrice di prodotti valutati utilizzando il modello Product JSON Structure Model. Sono incluse tutte le specifiche della copertura controllata incluse in childProducts (se presenti). Include anche i dati dei prezzi per tutte le fasce di prezzo per ogni prodotto.

In questo esempio, le opzioni contrattuali dell'iscritto restituiscono tre prodotti e i relativi prezzi di fascia tariffaria (vedere il nodo RateBandTierPriceData). Qui il tipo di valutazione è impostato su 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":{  
               ...
            }
         ]
      }
 
Caricamento
Salesforce Help | Article