InsPolicyService:createPolicyVersion

Você está aqui:

InsPolicyService:createPolicyVersion

Use esse serviço para criar uma nova versão de uma política existente enquanto mantém o registro da política existente como está.

Esse serviço habilita o controle de versões da política. Todas as alterações em uma política são rastreadas em diferentes versões dessa política. Você pode usá-lo em modificar a política e cancelar OmniScripts de política e Procedimentos de integração. Você também pode usar esse serviço para restaurar apólices expiradas e canceladas.

Esse serviço funciona com o Salesforce Financial Services Cloud para suporte opcional à criação de Agenda de pagamento.

Classe: InsPolicyService

Método: createPolicyVersion

Como funciona

Assume a assetId ou policyId da política atual e o JSON indicado pela inputKey.
Cria um clone da política original.
Se houver uma agenda de pagamento existente, o serviço atualizará a agenda de pagamento e criará uma entrada de agenda de pagamento na data efetiva de aprovação. Se a useIsPaidFlag for verdadeira, todas as entradas futuras da agenda de pagamento (da data de vigência) sem transações (para as quais o campo de status é Valid e o campo isPaid está desmarcado) serão atualizadas com base em valores mais recentes de prêmio, impostos e taxas. A nova entrada da agenda de pagamento contém os valores ajustados de prêmio, imposto e tarifa com base em novos prêmios, impostos e tarifas e entradas da agenda de pagamento atualizadas. Além disso, os registros de contribuição dos componentes da apólice em cada entrada da agenda de pagamento são atualizados.
O serviço usa o método de cálculo de prêmio da apólice anterior, o tipo de pagamento e a frequência do prêmio, e o prêmio total para prazo, a tarifa total para prazo e o imposto total para prazo da nova apólice para gerar a agenda de pagamento modificada. Além da criação da transação, os dados de detalhamento da transação são preenchidos no objeto de detalhes da transação. Esse objeto armazena dados sobre quanto cada ativo, participante ou cobertura contribui para os valores totais da transação em termos de prêmio, impostos e taxas. Somente ativos, participantes e coberturas com pelo menos um valor maior que zero para prêmio, impostos ou tarifas são exibidos.

Nota Método de cálculo premium, Tipo de pagamento e Frequência premium não são copiados da política anterior e devem ser passados como entradas para o serviço por meio do JSON.
Se includeRevenueSchedule estiver definido como true, ele chamará o serviço de agenda de receita para modificar a agenda de receita.
Se for a primeira modificação desta política, o serviço marcará a originalVersionId__c e a previousVersionId__c com a mesma assetId. Se essa não for a primeira modificação desta política, o serviço passará a OriginalVersionId__c para a nova versão e carimbará a assetId anterior para PreviousVersionId__c na nova política.
Se os nós taxesAndFees, taxAmount e/ou feeAmount forem incluídos no JSON de entrada, os campos e/ou registros de taxa/imposto correspondentes serão criados e divididos proporcionalmente na nova versão da política.
Se aplicável, uma InsurancePolicyTransaction será criada para o ajuste de pagamento.
Se calculateCommission for true, o serviço chamará InsurancePolicyService.calculateAndSaveCommission, que preparará a entrada para os serviços de InsCommissionService.calculate e InsCommissionService.saveCommissions. Depois que o serviço de cálculo processa a entrada, o serviço de salvamento armazena o valor calculado em TotalCommissionAmount, então totaliza o valor e o adiciona à TotalCommissionAmount da Política original.
Se o sinalizador de disableAttributeCategories no serviço getquotedetail estiver definido como true, o serviço omitirá o nó attributeCategory da resposta e o serviço createPolicyVersion não criará termos de política. Para garantir que o serviço de createPolicyVersion crie termos de política, defina o sinalizador de disableAttributeCategories no serviço de getQuoteDetail como false.

