Loading
Seguro
Índice
Selecionar filtros

          Sem resultados
          Sem resultados
          Aqui estão algumas dicas de pesquisa

          Verifique a grafia das palavras-chave.
          Tente utilizar termos mais genéricos.
          Selecione menos filtros para ampliar sua pesquisa.

          Pesquisar em toda a Ajuda do Salesforce
          InsPolicyService:createRenewalPolicy

          InsPolicyService:createRenewalPolicy

          Use esse serviço para criar uma política de renovação a partir de uma política existente.

          Classe: InsPolicyService

          Método: createRenewalPolicy

          Como funciona

          1. O serviço aceita a policyId da apólice a ser renovada.

            Nota
            Nota

            O serviço passa userInputs para determinar fatores de classificação adicionais para recalcular o preço. Além disso, o serviço usa o nó additionalFields para preencher campos adicionais no objeto de política, que de outra forma não fazem parte desse serviço.

          2. O serviço verifica a data de vigência e a data de expiração da apólice renovada. Se não forem fornecidas, o serviço calculará essas datas usando a seguinte lógica:

            • Data de vigência = Data de expiração da apólice original + 1 dia

            • Data de expiração = Data efetiva da nova política + Prazo da nova política

          3. Reavalia o preço do produto da apólice usando as opções aggByKey e includeInputKey.

          4. O serviço usa includePaymentSchedule e includeRevenueSchedule para determinar se a agenda de pagamento e a agenda de receita devem ser criadas em apólice renovada. Se nenhuma opção for especificada, as mesmas configurações serão herdadas da política anterior.

          5. O serviço cria uma política e a marca como política renovada.

          Nota
          Nota

          O serviço também oferece suporte à renovação 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. No entanto, na renovação, a duração da apólice é de 365 dias, ou 366 dias para um ano bissexto. Consulte Considerações e limitações sobre apólices de seguro.

          Contribuições

          Entrada

          Descrição

          policyId

          Obrigatório

          O ID da apólice a ser renovada.

          userInputs

          Opcional

          Os detalhes dos produtos associados à política. Para qualquer produto, o formato de destino para o objeto userInputs é obtido da listagem de serviços na guia API da exibição de produto. As chaves de objeto estão no formato ProductCode.AttributeCode em que o ProductCode é código de produto, especificações de cobertura associadas, especificações de item segurado ou fatos de classificação.

          Se nenhum userInputs for fornecido, o serviço de renovação pegará as informações da política existente e as reproduzirá na política renovada.

          additionalFields

          Opcional

          Os pares de chave e valor dos campos adicionais que não fazem parte desse serviço. Esses campos são preenchidos no objeto de política.

          Opções remotas

          Nota
          Nota Todas as opções de controle remoto usadas em InsProductService:repriceProduct também podem ser usadas com esse serviço.

          Opção remota

          Descrição

          renewalExpirationDate

          Opcional

          A data de expiração da apólice renovada. Se não for fornecido, o valor será definido usando a seguinte lógica:

          Data efetiva da nova política + Prazo da nova política

          renewalEffectiveDate

          Opcional

          A data efetiva da apólice renovada. Se não for fornecido, o valor será calculado usando a seguinte lógica:

          Data de expiração da apólice existente + 1 dia

          Se você estiver usando o pacote Extensão de indústrias de seguro, o valor do carimbo de data e hora na opção renewalEffectiveDate será ignorado. Em vez disso, o valor do carimbo de data e hora efetiva é definido como 00h da data efetiva selecionada e o valor da data de expiração é definido como 23h59 para a data de expiração selecionada. O carimbo de data e hora é definido usando o fuso horário especificado pelo usuário.

          aggByKey

          Obrigatório

          PRODUCT.instanceKey

          O serviço envia essa opção como uma entrada para o procedimento de cálculo, que a usa para concluir o cálculo com agregação.

          Por exemplo, uma apólice de seguro automático tem vários motoristas anexados a cada veículo segurado. O veículo seguro tem uma instanceKey separada para cada instância na apólice. A aggByKey pega todas as chaves de instância para os veículos e cria uma matriz de prêmios de cobertura por instanceKey. Essa matriz é passada para o procedimento de cálculo para que os prêmios sejam calculados corretamente.

          O serviço usa esse valor para redefinir a política.

          calculateTaxesAndFees

          Opcional.

          O valor padrão é true.

          Defina como true para calcular impostos e taxas.

          createTransaction

          Opcional.

          Verdadeiro ou Falso

          O padrão é Falso.

          Se verdadeiro, o serviço cria uma transação que é usada pelos serviços de agenda de receita.

          includeInputKeys

          Obrigatório

          Uma string de pares de chave-valor separados por vírgula que o serviço passa para dentro e para fora do procedimento de cálculo.

          Esses pares de chave-valor são incluídos no objeto de produto de saída dentro do objeto CalculatedPriceData. Eles estão lá para ajudá-lo a analisar os resultados do cálculo.

          Somente chaves usadas pelo procedimento de cálculo têm um valor nos resultados.

          O serviço usa includeInputKeys para redefinir a política.

          includePaymentSchedule

          Opcional

          Se verdadeiro, o serviço criará uma agenda de pagamento na apólice renovada. Se nenhum valor for fornecido, o serviço criará uma agenda de pagamento na apólice renovada apenas se estiver presente para a apólice original.

          includeRevenueSchedule

          Opcional

          Se verdadeiro, o serviço criará uma agenda de receita na apólice renovada. Se nenhum valor for fornecido, os serviços criam uma agenda de pagamento na apólice renovada apenas se ela estiver presente para a apólice original.

          paymentCalculationMethod

          Obrigatório, se o valor de includePaymentSchedule for verdadeiro.

          Substitui o valor de Premium Calculation Method da apólice.

          paymentFrequency

          Obrigatório se o valor de includePaymentSchedule for verdadeiro.

          Substitui o valor de PremiumFrequency da apólice.

          paymentType

          Obrigatório se o valor de includePaymentSchedule for verdadeiro.

          Substitui o valor de Premium Payment Type da apólice.

          ratingDate

          Determina o procedimento de classificação para precificação da apólice renovada. Se não for fornecido, a precificação será feita com base na data efetiva da apólice renovada.

          Nota
          Nota Não é possível passar um horário específico para ratingField, pois o tipo de campo é Date. Assim, o carimbo de data e hora da classificação usa como padrão 12:00.

          term

          Opcional

          O prazo da política. Ajuda a calcular renewalExpirationDate, se não for fornecida nas opções remotas. InsPolicyService:createRenewalPolicy oferece suporte apenas a termos de apólice anuais.

          useLocalTimezone

          Verdadeiro ou Falso

          O valor padrão é true.

          Quando o valor é definido como verdadeiro, o serviço usa o fuso horário local em que a política é criada.

          Quando o valor é definido como falso, os serviços usam GMT como fuso horário.

          JSON de entrada

          Aqui está um exemplo do JSON de entrada:

          {
             "policyId": "0YT5w000000Y8MNGA0",
             "userInputs": [
                {
                  "DRIVER.instanceKey": "Bob Jones",
                  "DRIVER.LN": "Jones",
                  "DRIVER.GENDER": "Male",
                  "DRIVER.FN": "Bobby",
                  "DRIVER.AGE": 30,
                  "AUTO.instanceKey": "2018 Audi A3",
                  "AUTO.autoYear": 2018,
                  "AUTO.autoModel": "A4",
                  "perAccident": 500
                }
              ],
             "additionalFields": {
                "BillingName": "John Smith",
                "Description": "This is a renewal quote",
                "Phone": "123456789"
              }
          }    

          JSON de saída

          Aqui está um exemplo do JSON de saída:

          {
            "snapshotId": [
              "00P5w00001fKlqEEAS"
            ],
            "InsurancePolicy": [
              "0YT5w000000Y8tTGAS"
            ]
            "error": "OK"
          }
           
          Carregando
          Salesforce Help | Article