Loading
Insurance
InsPolicyService:createOutOfSequencePolicyVersion

InsPolicyService:createOutOfSequencePolicyVersion

Utilisez ce service pour initier une recommandation hors séquence pour une police donnée.

Classe: InsPolicyService

Méthode : createOutOfSequencePolicyVersion

Le service crée les transactions suivantes pour une recommandation hors séquence :

  • Hors séquence modifié/approuvé : Variation totale des primes pour l'année de police par suite de l'approbation. Si des polices à durées multiples sont impactées, la transaction est créée pour chaque durée.

  • Avenant hors séquence : L'ajustement de prime du calendrier de paiement lorsque l'avenant est effectué. Ce n'est que pour la durée actuelle. La date d'entrée du calendrier de paiement correspond à la date actuelle ou à la date d'opération à laquelle le hors-séquence est effectif entre une date passée et la date actuelle. Pour une date future, la date d'entrée du calendrier de paiement est la date effective de l'avenant hors séquence.

    Important
    Important Le Numéro de police de référence doit être rempli dans toutes les versions de police à travers les durées.

Fonctionnement

  1. Le service prend en policyId la politique actuelle, la date d'entrée en vigueur de l'avenant hors séquence et le JSON spécifié par le inputKey.

  2. Si createTransaction est true, le service crée une transaction hors séquence de type Out-of-Sequence Changed/Endorsed et les détails de la transaction.

  3. Si includePaymentSchedule est true, le service génère ou met à jour les calendriers de paiement et les détails d'entrée du calendrier de paiement. Le calcul est effectué sur la base des valeurs sélectionnées pour les options de paymentCalculationMethod et de paymentFrequency correspondantes. Le calendrier de paiement suit les règles existantes :

    • Seuls les calendriers de paiement impayés datés du futur sont mis à jour.

    • Les calendriers de paiement passés, payés ou impayés, ne sont jamais mis à jour.

    • Tous les ajustements du paiement passé et du calendrier de paiement payé sont inclus dans la transaction Avenant hors séquence.

  4. Le service met à jour la valeur du champ IsPolicyEditLocked sur true dans les versions de police d'assurance associées. Toutes les versions de police sont verrouillées jusqu'à ce que la transaction d'approbation hors séquence soit terminée.

Remarque
Remarque

Le service prend également en charge les recommandations hors séquence lorsque la version d'origine de la police a une durée inférieure à 365 jours, ou inférieure à 366 jours par année bissextile. Consultez Considérations et limitations relatives aux polices d'assurance.

Prise en charge des champs personnalisés

  • Stockez les champs personnalisés de l'objet Police d'assurance dans l'ensemble de champs OutOfSequenceEndorsementCustomFields.

  • Remplissez les champs personnalisés sous forme de paires clé/valeur dans la section additionalFields. Consultez JSON d'entrée.

  • Utilisez cet ensemble de champs OutOfSequenceEndorsementCustomFields pour copier des données personnalisées depuis la version annulée vers la nouvelle version de la stratégie lors d'une recommandation hors séquence.

Options distantes

Option

Description

policyId

Obligatoire.

L'ID d'une stratégie existante que le service met à jour en fonction d'informations nouvelles ou mises à jour.

createContactForParticipants

Facultatif.

true ou false

Par défaut true.

Si false, le service ne crée pas d'enregistrement de contact.

createInsuredItemsRelationships

Facultatif.

true ou false

Si cette option est true, spécifiez une liste de relations instanceKey > parentInstanceKey entre les éléments assurés.

Cette option prend en charge les relations parent > enfant et parent > enfant > élément assuré petit-enfant.

createTransaction

Facultatif.

true ou false

Par défaut false.

Si true, le service crée une transaction.

effectiveDate

Obligatoire.

"YYYY-MM-DD HH:MM:SS" ou %OmniScriptDataElement%

La date à partir de laquelle les modifications des recommandations hors séquence s'appliquent.

includePaymentSchedule

Facultatif.

true si le calendrier de paiement est créé ou mis à jour pour la police.

La valeur par défaut est false.

inputKey

Obligatoire.

%theJSONyouneed%

Un JSON avec les entrées nécessaires pour créer ou mettre à jour une stratégie. Vous pouvez spécifier l'une des valeurs suivantes :

  • postDataCustomClassName

  • postDataDRBundleName

    Si vous ne spécifiez pas l'une de ces options, la valeur est définie par défaut sur postDataCustomClassName.
paymentCalculationMethod Obligatoire si includePaymentSchedule est true. Cette option remplace la valeur de méthode de calcul de la prime de la police.
paymentFrequency Obligatoire si includePaymentSchedule est true. Cette option remplace la valeur de fréquence supérieure de la police.
paymentType Obligatoire si includePaymentSchedule est true. Cette option remplace la valeur du type de paiement de la prime de la police.
postDataCustomClassName

Facultatif.

Le nom de la classe personnalisée que le service utilise pour enregistrer la nouvelle version de la stratégie.

Vous devez spécifier cette option ou postDataDRBundleName.

La valeur par défaut est PostInsurancePolicy.

postDataDRBundleName

Facultatif.

Le nom du Mappeur de données Omnistudio que le service utilise pour enregistrer la nouvelle version de la stratégie.

Vous devez spécifier cette option ou postDataCustomClassName.

  • Si vous ne spécifiez pas l'un ou l'autre, le service utilise la valeur par défaut pour postDataCustomClassName.

transactionType

Facultatif.

Si aucune valeur n'est fournie pour transactionType, elle est définie par défaut sur Out-of-Sequence Changed/Endorsed.

term

La durée de la politique que le service crée.

InsPolicyService:createOutOfSequencePolicyVersion prend en charge uniquement les durées de police annuelles.

JSON d'entrée

Le service recherche les inputKey spécifiées dans le JSON du produit. Voici l'exemple de JSON d'entrée :

"newPolicyJSON": {
  "accountId": "001f400000RrQSrAAN",
  "term": "Annual",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "vlocity_ins__Type__c": "AUTO",
  },
}

Voici les exemples de JSON d'options :

{
   
    "effectiveDate": "2023-03-01",
    "inputKey": "quotepolicyJson",
    "policyId": "0YT3t000000uUz6GAE",
    "includePaymentSchedule": true,
    "createTransaction": true,
    "paymentFrequency": "Monthly",
    "paymentCalculationMethod": "Modal"
  }

JSON de sortie

Voici l'exemple de JSON de sortie lorsque le service initie une recommandation hors séquence et génère avec succès l'ID de tâche :

 {
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
 "error": "OK"
}

Voici l'exemple de JSON de sortie lorsque le service renvoie une erreur :

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
Chargement
Salesforce Help | Article