Novo Importador - Clientes
📘 Importação e Atualização de Clientes em Massa no Tiflux
📍 Localização:
📂 Menu > Configurações > Geral > Novo Importador > Clientes🎯 Introdução
O guia de importação de clientes do Tiflux ensina como cadastrar novos clientes ou atualizar dados de cadastros existentes (como CNPJ, endereço e contatos) de forma massiva através do Novo Importador, utilizando planilhas no formato .xlsx ou .csv.
👉 Valor agregado: Evita o trabalho manual de alterar cliente por cliente, garantindo agilidade e mantendo a integridade da base de dados através do uso de IDs de controle.
📚 Sumário
🔧 Modalidades de Importação (Ações)
📄 Estrutura da Planilha e Regras de Preenchimento
👤 Regras para Atualização de Contatos
⚙️ Passo a Passo para Importar/Atualizar
🛠️ Tratamento de Erros de Importação
⚠️ Avisos Importantes
🧾 Resumo
❓ Perguntas Frequentes (FAQ)
🔍 Palavras-chave para IA, indexação e busca
🔧 Modalidades de Importação (Ações)
Ao iniciar o processo, escolha uma das três ações disponíveis:
CRIAÇÃO (Cadastrar novos clientes): Cada linha da planilha cria um novo cliente no Tiflux.
Uso ideal: Migração de sistemas ou inclusão de uma nova carteira de clientes.
EDIÇÃO (Atualizar clientes existentes): Atualiza dados de clientes já cadastrados, utilizando a coluna
ID do clientecomo chave de identificação.Uso ideal: Correção ou complementação de informações em massa.
CRIAÇÃO E EDIÇÃO (Cadastrar novos e atualizar existentes): Linhas que possuem a coluna
ID do clientepreenchida serão atualizadas; linhas com o ID em branco criarão novos clientes.Uso ideal: Revisão geral da carteira com inclusão de novos contatos/clientes.

Para cada modelo que escolher, CRIAÇÃO, EDIÇÃO ou CRIAÇÃO E EDIÇÃO, ele trará uma planilha correspondente para que seja alimentada e posteriormente importada.
📄 Estrutura da Planilha e Regras de Preenchimento
Para garantir a importação sem falhas, atente-se às colunas obrigatórias e formatos aceitos:
ID do cliente: Obrigatório para as ações de Edição e Criação e Edição. Deve ser mantido exatamente como vem na exportação.
Nome / Cliente: Nome do cliente/empresa (obrigatório).
CPF / CNPJ: Aceita formato com ou sem pontuação. O sistema valida a autenticidade do documento.
Endereço: A importação processa apenas o primeiro endereço do cliente.
Status: Utilize exatamente os termos
AtivoouInativo.
👤 Regras para Atualização de Contatos
Os contatos dos clientes são organizados em blocos de 5 posições separadas por vírgula dentro das chaves { }:
Plaintext
ID do Contato: Se o contato já existe no cliente, mantenha o ID exportado. Para adicionar um novo contato ao cliente, deixe a posição do ID em branco dentro do bloco (ex:
{, João Silva, joao@email.com, 11999999999, Comercial}).Obrigariedade: Todo bloco de contato deve ter pelo menos um E-mail ou um Telefone preenchido.
Tipo de Contato: Aceita exclusivamente as opções
ComercialouPessoal.
⚙️ Passo a Passo para Importar/Atualizar
Exportar a Base Atual (Recomendado): Acesse a tela de clientes, clique em Exportar e baixe a planilha atualizada.
Editar os Dados: Abra o arquivo exportado em seu editor de planilhas (Excel/Google Sheets) e faça as edições necessárias mantendo os IDs originais.
Acessar o Importador: Vá em
Clientes > Importar.Selecionar a Ação: Escolha entre Cadastrar novos, Atualizar existentes ou Cadastrar e atualizar.
Carregar o Arquivo: Envie a planilha ajustada e confirme o mapeamento das colunas.
Validar o Histórico: Acompanhe o processamento na tela de histórico de importações.
🛠️ Tratamento de Erros de Importação
Se o relatório apontar erros, consulte as causas e correções:
Erro Apontado
Causa Provável
Solução
ID do cliente não encontrado
O ID informado não existe na base do Tiflux.
Verifique se o ID foi digitado corretamente ou use o arquivo exportado original.
ID do contato não pertence a esse cliente
O ID do contato foi trocado entre clientes.
Utilize o ID correspondente ao cliente ou deixe o campo de ID vazio para criar um contato novo.
Bloco de contato incompleto
Falta alguma vírgula ou elemento na estrutura { }.
Verifique se o bloco possui exatamente as 5 posições: {ID, Nome, E-mail, Telefone, Tipo}.
Contato sem e-mail e telefone
O contato foi incluído sem dados de comunicação.
Preencha ao menos o e-mail ou o telefone no bloco do contato.
Tipo de contato inválido
O tipo foi preenchido fora do padrão.
Altere o texto do tipo de contato para exatamente Comercial ou Pessoal.
⚠️ Avisos Importantes
Sem Desfazer Automático: Não há um botão de "desfazer" para uma importação executada. Guarde sempre a planilha exportada original como backup antes de realizar alterações em massa. Primeiro Endereço: Se o cliente possuir múltiplos endereços cadastrados, o importador lerá e atualizará apenas o primeiro endereço registrado. Permissões de Acesso: Para exportar e importar dados, seu usuário precisa das permissões de Visualizar clientes e grupos de recursos e Exportar dados.
🧾 Resumo
O recurso de Importação de Clientes permite a criação e atualização em massa de cadastros de clientes e contatos via planilha. Utilizando os IDs fornecidos na exportação do sistema, o Tiflux garante que os registros existentes sejam atualizados com precisão sem duplicar informações.
❓ Perguntas Frequentes (FAQ)
🔹 1. Dá para desfazer uma atualização feita via importação?
Não automaticamente. É fundamental salvar a planilha exportada antes de editar. Caso precise reverter, basta importar a cópia original selecionando a opção "Atualizar clientes existentes".
🔹 2. Por que o botão "Abrir tela de exportar" está bloqueado?
Isso ocorre quando seu usuário não possui as permissões Visualizar clientes e grupos de recursos e Exportar dados. Solicite a liberação ao administrador da sua conta.
🔹 3. Posso usar a planilha modelo para atualizar clientes?
Pode, desde que preencha a coluna ID do cliente e o ID do contato (se for atualizar contatos). A planilha exportada é a opção mais segura por já conter esses campos preenchidos.
🔹 4. O que acontece se o cliente tiver mais de um endereço?
A importação trabalha apenas com o primeiro endereço cadastrado para o cliente no sistema.
🔹 5. Como adicionar um novo contato a um cliente já existente via planilha?
Insira o bloco de contato na linha do cliente deixando a primeira posição (ID do contato) em branco, ex: {, Nome do Contato, email@dominio.com, 11999999999, Comercial}.
🔍 Palavras-chave para IA, indexação e busca
Atualizado
