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 el assetId o policyId de la póliza que se va a cancelar y el effectiveDate en el que entra en vigor la cancelación.

   

   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 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 la useIsPaidFlag establecida como falsa (anulada la selección), el servicio prorratea la prima total a plazo, la comisión total a plazo y los impuestos totales a 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 los useIsPaidFlag establecidos en true (seleccionados), el servicio:

   1. Utiliza la programación de pagos para calcular el importe total ya pagado por 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 la prima total a plazo, la comisión total a plazo y los impuestos totales a plazo de la póliza, y calcula los importes de reembolso basándose en la fecha de cancelación y el importe total ya pagado por la póliza.

   3. Ajusta las programaciones de pago basándose en la fecha actual o la fecha de cancelación, cualquiera que sea posterior. Si las programaciones de pago en o después de esta fecha tienen Se paga establecido como falso (anulado su selección), 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 póliza futuras con información de cancelación:

      • Estado: Cancelado

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

      • Prima a plazo, Impuestos a plazo y Tarifa a 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 Cancelado). 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 Cancelado).

   El servicio también rellena datos de desglose de transacciones en el objeto de detalles de transacción. Muestra datos acerca de cuánto contribuye cada activo, participante y cobertura al importe total de transacciones 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 empresa de seguros. Un importe negativo da como resultado un reembolso al titular de la póliza y un importe positivo representa un importe no pagado por el titular de la póliza.

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 los prorrateos y 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 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"
}