Problemas comuns de integração do Salesforce
Saiba como resolver problemas que você pode ter ao integrar o CPQ com o Salesforce.
Quando o Salesforce CPQ é um host para CPQ, integrando os dois sites, meu lead a alguns erros comuns. Aqui está uma lista de problemas conhecidos com suas soluções e o que verificar.
Em geral, quando você vir um erro gerado pelo Salesforce, poderá usar o. Logs de depuração do Salesforce para descobrir onde esse erro está sendo acionado.
Salesforce: "SBQQ: Demasiadas consultas SOQL: 101"
Esse erro acontece geralmente quando um usuário cria uma BOM que tem mais de 100 itens, clica Cotação em CPQ E há muitas linhas de cotação sendo criadas para o comportamento padrão do Salesforce CPQ manipular.
Solução: Confirme se a opção Habilitar configurações grandes está definida nas Configurações do pacote do Salesforce CPQ.
Essa configuração diminui a probabilidade de atingir os limites do regulador quando seus representantes de vendas configuram um pacote grande, mas o desempenho geral é mais lento. Para ler mais sobre essa configuração, consulte Habilitar configurações grandes .
Salesforce: "Tentativa de desreferenciar um objeto nulo"
Esse erro geralmente acontece quando um usuário final salva a cotação em CPQ E antes que eles retornem ao QLE. Ele se refere a uma entrada do Catálogo de preços ausente ou inativa para itens afetados ou a um problema com agrupamento aninhado.
Solução (sem agrupamento aninhado): A entrada do catálogo de preços do produto está ausente ou inativa.
Verifique todas as entradas do catálogo de preços do produto. Este erro ocorre se qualquer uma das seguintes situações for verdadeira:
- Um produto devolvido não tem uma entrada do catálogo de preços
- Um produto retornado tem uma entrada inativa do Catálogo de preços
- O catálogo de preços relacionado a um produto retornado está inativo
- O Catálogo de preços padrão é usado por padrão, mas está inativo
Solução (agrupamento aninhado): Se você tiver o agrupamento aninhado habilitado e sua configuração tiver configurações de produtos que correspondam à estrutura a seguir, não haverá solução direta. Você pode projetar suas configurações para não encontrar esse problema do Salesforce ou desativar o agrupamento aninhado.
Parent product
Nested child 1
Product X
Nested child 2
Product XPara saber mais sobre este problema, consulte o seguinte tópico Salesforce.com:
Se você decidir desabilitar o agrupamento aninhado, poderá fazê-lo no SFDC em Configuração > Pacotes instalados > Salesforce CPQ > Configurações adicionais > Pacotes aninhados para o configurador externo.
Também envie um tíquete de suporte para que possamos enviar esta solicitação à nossa equipe de DevOps para desativar este recurso do CPQ lado. Você continuará a encontrar o problema até desativarmos este recurso.
Não gerando itens de linha de configuração ou conjuntos de dados de campo de configuração
Essa funcionalidade não é usada por muitas implementações, mas quando é, é fundamental que os objetos esperados do Salesforce sejam criados. Os itens de linha de configuração (CLIs) e os conjuntos de dados de campo de configuração (CFDSs) são objetos do Salesforce gerenciados por nosso pacote gerenciado de base e sua criação é assíncrona com os dados que são enviados para a linha de cotação.
O momento em que um usuário salva a configuração CPQ, O processo para criar esses objetos começa, independentemente de você salvar as linhas de cotação finais criadas no QLE. Quando isso ocorre, geralmente há apenas um lugar para verificar.
Solução: A criação desses objetos depende da ativação das seguintes configurações.
- (Para CLIs) Enviar dados da BOM para CPQ Objeto do Salesforce CPQ Configuração do administrador
- (Para CFDSs) Enviar dados de configuração para CPQ Objeto do Salesforce CPQ Configuração do administrador
- As permissões do SFDC do nome de usuário do token de atualização
Se essas configurações não estiverem habilitadas, esses objetos não serão criados quando o usuário clicar em Salvar.
Se essas configurações estiverem habilitadas e você ainda não vir CLIs ou CFDSs (ou o Mapeamento de campo de informações estendidas não estiver funcionando), tente o seguinte:
- Verifique o. logs Para ver se o erro "Sincronização do Salesforce do objeto LGK__ConfigurationLineItem__c para a configuração [!!] não concluído com sucesso" for exibida. Pode haver mais informações na página "Entrevistas de fluxo pausadas e com falha" na configuração do Salesforce.
- Verifique as permissões do usuário de integração em relação à lista em Permissões necessárias para o usuário de integração.
Salvar não cria linhas de cotação secundárias
CPQ A BOM tem o produto CPQ ambiente.
Salvar no Salesforce tem somente o produto configurável primário, não o. CPQ ambiente.
Apenas criamos itens de linha de cotação quando um item da BOM se encaixa nestas condições:
- O tipo de BOM do item é especificado na configuração "Tipos de BOM a serem incluídos na solicitação Salvar"
- O produto existe em nosso banco de dados a partir de nossa sincronização de produtos com o Salesforce
Esse problema ocorre quando o usuário clica em Salvar de CPQ E eles são atendidos somente com o produto configurável primário do qual eles iniciaram a configuração e nenhuma linha de cotação secundária que foi criada no CPQ configurador. Isso geralmente significa que há uma desconexão entre o objeto de produto no Salesforce e o item da BOM criado em CPQ.
-
Verifique se os produtos existem no seu site do Salesforce com os mesmos IDs de produto que são determinados pelas suas regras de produto. Se os produtos existirem, tente atualizar um campo no registro do produto (como "Ativo"), salvar, reverter, aguardar 30 minutos e tentar novamente.
A sincronização de registros do produto depende da data da última modificação dos registros do produto2 para acelerar o desempenho. Se o seu ambiente foi redirecionado de outro, os produtos que não existiam no seu último ambiente agora podem existir aqui e ter uma data anterior à reconexão. Aguarde a sincronização do produto ser concluída a cada 30 minutos e tente salvar a configuração novamente.
-
Confirme se os itens da BOM têm os tipos corretos de BOM, conforme definido em CPQ Administrador:
Se o item da BOM for do tipo Fabricação e seu CPQ O administrador tinha somente Vendas e Instalação definidas na guia Configurações, esse item não seria retornado para o QLE.
-
Verifique se o produto configurável primário tem o recurso dinâmico relacionado definido:
Em caso afirmativo, confirme também se o método de seleção de opção também é dinâmico:
Este recurso relacionado deve ser criado automaticamente quando você clicar em Logik habilitado No produto configurável, mas alguns gatilhos de produto personalizado em sua organização do Salesforce podem interromper essa automação. Para acionar a criação do recurso novamente, tente desabilitar Logik habilitado , salvando e, em seguida, rehabilitando-o. Em seguida, tente configurar com esse produto.
(Se estiver usando agrupamento aninhado, cada produto que tiver itens de linha de cotação secundários associados a ele deve ter esse recurso dinâmico relacionado ao seu produto, não apenas o Produto configurável primário de nível superior.)
Salvar não cria linhas de cotação como esperado
Isso geralmente acontece quando um dos campos nas linhas de cotação secundárias está sendo preenchido de uma forma que não é refletida no CPQ configuração. Este é um problema complicado de rastrear, já que não há um erro claro.
Solução: Verifique se o ambiente do SFDC tem scripts, fluxos ou gatilhos APEX do plug-in da calculadora de cotações (QCP) atuando nas linhas de cotação.
Especificamente para QCP, pesquise scripts personalizados. Verifique também se há um script no campo Plug-in da calculadora de cotação (Configuração > Pacotes instalados > Salesforce CPQ > Plug-in).
Revise este script personalizado para ver se ele está se comportando conforme o esperado.
CPQ: "A cadeia de caracteres JSON excede o limite de tamanho da pilha"
Isso acontecerá se o campo LGK__BomData__c contiver muitos dados (como muitas linhas de cotação ou informações estendidas) e o usuário tentar reconfigurar a cotação.
Solução: Controle quantos itens serão gravados com o recurso Limite de item da BOM. Para resolver, conte os itens na BOM da configuração que está causando o erro. (O número de itens é o número de linhas na BOM. Os itens são separados por "" no campo BomData.) Em seguida, crie um caso de suporte para definir a configuração de locatário para metade desse número. Se você não estiver usando este campo do Salesforce, defina-o como zero.
A Reconfiguração não salva seleções em CPQ
Um usuário final pode salvar uma configuração corretamente e gravar no QLE sem problemas. No entanto, quando o usuário tenta reconfigurar, nem todas as seleções são mantidas.
Soluções:
- Verifique se este problema ocorre somente com um usuário ou perfil específico. Suas permissões podem estar definidas incorretamente.
- Verifique se o produto tem o Nome do recurso relacionado, Atributos de configuração e Catálogos de preços definidos.
- Verifique se o Blueprint usa geminação , Que pode estar acionando uma regra para limpar determinadas seleções ou ter o aprimoramento Configurar/reconfigurar configurado incorretamente. Para saber mais sobre este problema, consulte Script: Verificando as primeiras configurações e as subsequentes.
Salvar não cria linhas de cotação secundárias
O produto configurável com o qual você está tentando configurar pode ter tido um problema com o. CPQ a automação foi habilitada e não criou os atributos de configuração necessários para reconfiguração. Para reconfigurar, o atributo ID de configuração deve estar presente, pois é aqui que a linha de cotação faz referência ao UUID da configuração anterior.
Na página de detalhes do produto configurável, desmarque Logik.io habilitado , salve, verifique novamente e veja se o atributo de configuração foi criado.
Não é possível acessar CPQ Administrador do SFDC
Este problema pode impedir que os administradores trabalhem no design e na implementação de CPQ. Há muitas causas para este problema.
Solução:
- Se isso estiver acontecendo para apenas um usuário:
- Confirme se eles têm acesso de administrador. Consulte Acesso do usuário.
- Verifique se eles estão enfrentando problemas no navegador. Consulte Problemas comuns do navegador durante o uso CPQ.
- Se isso estiver acontecendo com um grupo de usuários:
- Confirme se o perfil e o grupo de permissões têm as permissões apropriadas do SFDC. Consulte O que fazer se receber privilégios insuficientes ou tela em branco ao iniciar uma configuração Logik .
- Confirme isso CPQ Foi adicionado a URLs confiáveis na seção Configuração, com iFrame habilitado. Embora isso não seja necessário em todos os casos, vimos essa adição ajudar as organizações com CPQ Usuários de vários países diferentes ou se estiverem usando o Gerenciador de assinaturas/RLM.
- Se isso estiver acontecendo para todos os usuários, verifique se o URL foi inserido corretamente nas Configurações personalizadas.
Geralmente, esta é uma das primeiras etapas feitas ao integrar um CPQ Ambiente com uma organização SFDC. Às vezes, o usuário que o configura definirá acidentalmente o URL como uma substituição para um perfil (a caixa inferior) em vez de acessível para todos os usuários (a caixa do meio).
Não é possível iniciar uma configuração
A mensagem de erro "Privilégios insuficientes" do Salesforce é apenas uma das muitas telas que um usuário pode encontrar ao clicar no ícone de chave inglesa no QLE ou ao selecionar um produto após clicar Editar linhas na cotação.
Quando esse problema ocorre, outros problemas podem incluir a exibição da tela de conteúdo bloqueado (como visto em Não é possível acessar CPQ Problema do SFDC), exibição de uma tela em branco ou exibição de uma mensagem de erro.
Isso pode acontecer por vários motivos, incluindo problemas com as mesmas permissões necessárias para acessar o. CPQ Admin No entanto, esse problema afeta somente os usuários finais do configurador (ou seja, usuários de vendas/parceiros).
Soluções:
- Se isso estiver acontecendo somente para um Blueprint ou ao iniciar a partir de uma cotação, verifique se há erros na guia Logs do CPQ Admin
Se você não encontrar erros nos logs, revise Causas e mensagens de erro comuns. Isso pode ser devido a um problema com o script Configurar/Reconfigurar do Blueprint ou com um campo geminado esperado da cotação.
- Se isso estiver acontecendo com apenas um usuário, verifique se ele está enfrentando problemas no navegador. Consulte Problemas comuns do navegador durante o uso CPQ.
- Se isso estiver acontecendo com um grupo de usuários, verifique se o perfil e o grupo de permissões deles têm as permissões apropriadas do SFDC. Consulte O que fazer se receber privilégios insuficientes ou tela em branco ao iniciar uma configuração Logik .
- Se isso estiver acontecendo para todos os usuários, confirme se o URL está correto no Salesforce CPQ. Navegue até Configuração > Pacotes instalados > Salesforce CPQ > Configurar > Configurações adicionais > URL do configurador externo e Configurador de terceiros.
Geralmente, esta é uma das primeiras etapas feitas ao integrar um CPQ Ambiente com uma organização SFDC. O URL geralmente assumirá a forma de
https://<domain-name>.<sector>.logik.io/ui/configure, Mas pode variar dependendo se você usa páginas Visualforce para iniciar o configurador.Se o URL não estiver no formulário acima, sua organização deve ter a documentação para a configuração personalizada feita para iniciar no CPQ configurador.
Configurações de compartilhamento de API de SDC/usuários do parceiro
- Guia de preços
- Recurso do produto
- Cota
- Linha de cotação
- Atributo da configuração
- Item de linha de configuração
O Salesforce CPQ precisa de acesso a esses objetos para que parte de nossa integração de reconfiguração funcione.
Em geral, você não precisaria editar as Configurações de compartilhamento deste objeto, pois ele foi criado pelo usuário de integração, mas em muitos casos, os usuários parceiros podem tentar fazer referência a esses registros durante a SDC, portanto, eles precisarão definir como Público somente leitura ou Público leitura/gravação.
Problemas da plataforma Salesforce
Você pode receber a mensagem "Erro ao salvar registro":
Erro ao salvar registro: Não foi possível converter o produto configurável em um produto estático. Certifique-se de que os componentes secundários atendam aos requisitos e tente novamente.
Este erro pode ocorrer quando você tenta desmarcar o. LGK__IsConfigurable__cCampo em um registro Product2. Para resolver o problema, no inicializador do app Salesforce, visite a página Configurações personalizadas de administrador do Logik.io e habilite o. Ignorar gatilho de configuração de produto configurável configuração.