InsPolicyService:cancelPolicy

Este servicio funciona con el servicio de InsPolicyService:prepareToCancelPolicy y con el servicio de InsPolicyRevenueScheduleService:cancelRevenueSchedule para completar todos los cambios necesarios para cancelar una póliza, proporcionar un importe de reembolso y finalizar la programación de ingresos (si es necesario).

Clase: InsPolicyService

Método: cancelPolicy

Este servicio funciona con Salesforce Financial Services Cloud.

Funcionamiento

1. Toma la assetId o policyId de la póliza que se va a cancelar y el effectiveDate en el que la cancelación entra en vigor.

   

   Nota La fecha de cancelación efectiva no puede ser superior a hoy.

2. Actualiza el estado de la póliza a Canceled, la Fecha de caducidad original al valor actual de la Fecha de caducidad y Fecha de caducidad a un día antes de la Fecha de cancelación (con marca de tiempo de 11:59 PM).

3. Cambia la fecha de caducidad al effectiveDate pasado al servicio con una marca de tiempo de 11:59 PM.

4. 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 la programación de pagos 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. Ajusta las programaciones de pagos en función de la fecha actual o la fecha de cancelación, cualquiera que sea posterior. Si las programaciones de pago en esta fecha o después tienen Se paga establecido como falso (no seleccionado), el servicio las elimina.

   4. Actualiza el estado de todas las programaciones de pago impagadas (que en el pasado eran de cancellationDate) a Invalid. El importe no pagado se agrega a la nueva programación de pagos.

   5. Crea una nueva programación de pagos para la fecha actual con un importe igual al importe de reembolso ya calculado y marca el estado como Valid. Si createTransaction es verdadero, el servicio crea una transacción de cancelación.

   6. Actualiza todas las versiones de política futuras con información de cancelación:

      • Estado: Cancelado

      • Fecha de cancelación: El effectiveDate pasó al servicio

      • Prima por plazo, Impuestos por plazo y Tarifa por plazo: 0

      • Fecha de caducidad: Día antes de que el effectiveDate pasara al servicio con una marca de tiempo de 11:59 PM

5. Confirma el TotalPremiumForTerm prorrateado en la base de datos.

6. Si createTransaction=true y el Id. pasado es assetId, crea AssetTransaction_c (Amount_c=refund, postDate_c y transactionDate_c=effectiveDate, type=transactionType (valor predeterminado es Canceled). Si createTransaction=true y el Id. pasado es policyId, el servicio crea InsurancePolicyTransaction_c o InsurancePolicyTransaction (Amount_c=refund, postDate_c y transactionDate_c=effectiveDate, type=transactionType (valor predeterminado es Canceled).

   El servicio también rellena datos de desglose de transacciones en el objeto de detalles de transacciones. Muestra datos acerca de cuánto contribuye cada activo, participante y cobertura al importe total de la transacción en términos de primas, impuestos y comisiones. Solo se muestran aquellos activos, participantes y coberturas que tienen al menos un valor distinto de cero para primas, impuestos y comisiones.

7. Llama a InsPolicyRevenueScheduleService:cancel utilizando el assetId y el transactionId recién creado.

8. The InsPolicyRevenueScheduleService: cancelar servicio calcula el final de la programación de ingresos y publica los resultados en la sección de programación de ingresos de la política. Los importes de reembolso son desde la perspectiva de la compañía aseguradora. Un importe negativo da como resultado un reembolso al tomador del seguro y un importe positivo representa un importe no pagado por el tomador del seguro.

Nota

El servicio también admite la cancelación de pólizas donde la versión de póliza original tiene una duración de menos de 365 días o menos de 366 días en un año bisiesto. Consulte Consideraciones y limitaciones para pólizas de seguros.

Recargos (Impuestos y tasas)

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

• Si la política de destino tiene un TotalTaxAmount__c, ese valor se prorratea sobre la fecha de cancelación y se establece en el campo TotalTaxForTerm__c.

• Si la política de destino tiene un TotalFeeAmount__c, ese valor se prorratea sobre la fecha de cancelación y se establece en el campo TotalFeeForTerm__c.

• Si la opción de createTransaction (consulte a continuación) está establecida como verdadera y la política de destino tiene registros de AssetPricingAdjustment__c reembolsables, los importes de reembolso prorrateados se establecen en los campos TaxAmount__c y FeeAmount__c de la transacción.

Si está utilizando el modelo de objeto Póliza de seguros (en vez del modelo de objeto Activo), los nombres de campo son diferentes:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Sugerencia

¿Desea obtener información acerca de la transición del modelo de objeto Activo al modelo de objeto Póliza de seguros? Lea Armonizar pólizas de seguros.

Opciones remotas

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

JSON de entrada

Este servicio no toma un JSON de entrada.

JSON de salida

Si está utilizando el modelo de objeto Activo, este servicio devuelve un nodo de output JSON. A continuación se ofrece un ejemplo:

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

Si está utilizando el modelo de objeto Póliza de seguros, este servicio devuelve un nodo de results JSON. A continuación se ofrece un ejemplo:

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}