Loading
Insurance
InsPolicyService:prepareToRenewPolicy

InsPolicyService:prepareToRenewPolicy

Utilisez ce service pour calculer le montant requis pour renouveler une police existante. Ce service renvoie la prime de renouvellement, les taxes et les frais, ou le JSON de la stratégie de renouvellement sans créer de stratégie.

Classe: InsPolicyService

Méthode : prepareToRenewPolicy

Fonctionnement

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

  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. Utilise getPolicyJson pour déterminer si seuls les composants de montant de renouvellement doivent être renvoyés ou si le JSON de stratégie complet est envoyé dans la réponse.

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ù le ProductCode est le code du produit, les spécifications de couverture associées, les spécifications d'articles assurés ou les faits de tarification.

Options distantes

Option distante

Description

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

calculateTaxesAndFees

Facultatif

true ou false

Défini sur true pour calculer les taxes et les frais de la police renouvelée.

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.

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

getPolicyJson

Facultatif

Un indicateur booléen pour déterminer si seuls les composants de montant de renouvellement doivent être renvoyés en réponse ou si le JSON de stratégie complet doit être renvoyé.

ratingDate

Détermine la procédure de tarification pour la nouvelle tarification de la police. Si elle n'est pas fournie, la tarification est basée sur la date d'entrée en vigueur de la politique modifiée.

Remarque
Remarque Vous ne pouvez pas transmettre une heure spécifique pour ratingField, car le type de champ est Date. Par conséquent, l'horodatage de la date d'évaluation est défini par défaut sur minuit.

renewalEffectiveDate

Facultatif

La 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

La 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:prepareToRenewPolicy prend en charge uniquement les durées de police annuelles.

useLocalTimezone

Vrai ou Faux

La valeur par défaut est true.

Lorsque la valeur est définie sur true, le service utilise le fuseau horaire local dans lequel la stratégie est créée.

Lorsque la valeur est définie sur false, les services utilisent GMT comme fuseau horaire.

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
      }
    ]
}  

JSON de sortie

Voici un exemple de JSON de sortie :

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
Chargement
Salesforce Help | Article