InsPolicyService:prepareToCancelPolicy

Ce service doit être invoqué avant le service InsPolicyService:cancelPolicy.

Ce service fonctionne avec Salesforce Financial Services Cloud.

Classe: InsPolicyService

Méthode : prepareToCancelPolicy

Fonctionnement

1. Prend la assetId ou la policyId et trouve que la police doit être annulée.

2. Utilise le processus de calcul approprié basé sur la valeur useIsPaidFlag.

   Lorsque useIsPaidFlag est défini sur false (désélectionné), le service calcule au prorata la prime totale pour la durée, les frais totaux pour la durée et la taxe totale pour la durée de la police, et calcule les montants remboursés en fonction de la date d'annulation et de la police payée à ce jour. Si Police payée à ce jour est nulle, le service considère que la police a été payée en totalité et utilise la Date d'expiration.

   Lorsque useIsPaidFlag est défini sur true (sélectionné), le service :

   1. Utilise des calendriers de paiement pour calculer le montant total déjà payé pour la police. Le montant total payé pour la police est égal à la somme des montants dans les calendriers de paiement avec Est payé défini sur true (sélectionné). Ce montant est utilisé dans les calculs de remboursement.

   2. Calcule au prorata la prime totale pour la durée, les frais totaux pour la durée et la taxe totale pour la durée de la police, et calcule les montants de remboursement en fonction de la date d'annulation et du montant total déjà payé pour la police.

3. Le service prend en considération si les frais ou les taxes sont remboursables ou non.

4. Renvoie la différence de prix entre la prime totale d'origine de la police et la police annulée dans le JSON de sortie.

   • Les montants de remboursement sont du point de vue du titulaire de police. Un montant positif représente un remboursement à l'assuré. Un montant négatif indique un montant impayé par l'assuré.

5. Si les taxes et les frais sont inclus dans cette stratégie, les Total Tax For Term, Total Fee For Term, refundedTax et/ou refundedFee sont également inclus dans le JSON de sortie.

   Si la stratégie que le service annule n'inclut pas les taxes ou les frais, ces champs sont omis dans le JSON de sortie.

Suppléments (taxes et frais)

Ce service (avec le service de InsPolicyService:cancelPolicy) facilite le calcul au prorata et le remboursement des taxes et des frais lorsqu'une police est annulée. Voici comment cela fonctionne :

• Le priceDiff correspond essentiellement au montant du remboursement et utilise la formule = (ancien GrossWrittenPremium - GrossWrittenPremium mis à jour) + refundedTax + refundedFee.

• La GrossWrittenPremium mise à jour est la PremiumAmount calculée au prorata de la date d'entrée en vigueur et de la date d'annulation de la police.

• Le nouveau montant total est égal au PremiumAmount de la police cible plus le StandardTaxAmount plus le StandardFeeAmount, le tout calculé au prorata de la date d'annulation.

• Si la stratégie cible a une StandardTaxAmount, cette valeur est calculée au prorata sur la date d'annulation et renvoyée via le champ TermTaxAmount de la sortie.

• Si la stratégie cible a une StandardFeeAmount, cette valeur est calculée au prorata sur la date d'annulation et renvoyée via le champ TermFeeAmount de la sortie.

• Si la stratégie cible contient des enregistrements InsurancePolicySurcharge ou AssetPricingAdjustment__c remboursables, les montants de remboursement au prorata sont renvoyés via les champs refundedTax et refundedFee de la sortie. Un InsurancePolicySurcharge ou un AssetPricingAdjustment__c est remboursable si le PriceListEntry__c associé est remboursable. Les montants de remboursement au prorata sont calculés sur la date d'annulation et la date d'expiration d'origine.

Options distantes

JSON d'entrée

Ce service utilise un JSON d'entrée qui inclut le effectiveDate (date à annuler).

{
    "Id": "02i6g000002f07VAAQ",
    "effectiveDate": "08/12/2019"
}

JSON de sortie

Le service renvoie la différence de prix calculée pour la police avec la nouvelle date d'annulation.

{
  "Id": "02i6g000002f07VAAQ",
  "output": {
    "refundedFee": -3.68,
    "totalFeeForTerm": 14.06,
    "refundedTax": -37.93,
    "totalTaxForTerm": 144.84,
    "aggregateTotalPremiumForTerms": 4002.28,
    "priceDiff": -420.97,
    "totalPremiumForTerm": 1448.44,
    "errorCode": "INVOKE-200",
    "error": "OK"
  }
}

Clés et valeurs de sortie