Você está aqui:
InsPolicyService:createOutOfSequencePolicyVersion
Use esse serviço para iniciar um endosso fora de sequência para uma determinada política.
Classe: InsPolicyService
Método: createOutOfSequencePolicyVersion
O serviço cria estas transações para um endosso fora da sequência:
-
Alterado/Aprovado fora da sequência: Alteração total no prêmio para o ano da apólice como resultado do endosso. Caso as apólices de vários prazos sejam afetadas, a transação será criada para cada prazo.
-
Aprovação fora da sequência: O ajuste do prêmio para a agenda de pagamento quando o endosso é realizado. É apenas para o prazo atual. A data de entrada da agenda de pagamento é a data atual ou a data de operação em que a opção de fora da sequência entra em vigor entre uma data passada e a data atual. Para uma data futura, a data de entrada da agenda de pagamento é a data efetiva do endosso fora da sequência.
Importante O Número da política de referência deve ser preenchido em todas as versões da política entre os termos.
Como funciona
-
O serviço assume a
policyIdda política atual, a data efetiva da aprovação fora do sequência e o JSON especificado peloinputKey. -
Se
createTransactionfortrue, o serviço criará uma transação fora de sequência do tipoOut-of-Sequence Changed/Endorsede os detalhes da transação. -
Se
includePaymentSchedulefortrue, o serviço gerará ou atualizará agendas de pagamento e detalhes de entrada da agenda de pagamento. O cálculo é realizado com base nos valores selecionados para as opções depaymentCalculationMethodepaymentFrequencycorrespondentes. A agenda de pagamento segue as regras de agenda de pagamento existentes:-
Somente agendas de pagamento não pago datadas no futuro são atualizadas.
-
Agendas de pagamento anteriores, pagas ou não pagas, nunca são atualizadas.
-
Quaisquer ajustes para o pagamento vencido e a agenda de pagamento paga são incluídos na transação de Aprovação fora de sequência.
-
-
O serviço atualiza o valor do campo
IsPolicyEditLockedparatruenas versões relacionadas da apólice de seguro. Todas as versões da apólice são bloqueadas até que a transação de aprovação fora da sequência seja concluída.
O serviço também oferece suporte a aprovações fora de sequência em que a versão da política 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.
Suporte para campos personalizados
-
Armazene os campos personalizados do objeto Apólice de seguro no conjunto de campos OutOfSequenceEndorsementCustomFields.
-
Preencha os campos personalizados como pares de chave/valor na seção
additionalFields. Consulte Entry JSON. -
Use esse conjunto de campos OutOfSequenceEndorsementCustomFields para copiar dados personalizados das versões de política canceladas para novas durante uma aprovação fora de sequência.
Opções remotas
Opção |
Descrição |
|---|---|
policyId
|
Obrigatório. O ID de uma política existente que o serviço atualiza com base em informações novas ou atualizadas. |
createContactForParticipants
|
Opcional. |
createInsuredItemsRelationships
|
Opcional.
Se essa opção for Essa opção dá suporte a relacionamentos de pai > filho e pai > filho > neto do item seguro. |
createTransaction
|
Opcional.
Padrão para Se |
effectiveDate
|
Obrigatório.
A data a partir da qual as alterações de aprovação fora da sequência se aplicam. |
includePaymentSchedule
|
Opcional.
O padrão é |
inputKey
|
Obrigatório.
Um JSON com entradas necessárias para criar ou atualizar uma política. Você pode especificar um destes valores:
|
paymentCalculationMethod
|
Obrigatório se includePaymentSchedule for verdadeiro. Essa opção substitui o valor do método de cálculo de prêmio da apólice. |
paymentFrequency
|
Obrigatório se includePaymentSchedule for verdadeiro. Essa opção substitui o valor da frequência do prêmio da apólice. |
paymentType
|
Obrigatório se includePaymentSchedule for verdadeiro. Essa opção substitui o valor do tipo de pagamento premium da apólice. |
postDataCustomClassName
|
Opcional. O nome da classe personalizada que o serviço usa para salvar a nova versão da política. Você deve especificar essa opção ou O valor padrão é PostInsurancePolicy. |
postDataDRBundleName
|
Opcional. O nome do Mapeador de dados do OmniStudio que o serviço usa para salvar a nova versão da política. Você deve especificar essa opção ou
|
transactionType
|
Opcional. Se nenhum valor for fornecido para |
term
|
O prazo da política que o serviço cria. InsPolicyService:createOutOfSequencePolicyVersion oferece suporte apenas a termos de apólice anuais. |
JSON de entrada
O serviço procura os inputKey especificados no JSON do produto. Aqui está o JSON de entrada de exemplo:
"newPolicyJSON": {
"accountId": "001f400000RrQSrAAN",
"term": "Annual",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"vlocity_ins__Type__c": "AUTO",
},
}Aqui está o JSON de opções de amostra:
{
"effectiveDate": "2023-03-01",
"inputKey": "quotepolicyJson",
"policyId": "0YT3t000000uUz6GAE",
"includePaymentSchedule": true,
"createTransaction": true,
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Modal"
}JSON de saída
Aqui está o JSON de saída de exemplo quando o serviço inicia um endosso fora da sequência e gera com sucesso o ID do trabalho:
{
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
"error": "OK"
}Aqui está o JSON de saída de exemplo quando o serviço retorna um erro:
{
"errorCode": "ERROR-CODE",
"error": "error message"
}