Neste artigo você encontrará o guia completo sobre como realizar a Importação de Vendedores via CSV no App Dito. Você aprenderá o passo a passo da importação, a estrutura obrigatória do arquivo, as regras críticas de validação (Full Load) e como o sistema gerencia a criação/atualização de vendedores e lojas de forma massiva e segura, garantindo a consistência da sua base de dados.
O que é e Para que serve?
A importação via CSV permite que a marca envie os dados de todos os vendedores de uma só vez, reduzindo o esforço operacional e mantendo o cadastro atualizado com segurança.
A importação substitui operações manuais repetitivas e garante que a base de vendedores fique consistente, atualizada e alinhada ao comportamento de compras enviado pela marca.
Para quem é este artigo?
Nível de Acesso:Administrador, Administrador de Dados, Editor.
ÍNDICE
- Onde acessar a importação?
Instruções de navegação para a seção de importação - Como realizar uma nova importação?
Passo a passo para envio do arquivo e bloqueio durante o processamento - Estrutura obrigatória do arquivo CSV
Regras de formato, tamanho, cabeçalho e as colunas obrigatórias - Validando a estrutura do arquivo
Confira se todo o arquivo foi configurado corretamente - Validando o conteúdo do arquivo
Critérios de validação individual por campo (Código, CPF, Cargo, etc.)
- Regras de processamento (FULL LOAD)
O conceito de substituição total da base e as regras de atualização de status e criação de lojas - Multilojas via CSV
Como gerenciar vendedores multiloja - Cenário de concatenação (COD_LOJA:COD_VEND)
Regras para marcas que usam código concatenado - Logs e acompanhamento da Lista de Importações
Como a lista de importações exibe o status e como baixar o log de erros - Materiais de Apoio
- FAQ – Perguntas Frequentes
Onde acessar a importação?
No menu lateral do App.Dito, acesse:
Configurações
Lojas → Lista de vendedores → Lista de importações:
Como realizar uma nova importação?
Passo 1- Na aba Lista de Importações, clique em Importar CSV:
Passo 2 - Envie o arquivo (clique ou arraste para a caixa) e aguarde a validação da estrutura.
Se o arquivo for válido, clique em Continuar para iniciar o processamento. Se o arquivo tiver erros de estrutura (ex.: cabeçalho errado), o sistema exibirá um alerta imediatamente.
Regra importante: não é possível iniciar uma nova importação enquanto outra está em processamento
Se o status atual for “Processando” o sistema bloqueia a criação de uma nova importação.
Isso evita duplicações e inconsistência de dados.
Estrutura obrigatória do arquivo CSV
Para garantir o sucesso da importação, é necessário seguir formato obrigatório do arquivo e suas configurações. São eles:
Formato: CSV UTF-8, delimitado por vírgula (,)
Tamanho máximo: 10 MB
Máximo: 50.000 linhas
Baixe o arquivo modelo (estrutura correta): modelo CSV
Ordem obrigatória do cabeçalho
Importante: O nome das colunas precisa seguir essa nomenclatura exata e a ordem precisa ser respeitada.
Validando a estrutura do arquivo
Antes de iniciar o processamento, o sistema valida:
formato do arquivo (precisa ser CSV)
tamanho (≤ 10MB)
delimitador (vírgula)
cabeçalho completo e na ordem correta
arquivo não pode estar vazio
Se houver erro nessa fase, a importação não avança e nenhum dado é alterado.
Validando o conteúdo do arquivo
Nessa etapa, cada linha é validada individualmente, tendo como principais as seguintes regras:
1- Código do vendedor
- Não pode estar vazio
- Até 50 caracteres
- Não pode existir mais de uma linha com mesmo codigo_vendedor + codigo_loja
2 - Nome
- Obrigatório
- Máx. 150 caracteres
3 - CPF
- Obrigatório
- Necessário os 11 dígitos
4 - Cargo
- Obrigatório
- VENDEDOR ou GERENTE
- Um vendedor deve ter um único cargo, mesmo atuando em várias lojas
5- Código da loja
- Obrigatório
- Máx. 50 caracteres
- Cria uma nova loja e não existir
- Atualiza o nome da loja se for diferente do cadastrado
6- Nome da loja
- Obrigatório
- Máx. 150 caracteres
7 - Status
- ATIVO ou INATIVO
- Normalizado para UPPERCASE
Regras de processamento (FULL LOAD)
Toda importação substitui o estado atual da base, então a importação é total, não incremental. Na prática, isso significa:
1. Todos os vendedores ativos devem estar no arquivo
Incluindo ativos e ausentes.
2. Vendedores que não estão no arquivo serão atualizados para INATIVO
Independente do status anterior.
3. Criação de vendedores
Se codigo_vendedor não existir → cria um novo vendedor.
4. Atualização de vendedores
Se codigo_vendedor já existir → atualiza:
- nome
- CPF
- cargo
- lista de lojas
- status por loja
5. Criação de lojas
Se codigo_loja não existir → cria automaticamente a loja com nome e código enviados.
6. Atualização de lojas
Se a loja existir e o nome enviado for diferente → atualiza o nome.
7. A importação só é aplicada se todas as linhas forem válidas
Se houver 1 linha inválida:
❌ Nenhum vendedor é criado
❌ Nenhum vendedor é atualizado
❌ Nenhuma loja é alterada
❌ O arquivo é completamente rejeitado
Status final: INVÁLIDO
8. Os dados só são alterados quando o status é CONCLUÍDO
Somente o status CONCLUÍDO aplica as alterações.
Multilojas via CSV
O CSV permite cadastrar vendedores multilojas, então, um mesmo codigo_vendedor pode aparecer em várias linhas, cada uma com uma loja diferente.
Regras para o Multilojas:
- cargo deve ser o mesmo para todas as lojas
- cada linha representa um vínculo loja ↔ vendedor
- o status é controlado por linha
Cenário de concatenação (COD_LOJA:COD_VEND)
Para marcas que usam concatenação, é importante lembrar:
o codigo_vendedor deve ser exatamente o código concatenado enviado nos eventos
o vendedor só pode aparecer com uma loja
multilojas não é permitido
para atender outra loja, deve existir outro código concatenado → outro cadastro
Logs e acompanhamento da Lista de Importações
Após enviar um arquivo, um registro é criado automaticamente na lista:
A lista exibe:
nome do arquivo
usuário que importou
data
status
quantidade de linhas com erro
quantidade total de linhas
botão para baixar log de erros (quando Inválido)
Arquivo de Log (CSV de erros)
Disponível apenas quando o status é Inválido. O arquivo contém:
número da linha com problema
todas as colunas originais do CSV
mensagem de erro na coluna com conteúdo inválido
Obs: Linhas válidas não aparecem no log
Materiais de Apoio
- Artigo: Como fazer a consulta de lojas na Gestão de Lojas em tela?
- Artigo: Como fazer a consulta de vendedores no App.Dito?
- Artigo: Como fazer a gestão de lojas pelo App.Dito?
Você dominou o processo de importação massiva de vendedores via CSV, compreendendo que este método é Full Load e que a rejeição total do arquivo ocorre caso haja qualquer inconsistência. Ao seguir a estrutura obrigatória, as regras de validação individual e as diretrizes para vendedores multiloja, você garante que a base de vendedores seja atualizada de forma segura, mantendo a integridade do cadastro e a precisão da distribuição de contatos no Dito Agenda.
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
1- Se eu remover um vendedor que está Inativo do meu arquivo CSV, ele continua Inativo na base da Dito?
Não. Como o processamento é Full Load (substituição total), se um vendedor não está presente no arquivo CSV enviado, ele será atualizado para INATIVO na base da Dito, mesmo que já estivesse Inativo anteriormente. É crucial manter os vendedores ATIVOS e AUSENTES (se geridos no CSV) no seu arquivo.
2 - Se o meu arquivo tem 10.000 linhas e 1 linha está com o CPF incorreto, qual é o resultado final da importação?
O resultado final será INVÁLIDO. O sistema rejeitará completamente o arquivo, e nenhuma das 10.000 linhas será processada ou aplicada à base. Para corrigir, você deve baixar o Log de Erros, corrigir a linha com CPF incorreto no CSV original e reenviar o arquivo completo.
3 - Qual é a ordem de importância para o sistema Dito no que diz respeito à identificação de um vendedor multiloja?
A identificação é feita pela combinação única de codigo_vendedor + codigo_loja. Um vendedor multiloja é reconhecido como o mesmo indivíduo em diferentes vínculos, mas cada linha da importação define a associação e o status daquele vendedor naquela loja específica.
4 - O que o sistema faz se eu enviar um CSV com uma loja que ainda não existe na base da Dito?
O sistema irá criar automaticamente a nova loja, utilizando o codigo_loja e o nome_da_loja informados na linha do CSV. Isso garante que o vendedor seja associado à unidade correta, mesmo que o cadastro da loja seja recente.
5 - Se eu enviar um vendedor multiloja, mas com cargos diferentes para cada loja (Ex: Vendedor na Loja A e Gerente na Loja B), o que acontecerá?
O sistema rejeitará o arquivo. A regra de validação do conteúdo exige que um vendedor mantenha um único cargo (VENDEDOR ou GERENTE) em todos os seus vínculos com as lojas, independentemente da configuração da filial.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo