Vous êtes ici :
InsQuoteService:updateQuotePlans
Utilisez ce service dans un OmniScript pour ajouter, mettre à jour ou mettre à jour/insérer (ajouter et mettre à jour) des couvertures ou des attributs pour un ou plusieurs régimes d'avantages sociaux collectifs dans un devis. Ce service est conçu pour traiter uniquement les couvertures sous les produits racine.
Ce service n'est pas pris en charge pour les utilisateurs invités.
Si un utilisateur invité tente d'exécuter un OmniScript ou une Procédure d'intégration ou une fonction d'interface utilisateur qui utilise ce service, le service n'est pas exécuté et l'utilisateur invité affiche un message d'erreur.
Méthode : updateQuotePlans
Fonctionnement
Par exemple, si une couverture a un attribut avec le code d'attribut cat1_copay_inn et que la carte des données d'entrée contient un code d'attribut partiel copay, il y a une correspondance, car cat1_copay_inn contient la chaîne copay, et les attributs de cette couverture sont mis à jour.
-
Le service prend la
quoteIdde trouver le devis cible. -
Utilise le
inputKeypour localiser les données d'entrée (couvertures, attributs). -
Modifie les couvertures ou les attributs d'un devis, en fonction des
operationScope(couvertures ou attributs) et desoperationType(insérer, mettre à jour, mettre à jour/insérer).
-
Si
operationScopeest une couverture, les couvertures d'entrée dans les plans cibles sont insérées, mises à jour ou mises à jour dans le devis cible, en fonction de laoperationType. -
Si
operationScopeest attribut, les attributs de couverture du devis cible sont mis à jour, en fonction des couvertures qui contiennent des attributs dont le code contient l'un des codes d'attribut partiel répertoriés dans la carte des données d'entrée.
REMARQUE : Si planIds est fourni, la couverture sera mise à jour uniquement si elle appartient à l'un des planId de la liste, même si une correspondance existe.
Options distantes
Option |
Description |
|---|---|
|
Obligatoire. ID du devis cible. |
|
Obligatoire. Clé indiquant où dans le mappage des entrées les données d'entrée (telles que les couvertures) sont spécifiées. |
|
Obligatoire. Étendue des éléments mis à jour dans les plans. Les valeurs possibles sont les couvertures et les attributs (c'est-à-dire que les couvertures ou les attributs peuvent être mis à jour). |
|
Requis lorsque operationScope est coverages et ignoré lorsque Type d'opération effectuée : insérer, mettre à jour ou mettre à jour/insérer. |
|
Liste de valeurs de chaîne de planIds. Obligatoire lorsque operationScope correspond à des couvertures, facultatif lorsque operationScope correspond à des attributs. |
Options MAP
Voici quelques exemples de variables de carte d'options, telles qu'utilisées dans une carte, lorsque la operationScope est une couverture :
{
'quoteId': '0Q0000000000000000',
'inputKey': 'inputJson',
'operationScope': 'coverages',
'operationType': 'insert',
'identifiers': planId1, planId2'
}
Voici quelques exemples de variables de carte d'options, telles qu'utilisées dans une carte, lorsque le operationScope est attribut :
{
'quoteId': '0Q0000000000000000',
'inputKey': 'inputJson',
'operationScope': 'attributes',
'identifiers': '0QLf4000000SX3tGAG, 0QLf4000000SX3rGAG'
}
JSON d'entrée
Si la operationScope est une couverture, les données d'entrée doivent contenir un objet JSONResult (ou une carte qui peut être analysée en tant qu'objet JSONResult) qui contient les couvertures à insérer ou à mettre à jour (Couverture 1, Couverture 2, etc.) :
{
'inputJson': {
'records': [{
'productName': 'Coverage 1',
'attributeCategories': [...],
...
}, {
'productName': 'Coverage 2',
'attributeCategories': [...],
...
}]
}
}
Si la operationScope est des attributs, les données d'entrée doivent contenir une carte des codes d'attribut partiels et leurs valeurs mises à jour, comme indiqué dans cet exemple :
{
'inputJson': {
'copay': 20,
'covered': '90%'
}
}
Exemple d'utilisation
Supposons que vous souhaitiez modifier la valeur de l'attribut Copay dans l'ensemble du ChirOffiProf de catégorie d'attribut.
En supposant une convention de nommage standard :
attributeCategory_attributeCode_inNetwork/outOfNetwork
Avec les attributs Copay dans le réseau et hors réseau suivants :
-
ChirOffiProf_copay_inn -
ChirOffiProf_copay_oon
Vous configureriez le service de updateQuotePlans avec les entrées et les options suivantes :
Entrées
Carte des codes partiels et de leurs valeurs (c.-à-d. que copay renvoie n'importe quel nom d'attribut avec copay dans la chaîne). Le code partiel dans ce cas serait la partie attributeCode du modèle :
{
'copay': 20,
'covered': 75
}
Options
-
quoteId
-
planId (QuoteLineItem Id)
Le service recherche toutes les couvertures dans les planIds spécifiés qui ont un attribut contenant le code d'attribut partiel (dans le cas présent, copay) et met à jour ces attributs avec la nouvelle valeur (dans le cas présent, 20).
Si aucun planId n'est spécifié, toutes les couvertures qui ont un attribut contenant la attributeCode partielle transmise sont mises à jour.
