Loading
Insurance
InsPolicyService:createRenewalQuote

Vous êtes ici :

  1. Aide de Salesforce
  2. Documents
  3. Assurance numérique

InsPolicyService:createRenewalQuote

Utilisez ce service pour créer un devis de renouvellement pour une police existante.

Classe: InsPolicyService

Méthode : createRenewalQuote

Fonctionnement

  1. Le service accepte les policyId de la police à renouveler.

    Remarque
    Remarque

    Le service passe userInputs pour déterminer des facteurs de tarification supplémentaires afin de recalculer le prix. De plus, le service utilise le nœud additionalFields pour remplir des champs supplémentaires dans l'objet devis, qui autrement ne font pas partie de ce service.

  2. Le service vérifie la date effective et la date d'expiration de la politique renouvelée. Si elle n'est pas fournie, le service calcule ces dates en utilisant la logique suivante :

    • Date effective = Date d'expiration de la police d'origine + 1 jour

    • Date d'expiration = Date effective de la nouvelle police + Durée de la nouvelle police

  3. Recalcule le prix du produit de police en utilisant les options de aggByKey et de includeInputKey.

  4. Le service crée un enregistrement Opportunité en utilisant le nœud OpportunityDetails JSON de l'entrée. Consultez exemple de JSON d'entrée. Ce nœud accepte uniquement les trois champs obligatoires suivants :

    • Nom

    • StageName

    • CloseDate

    Remarque
    Remarque Des champs d'opportunité supplémentaires ne peuvent pas être inclus dans ce nœud. Vous pouvez toutefois mettre à jour l'enregistrement de l'opportunité avec des détails supplémentaires après la génération du devis de renouvellement.

  5. Le service crée un devis de type 'Renouvellement' et le lie à l'enregistrement d'opportunité créé à l'étape précédente.

Entrées

Entrée

Description

policyId

Obligatoire

L'ID de la police à renouveler.

userInputs

Facultatif

Les détails des produits associés à la politique. Pour n'importe quel produit, le format cible de l'objet userInputs est obtenu à partir de la liste de services sous l'onglet API de la vue du produit. Les clés d'objet se présentent sous le format ProductCode.AttributeCode où ProductCode est un code de produit, des spécifications de couverture associées, des spécifications d'articles assurés ou des faits de tarification.

additionalFields

Facultatif

Les paires clé-valeur des champs supplémentaires qui ne font pas partie de ce service. Ces champs sont remplis dans l'objet devis.

opportunityDetails

Les détails de l'opportunité de renouvellement, qui est liée au devis de renouvellement. Si ce nœud n'est pas présent, le service récupère les détails de l'opportunité liée au devis source de la stratégie d'origine.

Options distantes

Option distante

Description

renewalEffectiveDate

Facultatif

Date d'entrée en vigueur de la police renouvelée. Si elle n'est pas fournie, la valeur est calculée en utilisant la logique suivante :

Date d'expiration de la police existante + 1 jour

renewalExpirationDate

Facultatif

Date d'expiration de la police renouvelée. Si elle n'est pas fournie, la valeur est définie en utilisant la logique suivante :

Date effective de la nouvelle police + Durée de la nouvelle police

term

Facultatif

La durée de la police. Il aide à calculer la renewalExpirationDate, s'il n'est pas fourni dans les options distantes. InsPolicyService:createRenewalQuote prend en charge uniquement les durées de police annuelles.

pricebook

Facultatif

Le nom de l'enregistrement PriceBook2 attribué à Quote.Pricebook2Id. La valeur par défaut est standard.

aggByKey

Obligatoire

PRODUCT.instanceKey

Le service envoie cette option en entrée à la procédure de calcul, qui l'utilise pour effectuer le calcul avec l'agrégation.

Par exemple, une police d'assurance automobile a plusieurs conducteurs joints à chaque véhicule assuré. Le véhicule assuré a une instanceKey séparée pour chaque instance de la police. Le aggByKey prend toutes les clés d’instance des véhicules et crée un éventail de primes de couverture par instanceKey. Ce tableau est transmis à la procédure de calcul afin de calculer correctement les primes.

Le service utilise cette option pour calculer le prix de la stratégie.

includeInputKeys

Obligatoire

Une chaîne de paires clé-valeur séparées par une virgule que le service transmet dans et hors de la procédure de calcul.

Ces paires clé-valeur sont incluses dans l'objet produit de sortie de l'objet CalculatedPriceData. Ils sont là pour vous aider à analyser les résultats de calcul.

Seules les clés utilisées par la procédure de calcul ont une valeur dans les résultats.

Le service utilise cette option pour calculer le prix de la stratégie.
failOnRatingFailure

Facultatif

Spécifie si le service doit échouer si la tarification ne renvoie pas de résultat lors du renouvellement.

Si true, le service s'arrête et renvoie une erreur. Si false, le service continue et crée le devis de renouvellement sans résultat d'évaluation.

JSON d'entrée

Voici un exemple de JSON d'entrée :

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    },
    "OpportunityDetails": {
      "Name": "Renewal Opportunity",
      "StageName": "Qualification",
      "CloseDate": "2023-04-04"
    }
}

JSON de sortie

La quoteId et la opportunityId du devis de renouvellement.

Voici un exemple de JSON de sortie :

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Chargement
Salesforce Help | Article