Pular para o conteúdo
Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  1. 🔧 Modalidades de Importação (Ações)

  2. 📄 Estrutura da Planilha e Regras de Preenchimento

  3. 👤 Regras para Atualização de Contatos

  4. ⚙️ Passo a Passo para Importar/Atualizar

  5. 🛠️ Tratamento de Erros de Importação

  6. ⚠️ Avisos Importantes

  7. 🧾 Resumo

  8. ❓ Perguntas Frequentes (FAQ)

  9. 🔍 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 cliente como 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 cliente preenchida 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 Ativo ou Inativo.


👤 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 Comercial ou Pessoal.


⚙️ Passo a Passo para Importar/Atualizar

  1. Exportar a Base Atual (Recomendado): Acesse a tela de clientes, clique em Exportar e baixe a planilha atualizada.

  2. 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.

  3. Acessar o Importador: Vá em Clientes > Importar.

  4. Selecionar a Ação: Escolha entre Cadastrar novos, Atualizar existentes ou Cadastrar e atualizar.

  5. Carregar o Arquivo: Envie a planilha ajustada e confirme o mapeamento das colunas.

  6. 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