Nota O serviço também oferece suporte a aprovações de apólices em que a duração da versão da apólice original é inferior a 365 dias ou inferior a 366 dias em um ano bissexto. Consulte Considerações e limitações sobre apólices de seguro.

Impostos e taxas

É assim que esse serviço funciona para impostos e tarifas:

Se o campo taxesAndFees for especificado em um registro JSON, um registro de AssetPricingAdjustment__c correspondente persistirá para cada item na lista de taxesAndFees.
Se o campo taxAmount for especificado em um registro JSON, o campo TaxAmount__c será definido como o valor do campo taxAmount no objeto AssetItem criado.
Se o campo feeAmount for especificado em um registro JSON, o campo FeeAmount__c será definido como o valor do campo feeAmount no AssetItem criado.

No que se refere à política atual (criada recentemente):

Se a política atual tiver um TotalTaxAmount__c, esse valor será dividido proporcionalmente entre as datas de vigência e de término e definido no campo TotalTaxForTerm__c.
Se a política atual tiver um TotalFeeAmount__c, esse valor será dividido proporcionalmente entre as datas de vigência e de término e definido no campo TotalFeeForTerm__c.
Se a AssetItem na política atual tiver um TaxAmount__c, esse valor será dividido proporcionalmente entre as datas de vigência e de término e definido no campo ProratedTaxAmount__c.
Se a AssetItem na política atual tiver um FeeAmount__c, esse valor será dividido proporcionalmente entre as datas de vigência e de término e definido no campo ProratedFeeAmount__c.

Para apólices já criadas, é assim que os impostos e tarifas são transferidos:

Se a política anterior tiver um TotalTaxAmount__c, esse valor será rateado sobre as novas datas de vigência e término e definido no campo TotalTaxForTerm__c.
Se a política anterior tiver um TotalFeeAmount__c, esse valor será rateado sobre as novas datas de vigência e término e definido no campo TotalFeeForTerm__c.
Se os campos AssetItem tiverem um TaxAmount__c, esse valor será rateado sobre as novas datas de vigência e término e definido no campo ProratedTaxAmount__c.
Se os campos de AssetItem na política anterior tiverem um FeeAmount__c, esse valor será dividido proporcionalmente entre as novas datas de vigência e de término e definido no campo ProratedFeeAmount__c.

Por fim, se a opção createTransaction (ver abaixo) for definida como true e a nova versão da apólice tiver impostos e taxas associados, os campos TaxAmount__c e FeeAmount__c na transação criada serão definidos para a diferença entre a nova (atual) apólice e as TotalTaxForTerm__c e TotalFeeForTerm__c da apólice anterior.

Opções remotas

