InsPolicyService:createUpdatePolicy

Você está aqui:

InsPolicyService:createUpdatePolicy

Use esse serviço para criar uma nova apólice de seguro ou atualizar uma apólice existente com novas informações.

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

Classe: InsPolicyService

Método: createUpdatePolicy

Como funciona

O serviço pesquisa o JSON de entrada para o inputKey. O nó inputKey contém as informações de que o serviço precisa para criar ou atualizar uma política. As informações de que esse serviço precisa incluem:
- accountId
- term
- Registros de productConfigurationDetail
- Registros de insuredItems (opcional)
- endDate
- effectiveDate
Cria um objeto Apólice (ativo).
Se houver uma agenda de pagamento para a apólice, o serviço retornará uma mensagem de erro.
Se houver um pagamento inicial, uma InsurancePolicyTransaction será criada. 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. Você deve adicionar o objeto de detalhes da transação à Lista relacionada para transação.
Se você salvar a agenda de pagamento, os registros serão vinculados ao ID da apólice original.
Se nós taxesAndfees, taxAmount e/ou feeAmount estiverem presentes no JSON de entrada, os registros de imposto e/ou taxa serão criados.
Retorna um ID de apólice no JSON de saída se o serviço não for passado por uma assetId.

Se o serviço for passado por um assetId no JSON de entrada, ele atualizará o ativo especificado pelo assetId.
SecalculateCommission=true: o serviço chama InsurancePolicyService.calculateAndSaveCommission, que prepara 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.
- O serviço chama InsurancePolicyService.calculateAndSaveCommission, que prepara a entrada para os serviços de InsCommissionService.calculate e InsCommissionService.saveCommissions.
- O tipo de comissão (por exemplo, Comissão ou Bônus) é passado para o serviço de InsCommissionService.saveCommissions como commissionType.
- O status da comissão (por exemplo, Cancelado ou Pagado) é passado para o serviço de InsCommissionService.saveCommissions como commissionStatus.
Depois que o serviço de cálculo processa a entrada, o serviço de salvamento armazena o valor calculado em TotalCommissionAmount.

Nota As endDate e effectiveDate determinam a duração da apólice. A duração da primeira versão da política pode ser 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 se impostos e tarifas forem usados:

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 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.

Opções remotas

Opção	Descrição
`assetId`	Opcional. O ID de uma política existente que esse serviço atualiza com base em informações novas ou atualizadas. Usado quando o serviço precisa atualizar uma política existente.
`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 é usada pelos serviços de agenda de receita. 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êmios, impostos e valores de taxas são exibidos. O objeto de detalhes da transação deve ser adicionado à lista relacionada de transações.
`coolingOffPeriod`	Opcional O número de dias em que você pode atrasar a primeira entrada da programação de pagamento. Com o período de esgotamento, a data da primeira agenda de pagamento da apólice é calculada como a data efetiva + o número de dias. Por exemplo, há uma frequência de pagamento mensal em que a data efetiva é 5 de janeiro e a data da primeira agenda de pagamento é 5 de janeiro. Se aplicarmos um período de resfriamento de 14 dias, a primeira entrada da agenda de pagamento mudará de 5 de janeiro para 19 de janeiro. As datas da agenda de pagamento mensal restantes permanecerão inalteradas. Nota O período de resfriamento deve estar no intervalo de 1 a 28 dias a partir da data de início da política.
`effectiveDate`	%"AAAA-MM-DD HH:MM:SS" ou %OmniScriptDataElement% A data em que a política (ou atualização da 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.
`generatePolicyNumber`	true ou false Se `true`, essa opção usa o `UniqueIdGenerator` para criar um número de apólice exclusivo. Esse número é armazenado como `Asset.SerialNumber`.
`includePaymentSchedule`	Opcional. `True` se a agenda de pagamento será criada para a apólice. O padrão é `false`.
`includeRevenueSchedule`	Opcional. `true` ou `false` Se `true`, essa opção chama o InsPolicyRevenueScheduleService: serviço createRevenueSchedule para criar uma agenda de receita ou InsPolicyRevenueScheduleService: modifyRevenueSchedule se a política estiver sendo atualizada. Se `false`, o serviço não cria uma agenda de receita para essa política.
`initialPaymentRule`	Opcional. Porcentagem, meses ou dias.
`initialTransactionName`	Opcional. O nome da transação. O padrão é usar o mesmo valor que `initialPaymentTransactionType`.
`initialPaymentTransactionType`	Opcional. O tipo de transação. O valor padrão é Premium Charge.
`initialPaymentValue`	Obrigatório se o `initialPaymentRule` for fornecido. O valor da porcentagem, ou o número de meses ou dias.
`inputKey`	Obrigatório. Um JSON do qual esse serviço obtém as informações necessárias para criar ou atualizar uma política.
`isCreatingPolicyTerms`	`true` ou `false` Quando definido como `true`, o serviço retorna um nó `policyTermIds` no JSON de saída.
`isFsc`	Opcional. `True` se a apólice a ser criada for um objeto InsurancePolicy. O padrão é `false`. Você pode especificar um`postDataCustomClassName` ou `postDataDRBundleName`. Se você não especificar uma dessas opções, o serviço usará como padrão `postDataCustomClassName`.
`paymentCalculationMethod`	Obrigatório se `includePaymentSchedule` for `true`. Substitui o valor do Método de cálculo de prêmio da apólice.
`paymentFrequency`	Obrigatório se `includePaymentSchedule` for `true`. Substitui o valor PremiumFrequency da apólice.
`paymentStartDate`	Opcional. A data da primeira entrada da programação de pagamento. O padrão é a data efetiva da apólice.
`paymentType`	Obrigatório se `includePaymentSchedule` for `true`. Substitui o valor do Tipo de pagamento premium da apólice.
`postDataCustomClassName`	Opcional. Você deve especificar essa opção ou `postDataDRBundleName`. O valor padrão é definido como PostInsurancePolicy.
`postDataDRBundleName`	Opcional. Você deve especificar essa opção ou `postDataCustomClassName`. Se você não especificar essa opção, o padrão será `postDataCustomClassName`.
`transactionType`	%OmniScriptDataElement% Use se `includeRevenueSchedule` estiver definido como true. Se nenhum valor for definido, o padrão será Política vendida.
`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, o serviço exigirá 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 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 criará. InsPolicyService:createUpdatePolicy oferece suporte apenas a termos de apólice anuais.
`useIsPaidFlag`	Opcional Se true com `includePaymentSchedule` também definido como true, o serviço cria registros de contribuição de componentes da apólice para cada entrada da agenda de pagamento. O valor padrão é falso.

