Entendendo Erros Comuns do Salesforce

---

Recursos do Salesforce

Este artigo fornece informações básicas sobre limites diários da API. Para mais informações, entre em contato com seu administrador do Salesforce. Além disso, consulte a seguinte documentação externa do Salesforce:

• Tipos de Dados Principais
• Erros de Importação de Picklist e Melhores Práticas

---

Encontrando Logs de Erro

Para encontrar seu log de erro do Salesforce, conhecido também como log de depuração, você precisará baixar o log diretamente do Salesforce.

Para informações sobre como baixar logs de depuração, consulte a seguinte documentação externa do Salesforce:

• Ver Logs de Depuração

Para mais assistência com o Salesforce, entre em contato com Suporte do Salesforce.

---

Erros Comuns do Salesforce

Abaixo estão os erros mais comuns do Salesforce que você pode encontrar com a sincronização do Salesforce habilitada. Recomendamos verificar seu log de erro regularmente. Reduzir a quantidade de erros acelerará e reduzirá o número de chamadas de API feitas ao Salesforce.

Erro		Descrição
INVALID_FIELD_ FOR_INSERT_ UPDATE		Você pode encontrar um cliente do Salesforce recebendo um erro INVALID_FIELD_FOR_INSERT_UPDATE: Attempting to update (as part of an upsert) parent field ao tentar inserir, atualizar ou upsert registros via API usando Dataloader, Informatica, Workbench ou outros programas semelhantes. Este erro pode ser resolvido desassociando todos os campos pai que você atualmente tem mapeados e, em seguida, selecionando para tentar novamente os leads que estão presos nos logs de erro com este problema. Se você ainda desejar ter os campos pai depois, pode remapeá-los, mas certifique-se de selecionar Sempre usar CRM assim que você reassociar o campo.
DUPLICATE_ EXTERNAL_ID		Este erro ocorre se você tiver registros com os mesmos IDs vindo de um sistema externo. Campos únicos são exclusivos para um registro e não podem ser duplicados. Isso pode acontecer quando um lead ou contato foi importado com o ID de CRM Externo errado. Para corrigir isso, você precisará atualizar o ID Externo com o ID de CRM Externo correto do Salesforce via Ferramenta de Importação. Para obter o ID de CRM Externo correto de 18 caracteres, você precisará fazer uma exportação completa do Salesforce—não um relatório de atividades.
INVALID_ID_FIELD		Este erro ocorre quando um registro de lead ou contato tem um ID de CRM Externo inválido. Isso também pode ocorrer quando um contato do Salesforce é importado como um registro de lead no Lead Gen & CRM, ou vice-versa.
FIELD_INTEGRITY_ EXCEPTION		A importação de novos registros ou a realização de atualizações em registros existentes pode resultar em erros de validação de dados quando listas de seleção de estado e país estão habilitadas se os dados de endereço contidos em seu arquivo não corresponderem aos dados de estado e país predefinidos. Para resolver isso, faça o seguinte: •   Defina o país padrão como Nenhum na sua seção de configuração de listas de seleção de estado e país. •   Mapeie os campos padrão Estado e País juntos.
INVALID_CROSS_ REFERENCE_KEY		O valor especificado em um campo de relacionamento não é válido, ou os dados não são do tipo esperado.
CANNOT_INSERT_ UPDATE_ACTIVATE_ ENTITY		O Salesforce tem um limite de tempo para transações com base no uso da CPU. Se as transações consumirem muito tempo de CPU, elas serão alteradas para uma transação de longa duração.
MISSING_ARGUMENT		O Salesforce requer os campos listados no registro. Certifique-se de que você tenha esses campos mapeados. Não use Sempre usar valor do CRM para esses campos.
CANNOT_UPDATE_ CONVERTED_LEAD		Quando você converte um lead em um contato, conta ou oportunidade, ele não pode ser atualizado, pois não existe mais.
FIELD_CUSTOM_ VALIDATION_ EXCEPTION		A mensagem de erro FIELD_FILTER_VALIDATION_EXCEPTION, Value does not exist or does not match filter criteria ocorre quando há um filtro de Campo de Pesquisa definido em um objeto que foi modificado de modo que a atualização não reflita os critérios do filtro. Para corrigir este erro, verifique se há filtros definidos no objeto e certifique-se de que quaisquer modificações estejam aderindo aos Critérios do Filtro.
REQUIRED_FIELD_ MISSING		O Salesforce requer os campos listados no registro. Certifique-se de que você tenha esses campos mapeados. Não use Sempre usar valor do CRM para esses campos.
MALFORMED_ID		Uma importação inseriu valores inválidos em ID de CRM Externo.
INVALID_OR_NULL_ FOR_RESTRICTED_ PICKLIST		Lead Gen & CRM tentou enviar um valor de lista de seleção que o Salesforce não permitiu. Se o valor tentado for null e o campo for uma lista de seleção de múltipla escolha, faça o seguinte: •   Desmarque a caixa de seleção Restringir lista de seleção aos valores definidos em o conjunto de valores para o campo no Salesforce. •   Adicione um valor null  à lista de seleção no Salesforce. Suporte a leitores de tela habilitado.
INACTIVE_OWNER_ OR_USER		O registro afetado no Lead Gen & CRM tem um proprietário de lead que está inativo no Salesforce.

 

