Loading
Insurance
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

Utilisez ce service pour créer une stratégie de renouvellement à partir d'une stratégie existante.

Classe: InsPolicyService

Méthode : createRenewalPolicy

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 Police, qui 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 utilise includePaymentSchedule et includeRevenueSchedule pour déterminer si le calendrier de paiement et le calendrier de revenu doivent être créés lors du renouvellement de la politique. Si aucune option n'est spécifiée, les mêmes paramètres sont hérités de la stratégie précédente.

  5. Le service crée une stratégie et la marque comme stratégie renouvelée.

Remarque
Remarque

Le service prend également en charge le renouvellement des polices dont la version d'origine a une durée inférieure à 365 jours, ou inférieure à 366 jours par année bissextile. Cependant, lors du renouvellement, la durée de la police est de 365 jours, ou de 366 jours pour une année bissextile. Consultez Considérations et limitations relatives aux polices d'assurance.

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.

Si aucune entrée userInput n'est fournie, le service de renouvellement récupère les informations de la stratégie existante et les reproduit dans la stratégie renouvelée.

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

Options distantes

Remarque
Remarque Toutes les options distantes utilisées dans InsProductService:repriceProduct peuvent également être utilisées avec ce service.

Option distante

Description

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

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

Si vous utilisez le package Insurance Industries Extension, la valeur de l'horodatage dans l'option renewalEffectiveDate est ignorée. À la place, la valeur de l'horodatage de la date effective est définie sur minuit de la date effective sélectionnée, et la valeur de la date d'expiration est définie sur 23h59 pour la date d'expiration sélectionnée. L'horodatage est défini en utilisant le fuseau horaire spécifié par l'utilisateur.

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. La clé aggByKey prend toutes les clés d’instance des véhicules et crée un ensemble de primes de couverture par clé d’instance. Ce tableau est transmis à la procédure de calcul afin de calculer correctement les primes.

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

calculateTaxesAndFees

Facultatif.

La valeur par défaut est true.

Définissez sur true pour calculer les taxes et les frais.

createTransaction

Facultatif.

Vrai ou Faux

Valeur par défaut False.

Si true, le service crée une transaction utilisée par les services du calendrier de revenu.

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 includeInputKeys pour calculer le prix de la stratégie.

includePaymentSchedule

Facultatif

Si true, le service crée un calendrier de paiement lors du renouvellement de la politique. Si aucune valeur n'est fournie, le service crée un calendrier de paiement lors du renouvellement de la police uniquement s'il est présent pour la police d'origine.

includeRevenueSchedule

Facultatif

Si true, le service crée un calendrier de revenu lors du renouvellement de la politique. Si aucune valeur n'est fournie, les services créent un calendrier de paiement lors du renouvellement de la police uniquement s'il est présent pour la police d'origine.

paymentCalculationMethod

Obligatoire, si la valeur de includePaymentSchedule est true.

Remplace la valeur de Premium Calculation Method de la stratégie.

paymentFrequency

Obligatoire si la valeur de includePaymentSchedule est true.

Remplace la valeur de PremiumFrequency de la stratégie.

paymentType

Obligatoire si la valeur de includePaymentSchedule est true.

Remplace la valeur de Premium Payment Type de la stratégie.

ratingDate

Détermine la procédure de tarification de la police renouvelée. Si elle n'est pas fournie, la tarification est basée sur la date d'entrée en vigueur de la police renouvelé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.

term

Facultatif

La durée de la police. Il aide à calculer la renewalExpirationDate, s'il n'est pas fourni dans les options distantes. InsPolicyService:createRenewalPolicy 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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

JSON de sortie

Voici un exemple de JSON de sortie :

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
Chargement
Salesforce Help | Article