> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/configuracoes/novo-importador/novo-importador-clientes.md).

# 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.<br>

***

### 📚 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<br>

***

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

Ao iniciar o processo, escolha uma das três ações disponíveis:<br>

* 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.<br>
* 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.<br>
* 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.

  <br>

  <figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FK65tZsEhUitTz7mu1SWF%2Fimage.png?alt=media&amp;token=8cbb6fc3-b2c1-43a2-84fe-ff8a6bf02e78" alt=""><figcaption></figcaption></figure>

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:<br>

* 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, Nome, E-mail, Telefone, Tipo}
```

* 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}`).<br>
* Obrigariedade: Todo bloco de contato deve ter pelo menos um E-mail ou um Telefone preenchido.<br>
* Tipo de Contato: Aceita exclusivamente as opções `Comercial` ou `Pessoal`.<br>

***

### ⚙️ 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.<br>

***

### 🛠️ 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*.<br>

### 🧾 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.<br>

***

### ❓ 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

```
importacao de clientes tiflux
atualizar clientes em massa
id do cliente importacao
bloco de contatos planilha tiflux
erro importacao clientes tiflux
novo importador tiflux
```