Opção	Descrição
`assetId` ou `policyId`	Obrigatório. O ID da política atual.
`createContactForParticipants`	Opcional. `true` ou `false` Padrão para `true`. Se `false`, o serviço não cria registros de contato.
`createInsuredItemsRelationships`	`true` ou `false` Se essa opção estiver definida como true, você poderá especificar uma lista de relacionamentos de `instanceKey` > `parentInstanceKey` entre itens segurados. Essa opção dá suporte a relacionamentos de pai > filho e pai > filho > neto do item seguro.
`createTransaction`	Opcional. `true` ou `false` Padrão para `false`. Se `true`, o serviço cria uma transação que será usada pelos serviços de agenda de receita.
`effectiveDate`	`“YYYY-MM-DD HH:MM:SS”` ou `%OmniScriptDataElement%` A data em que a política entra em vigor. Se não houver um valor de `effectiveDate` no mapa de opções, o serviço procurará por ele no mapa de `rootAttributes`. Se o serviço não conseguir encontrar um `effectiveDate` lá, usa a data de hoje. Se você estiver usando o pacote Extensão de indústrias de seguro, o valor do carimbo de data e hora na opção `effectiveDate` 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.
`getDataCustomClassName`	Opcional. O nome da classe personalizada que esse serviço usa para recuperar informações de apólice (ativos). Se estiver usando o Salesforce FSC, especifique essa opção ou `postDataDRBundleName`. O valor padrão é definido como GetInsurancePolicy.
`getDataDRBundleName`	Opcional, O nome do Mapeador de dados que esse serviço usa para recuperar informações de apólice (ativos). Se estiver usando o Salesforce FSC, especifique essa opção ou `getDataCustomClassName`. Se você especificar ambos, o serviço usará o valor `getDataDRBundleName`. Se você também não especificar, o serviço usará o valor padrão para `getDataCustomClassName` (GetInsurancePolicy).
`includePaymentSchedule`	Opcional. `True` se a agenda de pagamento for atualizada para a apólice. O padrão é `false`.
`includeRevenueSchedule`	Opcional. Usado apenas se `createTransaction` estiver definido como `true`. `true` ou `false` Se `true`, essa opção chama InsPolicyRevenueScheduleService: modificar
`inputKey`	Obrigatório. `%theJSONyouneed%`
`isCreatingPolicyTerms`	`true` ou `false` Quando definido como `true`, o serviço retorna um nó `policyTermIds` no JSON de saída.
`postDataCustomClassName`	Opcional. O nome da classe personalizada que esse serviço usa para salvar a nova versão da política. Se estiver usando o Salesforce FSC, especifique essa opção ou `postDataDRBundleName`. O valor padrão é definido como PostInsurancePolicy.
`postDataDRBundleName`	Opcional. O nome do Mapeador de dados que esse serviço usa para salvar a nova versão da política. Se estiver usando o Salesforce FSC, especifique essa opção ou `postDataCustomClassName`. Se você especificar ambos, o serviço usará o valor `postDataDRBundleName`. Se você também não especificar, o serviço usará o valor padrão para `postDataCustomClassName` (PostInsurancePolicy).
`transactionType`	Opcional. Usado apenas se `createTransaction` estiver definido como `true`. Se nenhum valor for fornecido para `transactionType`, ele usará `Changed/Endorsed` como padrão.
`updateDataCustomClassName`	Opcional. Atualiza a política atual. Se estiver usando o Salesforce FSC, especifique essa opção ou `updateDataDRBundleName`. O valor padrão é definido como PostInsurancePolicy.
`updateDataDRBundleName`	Opcional. O nome do Mapeador de dados que esse serviço usa para atualizar a política atual. Se estiver usando o Salesforce FSC, especifique essa opção ou `updateDataCustomClassName`. Se você especificar ambos, o serviço usará o valor `updateDataDRBundleName`. Se você também não especificar, o serviço usará o valor padrão para `updateDataCustomClassName` (PostInsurancePolicy).
`useLocalTimezone`	`true` ou `false` Padrão para `true`. Quando definido como `true`, esse serviço usa o fuso horário local em que a versão da política é criada. Quando definido como `false`, esse serviço usa GMT como fuso horário.
`calculateCommission`	`true` ou `false` Quando definido como `true`, o serviço calcula as comissões para os itens raiz e salva o valor total para `TotalCommissionAmount`. Quando definido como `false` (o padrão), o serviço não calcula comissões. Nota Se você definir essa opção como true, também precisará inserir pelo menos um dos valores do código de produção ou produtor: `producerId`, `productionCodeId` ou `productionCodeName`.
`commissionType`	Opcional. Tipo de comissão (por exemplo, bônus ou padrão).
`commissionStatus`	Opcional. Status da comissão (por exemplo, Pendente, Pago ou Cancelado).
`producerId`	Opcional. O ID do produtor de processamento, ou seja, o produtor usado para recuperar o commissionScheduleId e calcular o valor da comissão. Atribuído a `InsurancePolicy.ProducerId`.
`productionCodeId`	Opcional. O ID do código de produção. Atribuído a `InsurancePolicy.ProductionCodeId__c`.
`productionCodeName`	Opcional. O nome do código de produção passado para o serviço InsCommissionService.calculate. Se você não inserir `productionCodeId`, o serviço usará `productionCodeName` para pesquisar o `productionCodeId`. Se você inserir ambos os valores, mas eles não corresponderem, `productionCodeId` terá precedência.
`memberPlanIntegrationProcedure`	Inicia um procedimento de integração personalizado com base na configuração do usuário. Quando você usa essa opção, ela passa todas as opções do serviço para o procedimento de integração personalizado e todos os IDs da apólice como entrada para integração com o objeto, por exemplo, o objeto de apólice de seguro com o plano do membro.
`ratingDate`	A data de classificação que foi usada para precificar o JSON de entrada. 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`	O prazo da política que o serviço cria. InsPolicyService:createPolicyVersion oferece suporte apenas a termos de apólice anuais.
`useIsPaidFlag`	Opcional Especifica se o sinalizador de `IsPaid` deve estar habilitado ou não. Se verdadeiro, o campo `isPaid` no objeto de entrada da agenda de pagamento é considerado durante o cálculo de prêmio, impostos e taxas. O valor padrão é falso.

JSON de entrada

Este serviço procura os inputKey especificados no JSON do produto.

"policyJson": {
  "productConfigurationDetail": {
    "insuredItems": {
      "Auto": [{
          "instanceKey": "2015 Lexus LX250",
          "autoLicNum": "Lexus",
          "autoModel": "LX150",
          "autoYear": 2015,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2006 Honda Odyssey",
          "autoLicNum": "Honda",
          "autoModel": "Odyssey",
          "autoYear": 2006,
          "BodyClass": "Minivan",
          "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2018 530 BMW",
          "autoLicNum": "530",
          "autoModel": "BMW",
          "autoYear": 2018,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2016 Camry Toyota",
          "autoLicNum": "Camry",
          "autoModel": "Toyota",
          "autoYear": 2016,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        }
      ],
      "Driver": [{
          "AGE": 20,
          "instanceKey": "Joan Smith",
          "FN": "Joan",
          "GENDER": "Female",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "John Smith",
          "FN": "John",
          "GENDER": "Male",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "Robert Henderson",
          "FN": "Robert",
          "GENDER": "Male",
          "LN": "Henderson",
          "isPrimary": false
                                        "isParent": false    
        },
        {
          "AGE": 20,
          "instanceKey": "Kinsey Schell",
          "FN": "Kinsey",
          "GENDER": "Female",
          "LN": "Schell",
          "isPrimary": false
                                        "isParent": false
        }
      ]
    },
    "accountId": "001f400000RrQSrAAN"
  }

Se a opção de controle remoto de isCreatingPolicyTerms estiver definida como true, um nó de policyTermIds será incluído. Aqui está um exemplo de nó de policyTermIds:

{  
   "policyId": "02i6g000000h110AAA",
   "policyTermIds": [
    "a5X6g000001LeUUEA0",
    "a5X6g000001LeUVEA0",
    "a5X6g000001LeUWEA0",
    "a5X6g000001LeUXEA0",
    "a5X6g000001LeUYEA0",
    "a5X6g000001LeUZEA0",
    "a5X6g000001LeUaEAK",
    "a5X6g000001LeUbEAK",
    "a5X6g000001LeUcEAK",
    "a5X6g000001LeUdEAK",
    "a5X6g000001LeUeEAK",
    "a5X6g000001LeUfEAK"
  ]
}

JSON de saída

O serviço retorna o número da nova versão da política no JSON de saída.

{
    "policyId": "02i0b00000uRwhVAAS"
    "error": "ok"
}

Este artigo resolveu seu problema?

Diga-nos para podermos melhorar!

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.

InsPolicyService:createPolicyVersion

Como funciona

Impostos e taxas

Opções remotas

JSON de entrada

JSON de saída

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.Alternar para inglêsAgora não

Área de produtos

Impacto do recurso

Edição

Experiência

InsPolicyService:createPolicyVersion

Como funciona

Impostos e taxas

Opções remotas

JSON de entrada

JSON de saída

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.