InsPolicyService:prepareToCancelPolicy

Este servicio debe invocarse antes del servicio de InsPolicyService:cancelPolicy.

Este servicio funciona con Salesforce Financial Services Cloud.

Clase: InsPolicyService

Método: prepareToCancelPolicy

Funcionamiento

1. Toma la assetId o policyId y encuentra la política que se va a cancelar.

2. Utiliza el proceso de cálculo apropiado basándose en el valor de useIsPaidFlag.

   Con el useIsPaidFlag establecido como falso (anulado la selección), el servicio prorratea el Total de primas por plazo, la Tarifa total por plazo y los Impuestos totales por plazo de la póliza, y calcula los importes reembolsados basándose en la Fecha de cancelación y la Póliza pagada hasta la fecha. Si Póliza pagada hasta la fecha es nula, el servicio considera la póliza pagada en su totalidad y utiliza Fecha de caducidad.

   Con useIsPaidFlag establecido como true (seleccionado), el servicio:

   1. Utiliza programaciones de pago para calcular el importe total ya pagado para la póliza. El importe total pagado por la póliza es igual a la suma de importes en programaciones de pago con Se paga establecido como verdadero (seleccionado). Este importe se utiliza en los cálculos de reembolsos.

   2. Prorratea las primas totales por plazo, la comisión total por plazo y los impuestos totales por plazo de la póliza, y calcula los importes de reembolso en base a la fecha de cancelación y el importe total ya pagado por la póliza.

3. El servicio tiene en cuenta si las comisiones o los impuestos son reembolsables o no.

4. Devuelve la diferencia de precio entre la prima total original para la póliza y la póliza cancelada en el JSON de salida.

   • Los importes de reembolso son desde la perspectiva del titular de la póliza. Un importe positivo representa un reembolso al tomador del seguro. Un importe negativo indica un importe no pagado por el tomador del seguro.

5. Si se incluyen impuestos y comisiones en esta política, el Total Tax For Term, Total Fee For Term, refundedTax y/o refundedFee también se incluyen en el JSON de salida.

   Si la política que está cancelando el servicio no incluye impuestos ni comisiones, estos campos se omiten del JSON de salida.

Recargos (Impuestos y tasas)

Este servicio (junto con el servicio de InsPolicyService:cancelPolicy) facilita el prorrateo y los reembolsos de impuestos y comisiones cuando se cancela una póliza. Así es como funciona:

• El priceDiff es esencialmente el importe del reembolso y utiliza la fórmula = (GrossWrittenPremium antigua - GrossWrittenPremium actualizada) + refundedTax + refundedFee.

• El GrossWrittenPremium actualizado es el PremiumAmount prorrateado sobre la fecha de vigencia y la fecha de cancelación de la póliza.

• El nuevo importe total es igual al PremiumAmount de la política de destino más el StandardTaxAmount más el StandardFeeAmount, todo ello prorrateado a la fecha de cancelación.

• Si la política de destino tiene un StandardTaxAmount, ese valor se prorratea sobre la fecha de cancelación y se devuelve a través del campo TermTaxAmount en la salida.

• Si la política de destino tiene un StandardFeeAmount, ese valor se prorratea sobre la fecha de cancelación y se devuelve a través del campo TermFeeAmount en la salida.

• Si la política de destino tiene registros de InsurancePolicySurcharge o AssetPricingAdjustment__c reembolsables, los importes de reembolso prorrateados se devuelven a través de los campos refundedTax y refundedFee en el resultado. Un InsurancePolicySurcharge o AssetPricingAdjustment__c es reembolsable si el PriceListEntry__c asociado es reembolsable. Los importes de reembolso prorrateados se calculan sobre la fecha de cancelación y la fecha de caducidad original.

Opciones remotas

JSON de entrada

Este servicio toma un JSON de entrada que incluye el effectiveDate (fecha de cancelación).

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

JSON de salida

El servicio devuelve la diferencia de precio calculada para la póliza con la nueva fecha de cancelación.

{
  "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"
  }
}

Claves y valores de salida