Esta funcionalidade permite validar e importar bases de usuários utilizando diferentes tipos de identificadores (CPF/CNPJ, e-mail, telefone, etc.). Ela garante que apenas dados consistentes e únicos sejam processados, evitando erros nas integrações e preservando a qualidade da base. 

Para quem é este artigo?

• Nível de Acesso: Administrador, Editor.

Nesse artigo você vai encontrar:

1. Tipos de Validação de Identificadores

Entenda como cada identificador é analisado e quais critérios são aplicados.

2. Validações Gerais (independentes do tipo de ID)

Regras comuns aplicadas a todos os registros durante o processo de importação.

3. Status da Importação

Acompanhe o progresso e o resultado da importação da sua base de dados.

4. Validando os Erros Encontrados

Como interpretar e corrigir os erros detectados após a validação. 

Materiais de apoio

Conteúdo que pode te ajudar neste processo.

FAQ – Perguntas Frequentes sobre Validando erros na importação de base

1. Tipos de Validação de Identificadores

CPF/CNPJ

Tratamos o dado removendo pontos, traços e barras, mantendo apenas números.
Em seguida, validamos se há 11 (CPF) ou 14 caracteres (CNPJ).
Caso alguma linha possua menos de 11 caracteres, as alterações não serão aplicadas para essas fichas.

E-mail

Validamos se o dado está no formato correto, contendo "@" e "dominio.com(.br)".
Linhas com inconsistências não terão suas alterações aplicadas.

User ID (exportado da Dito)

Não possui validação. É importado exatamente como informado.
Com o pré fixo ID=

Telefone

• Removemos tudo e deixamos apenas números.

• Validamos se possui mínimo de 10 caracteres.

• Após isso, o valor é transformado em SHA1.
  

Importante: Esta opção só deve ser utilizada por marcas que usam telefone como chave de integração. Essa informação está no plano de tracking de cada marca.

SHA1 (hash) do telefone

Validamos se o valor informado é um SHA1 válido.

ID customizado

Validamos se não há caracteres especiais.

2. Validações Gerais (independentes do tipo de ID)

As regras abaixo se aplicam a todos os identificadores:

• O ID deve ser único. Caso se repita mais de uma vez, a importação não será permitida.

• Será validado se o campo reference está sendo enviado dentro do ID.

3. Status da Importação

Durante o processamento da base, a importação poderá apresentar os seguintes status:

Validando:

Os dados estão sendo analisados.

Inválido:

Não foi possível processar a importação porque todas as linhas apresentaram erro.

Inconsistência encontrada:

Apenas algumas linhas possuem erro. As linhas corretas serão importadas após aprovação.

Parcialmente concluído:

Parte da base foi importada com sucesso. Outras linhas foram rejeitadas.

4. Validando os Erros Encontrados

Na tela de Importações, se o status estiver como “Parcialmente Concluído” ou “Inválido”, será possível clicar no status e baixar o arquivo de log.

O arquivo mostra:

• Status de cada linha

• A coluna que apresentou erro

Isso permite corrigir rapidamente os problemas e reenviar a base.

Importante:
A primeira linha do arquivo é o cabeçalho, portanto deve ser desconsiderada.

Exemplo:
Se o log indicar erro na linha 166, você deve analisar a linha 167 do arquivo.

Materiais de apoio

Artigo relacionado: Importando uma base no app Dito

Neste artigo, você aprendeu como funcionam as validações dos identificadores, os status da importação e como interpretar os erros gerados no log. Agora você pode preparar suas bases com segurança, garantindo que os dados sejam processados corretamente. 

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs) 

Gostou, mas acha que algo pode melhorar?

Sua opinião é muito importante para nós! Se você tem alguma sugestão ou sentiu falta de algo neste módulo, queremos ouvir você.

Compartilhe suas ideias diretamente com nosso time de Produto através do link abaixo.

➡️ Acesse aqui o Portal de Ideias

FAQ– Perguntas Frequentes sobre Validando erros na importação de base

1. Por que algumas linhas da minha base não foram importadas?

R:Linhas que apresentam erros de validação (como e-mail fora do padrão, CPF/CNPJ com tamanho incorreto ou telefone inválido) são rejeitadas. Apenas linhas válidas seguem para importação.

2. Onde posso ver quais erros aconteceram na minha importação?

R:Na tela de Importações, clique no status “Parcialmente Concluído” ou “Inválido” para baixar o arquivo de log contendo o erro por linha e coluna.

3. Por que preciso desconsiderar a primeira linha do arquivo de log?

R:Porque ela é o cabeçalho. Assim, se o log apontar erro na linha 166, você deve analisar a linha 167 da sua base original.

4. IDs repetidos são permitidos?

R:Não. O sistema bloqueia a importação se o ID aparecer mais de uma vez, pois cada identificador deve ser único.