Você está aqui:
InsPolicyService:cancelPolicy
Use esse serviço para cancelar uma apólice de seguro existente.
Este serviço funciona com o serviço de InsPolicyService:prepareToCancelPolicy e com o serviço de InsPolicyRevenueScheduleService:cancelRevenueSchedule para concluir todas as alterações necessárias para cancelar uma apólice, fornecer um valor de reembolso e encerrar a agenda de receita (se necessário).
Método: cancelPolicy
Como funciona
-
Exige a
assetIdoupolicyIdda apólice a ser cancelada e aeffectiveDateem que o cancelamento entra em vigor.
Nota A data efetiva de cancelamento não pode ser maior que hoje. -
Atualiza o status da apólice para
Canceled, a Data de expiração original para o valor atual da Data de expiração e a Data de expiração para um dia anterior à Data de cancelamento (com carimbo de data e hora de 23h59). -
Altera a data de expiração para o
effectiveDatepassado para o serviço com um carimbo de data e hora de 23:59. -
Usa o processo de cálculo apropriado com base no valor de
useIsPaidFlag.Com o
useIsPaidFlagdefinido como falso (desmarcado), o serviço divide proporcionalmente o prêmio total por prazo, a tarifa total por prazo e o imposto total por prazo da apólice e calcula os valores reembolsados com base na Data de cancelamento e na Data de pagamento da apólice. Se a apólice paga até a data for Nula, o serviço considerará a apólice paga totalmente e usará a Data de expiração.Com
useIsPaidFlagdefinido comotrue(selecionado), o serviço:-
Usa a agenda de pagamento para calcular o valor total já pago pela apólice. O montante total pago pela apólice é igual à soma dos montantes em agendas de pagamento com É pago definido como verdadeiro (selecionado). Esse valor é usado em cálculos de reembolso.
-
Divide proporcionalmente o prêmio total para prazo, a tarifa total para prazo e o imposto total para prazo da apólice e calcula os valores de reembolso com base na Data de cancelamento e no valor total já pago pela apólice.
-
Ajusta agendas de pagamento com base na data atual ou na data de cancelamento, o que for posterior. Se as agendas de pagamento nessa data ou após ela tiverem Is Paid definido como false (desmarcado), o serviço as excluirá.
-
Atualiza o status de todas as agendas de pagamento não pagas (que estão no passado de
cancellationDate) paraInvalid. O valor não pago é adicionado à nova agenda de pagamento. -
Cria uma nova agenda de pagamento para a data atual com um valor igual ao valor do reembolso já calculado e marca o status como
Valid. SecreateTransactionfor verdadeiro, o serviço criará uma transação de cancelamento. -
Atualiza todas as versões futuras da política com informações de cancelamento:
-
Status: Cancelado
-
Data de cancelamento: O
effectiveDatepassado para o serviço -
Prêmio por prazo, imposto por prazo e tarifa por prazo: 0
-
Data de expiração: Dia anterior à passagem do
effectiveDatepara o serviço com um carimbo de data e hora das 23:59
-
-
-
Confirma o TotalPremiumForTerm rateado para o banco de dados.
Se createTransaction=true e o ID passado for assetId, cria AssetTransaction_c (Amount_c=refund, postDate_c e transactionDate_c=effectiveDate, type=transactionType (por padrão, Cancelado). Se createTransaction=true e o ID passado for policyId, o serviço criará InsurancePolicyTransaction_c ou InsurancePolicyTransaction (Amount_c=refund, postDate_c e transactionDate_c=effectiveDate, type=transactionType (por padrão, Cancelado).
O serviço também preenche os dados de detalhamento da transação no objeto de detalhes da transação. Ele exibe dados sobre quanto cada ativo, participante e cobertura contribui para o valor total da transação em termos de prêmio, impostos e taxas. Somente ativos, participantes e coberturas que tenham pelo menos um valor não zero para prêmio, impostos e tarifas são exibidos.-
Chama InsPolicyRevenueScheduleService:cancelar usando o
assetIde otransactionIdrecém-criado. -
O InsPolicyRevenueScheduleService: cancelar serviço calcula o fim da agenda de receita e publica os resultados na seção da agenda de receita da política. Os valores de reembolso são do ponto de vista da seguradora. Um valor negativo resulta em um reembolso ao titular da apólice, e um valor positivo representa um valor não pago pelo titular da apólice.
O serviço também oferece suporte ao cancelamento de apólices em que a versão da apólice original tem uma duração inferior a 365 dias ou inferior a 366 dias em um ano bissexto. Consulte Considerações e limitações sobre apólices de seguro.
Suplementos (impostos e taxas)
Este serviço (junto com o serviço de prepareToCancel) facilita as divisões proporcionais e reembolsos de impostos e taxas quando uma apólice é cancelada. É assim que isso funciona:
-
Se a política de destino tiver um
TotalTaxAmount__c, esse valor será rateado sobre a data de cancelamento e definido no campoTotalTaxForTerm__c. -
Se a política de destino tiver um
TotalFeeAmount__c, esse valor será rateado sobre a data de cancelamento e definido no campoTotalFeeForTerm__c. -
Se a opção de
createTransaction(ver abaixo) for definida como true e a apólice de destino tiver registros deAssetPricingAdjustment__creembolsáveis, os valores de reembolso proporcionais serão definidos nos camposTaxAmount__ceFeeAmount__cda transação.
Se você estiver usando o modelo de objeto Apólice de seguro (em vez do modelo de objeto Ativo), os nomes dos campos serão diferentes:
-
TotalTaxAmount__c=StandardTaxAmount -
TotalTaxForTerm__c=TermTaxAmount -
TotalFeeAmount__c=StandardFeeAmount -
TotalFeeForTerm__c=TermFeeAmount -
AssetPricingAdjustment__c=InsurancePolicySurcharge -
TaxAmount__c=TransactionTaxAmount -
FeeAmount__c=TransactionFeeAmount
Quer saber mais sobre a transição do modelo de objeto Ativo para o modelo de objeto Apólice de seguro? Leia Harmonizar apólices de seguro.
Opções remotas
JSON de saída
Se você estiver usando o modelo de objeto Ativo, esse serviço retornará um nó de output JSON. Aqui está um exemplo:
{
"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
}
}Se você estiver usando o modelo de objeto Apólice de seguro, esse serviço retornará um nó de results JSON. Aqui está um exemplo:
{
"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"
}