Loading
Insurance
InsQuoteService:updateQuotePlans

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.

Remarque
Remarque

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.

Classe: InsQuoteService

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.

  1. Le service prend la quoteId de trouver le devis cible.

  2. Utilise le inputKey pour localiser les données d'entrée (couvertures, attributs).

  3. Modifie les couvertures ou les attributs d'un devis, en fonction des operationScope (couvertures ou attributs) et des operationType (insérer, mettre à jour, mettre à jour/insérer).

  • Si operationScope est 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 la operationType.

  • Si operationScope est 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
Remarque

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.

Remarque
Remarque

REMARQUE : Pour insérer une nouvelle couverture de produit racine, au moins un élément de ligne de devis enfant est requis sous le produit racine.

Options distantes

Option

Description

quoteId

Obligatoire.

ID du devis cible.

inputKey

Obligatoire.

Clé indiquant où dans le mappage des entrées les données d'entrée (telles que les couvertures) sont spécifiées.

operationScope

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).

operationType

Requis lorsque operationScope est coverages et ignoré lorsque operationScope est attributs.

Type d'opération effectuée : insérer, mettre à jour ou mettre à jour/insérer.

identifiers

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.

 
Chargement
Salesforce Help | Article