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:createRenewalQuote

          InsPolicyService:createRenewalQuote

          Use esse serviço para criar uma cotação de renovação para uma apólice existente.

          Classe: InsPolicyService

          Método: createRenewalQuote

          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 cotação, 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 cria um registro de Oportunidade usando o nó OpportunityDetails JSON da entrada. Consulte exemplo de JSON de entrada. Esse nó aceita apenas estes três campos obrigatórios:

            • Nome completo

            • StageName

            • CloseDate

            Nota
            Nota Campos de oportunidade adicionais não podem ser incluídos nesse nó. No entanto, você pode atualizar o registro da oportunidade com detalhes adicionais depois que a cotação de renovação é gerada.
          5. O serviço cria uma cotação do tipo "Renovação" e a vincula ao registro de oportunidade criado na etapa anterior.

          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.

          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 cotação.

          opportunityDetails

          Os detalhes da oportunidade de renovação, que está vinculada à cotação de renovação. Se esse nó não estiver presente, o serviço capturará os detalhes da oportunidade vinculada à cotação de origem da política original.

          Opções remotas

          Opção remota

          Descrição

          renewalEffectiveDate

          Opcional

          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

          renewalExpirationDate

          Opcional

          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

          term

          Opcional

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

          pricebook

          Opcional

          O nome do registro de PriceBook2 atribuído ao Quote.Pricebook2Id. O padrão é o padrão.

          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. O 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 essa opção para redefinir a política.

          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 essa opção para redefinir a política.

          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"
              },
              "OpportunityDetails": {
                "Name": "Renewal Opportunity",
                "StageName": "Qualification",
                "CloseDate": "2023-04-04"
              }
          }

          JSON de saída

          A quoteId e a opportunityId da cotação de renovação.

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

          {
            "quoteId": "0Q0B0000000A0YEKA0",
            "opportunityId": "006B0000006zdiAIAQ",
          }
           
          Carregando
          Salesforce Help | Article