JSON de entrada

Esse serviço procura o valor da inputKey.

Neste exemplo, inputKey = newPolicyJSON.

"newPolicyJSON": {
  "accountId": "001f400000OSHq2AAH",
  "term": "Annual",
  "endDate": "2019-05-14T07:00:00.000Z",
  "effectiveDate": "2018-05-15T07:00:00.000Z",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "SerialNumber": "AUTO-123",
    "Status": "InForce",
    "vlocityins2__Type__c": "AUTO",
    "vlocityins2__PaymentMethodId__c": "a2Rf40000002NrgEAE"
  },
}

O JSON dentro do inputKey inclui vários pares de chave/valor de que o serviço precisa para criar ou atualizar uma política. Ele também inclui o JSON do produto, com precificação para os itens segurados e a apólice total.

Chave	Valor
`accountId`	O ID da conta gerado para o ativo.
`additionalFields`	Opcional. Pares de chave/valor, incluindo campos de apólice (ativos) que não fazem parte do serviço.
`endDate`	Opcional. A data em que a política expira.
`effectiveDate`	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.
`insuredItems`	Os pares de chave/valor dos itens segurados que o serviço usa para criar a apólice.
`modificationDate`	A data em que a política foi modificada
`productConfigurationDetail`	Uma matriz de registros que seguem o modelo de estrutura JSON do produto.
`term`	O prazo da política que o serviço criará.

Os registros de insuredItems para este exemplo incluem os itens segurados e os valores selecionados pelo usuário para cada um.

Neste exemplo, inputKey = quotepolicyJSON.

"quotepolicyJson": {
  "productConfigurationDetail": {
    ...
  }
  "insuredItems": {
    "DRIVER": [{
        "GENDER": "Female",
        "FN": "Joan",
        "AGE": 20,
        "LN": "Smith",
        "instanceKey": "Joan Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "John",
        "AGE": 30,
        "LN": "Smith",
        "instanceKey": "John Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "Robert",
        "AGE": 30,
        "LN": "Henderson",
        "instanceKey": "Robert Henderson",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Female",
        "FN": "Kinsey",
        "AGE": 20,
        "LN": "Schell",
        "instanceKey": "Kinsey Schell",
        "isPrimary": false
        "isParent": false
      }
    ],
    "AUTO": [{
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "instanceKey": "2015 Lexus LX250",
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": true
      },
      {
        "autoLicNum": "Honda",
        "autoModel": "Odyssey",
        "autoYear": 2006,
        "instanceKey": "2006 Honda Odyssey",
        "BodyClass": "Minivan",
        "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
        "isPrimary": true
        "isParent": true                                
      }
    ]
  },
  "accountId": "0011I00000QknfjQAB",
  "opportunityId": "0061I00000AV8gBQAT"
},
"quoteId": "0Q01I000000206USAQ",
"error": "OK"

JSON de saída

O serviço retorna o ID da política recém-criada.

{
    "policyId": "02if4000001uCZXAA2",
    "error": "OK"
}

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"
  ]
}

Exemplos

O serviço costuma ser usado no padrão Quote-to-Policy do OmniScript.

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

Como funciona

Opções remotas

JSON de entrada

JSON de saída

Exemplos

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

Como funciona

Opções remotas

JSON de entrada

JSON de saída

Exemplos

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