Verificando os Critérios de Filtro de Campo

Para verificar se há filtros no objeto para um erro  FIELD_CUSTOM_VALIDATION_EXCEPTION , faça o seguinte:

1. Faça login no Salesforce.
2. Clique no seu nome no canto superior direito do Salesforce.
3. Selecione Configuração no menu suspenso que aparece.
4. Clique Personalizar > Objeto > Campos.
5. Role pela sua Campos Padrão e Campos Personalizados até encontrar um Campo de Pesquisa.
6. Clique no Rótulo do Campo.
7. Revise a página de detalhes para ver se existem filtros.
8. Revise os Critérios do Filtro
9. Certifique-se de que suas modificações estejam aderindo aos critérios.

---

Perguntas Frequentes

P: Quais são as melhores práticas para importar leads e contatos?
R: Ao importar/atualizar novos leads para Lead Gen & CRM via a ferramenta de importação, siga o seguinte:

• Leads e contatos devem ser importados em arquivos .CSV separados. Ao importar, no menu suspenso Importar Novos Leads Como, selecione o tipo de lead correto.
• Certifique-se de que o ID de CRM Externo correto esteja sendo usado em conjunto com leads ou contatos. Para obter o ID de CRM Externo correto de 18 caracteres, você precisará realizar uma exportação completa do Salesforce. No Salesforce, você só pode fazer exportações completas manualmente uma vez a cada 7 dias para exportações semanais, ou 29 dias para exportações mensais.

P: Por que estou vendo uma discrepância com o campo Data ou Data/Hora?
R: O fuso horário da sua instância da empresa Lead Gen & CRM não está configurado para o mesmo fuso horário da sua instância do Salesforce sincronizada. Ao sincronizar, você verá o fuso horário do Salesforce exibido ao lado do título do seu campo Data ou Data/Hora em Lead Gen & CRM.
P: Como funciona o campo Indústria em cada plataforma?
R: Você só receberá uma opção na lista suspensa ao mapear para o campo Indústria do Salesforce. Esta é uma funcionalidade pretendida para que o campo Indústria do Salesforce possa ser mapeado corretamente para o campo Indústria do Lead Gen & CRM. O Salesforce usa um campo de lista suspensa, e Lead Gen & CRM usa um campo de entrada de texto. Qualquer texto criado em Lead Gen & CRM no campo Indústria do Lead Gen & CRM estará disponível na lista suspensa de indústrias do Salesforce assim que a sincronização ocorrer. As opções selecionadas da lista suspensa de Indústria do Salesforce também serão sincronizadas para o campo Indústria do Lead Gen & CRM.
P: O que acontece quando converto um lead em um contato dentro do Lead Gen & CRM? 
R: Se um Lead estiver sincronizado entre os dois sistemas e for alterado para um Contato dentro do Lead Gen & CRM, um registro de contato será criado no Lead Gen & CRM na próxima vez que a sincronização ocorrer. Todas as informações dos campos mapeados no registro em Lead Gen & CRM serão sincronizadas para o novo registro de contato no Salesforce. Como leads e contatos são categorizados de forma diferente no Salesforce, o registro original de Lead no Salesforce permanecerá intacto. Se alterações forem feitas em Lead Gen & CRM nesse registro, então as alterações só serão sincronizadas para o registro de contato no Salesforce. Se uma alteração for feita no registro de contato no Salesforce, então ela atualizará o registro em Lead Gen & CRM.

Tenha em mente que tanto o registro de lead do Salesforce quanto o registro de contato estão tecnicamente ainda conectados com o registro de contato em Lead Gen & CRM. Isso significa que se uma alteração for detectada no registro de lead existente no Salesforce, ela sincronizará todas as suas informações de volta para o registro em Lead Gen & CRM e mudará o status do lead do Lead Gen & CRM de volta para um lead. Alterações em Lead Gen & CRM no registro a partir desse ponto serão sincronizadas para o registro de lead no Salesforce. Converter seu lead em um contato dentro do Salesforce evita a criação de registros duplicados no Salesforce.