> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/importar-dados-de-clientes.md).

# Importar clientes por planilha

Importar clientes por planilha Excel: cadastre a carteira de uma vez ou exporte, corrija e reimporte para atualizar dados e ativar ou desativar clientes.

Importar clientes por planilha cadastra de uma vez a carteira que hoje está no seu ERP ou em uma planilha. A mesma planilha serve para manter o cadastro: você exporta os clientes, corrige as células e reimporta, sem abrir cliente por cliente. É o caminho mais rápido para quem tem centenas de clientes, como uma distribuidora ou uma indústria com muitas revendas.

## Antes de começar

* Seu usuário precisa ver o menu **Configurações** (permissão de administração da conta).
* O arquivo é Excel (**.xls** ou **.xlsx**) e a aba deve se chamar **Clientes**. Parta sempre do modelo da Uplaces e não mude a ordem das colunas: a importação lê pela posição.
* Cada importação aceita um número limitado de linhas. Passando do limite, o sistema recusa o arquivo e pede para dividir em arquivos menores.
* O limite de clientes do plano vale para cliente **novo**. Planilha que só atualiza ou desativa clientes não é barrada por ele.

## Como importar

1. Abra **Configurações › Importar dados**.
2. Na seção **Importar clientes**, clique em **Download do modelo para importação**.
3. Preencha uma linha por cliente, usando as colunas do modelo.
4. Escolha o arquivo e clique em **Importar**.

As colunas do modelo:

| Coluna                       | Para que serve                                                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ID Externo (obrigatório)`   | o código do cliente no seu ERP                                                                                                                               |
| `Razão Social (obrigatório)` | nome da empresa                                                                                                                                              |
| `Nome fantasia`              | nome pelo qual o cliente é conhecido                                                                                                                         |
| `CNPJ/CPF (obrigatório)`     | documento do cliente, com ou sem pontuação                                                                                                                   |
| `Email contato`              | e-mail de acesso do cliente à loja; com mais de um (separados por vírgula ou ponto e vírgula), o primeiro é o de acesso e os demais viram **Outros e-mails** |
| `Nome contato`               | nome do responsável                                                                                                                                          |
| `Telefone contato`           | telefone do responsável                                                                                                                                      |
| `Segmento`                   | ramo do cliente, para recomendação ([segmentação](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/segmentacao-dos-clientes.md))                          |
| `Tags (Separadas por ,)`     | etiquetas do cliente, separadas por vírgula                                                                                                                  |
| `Nome do vendedor`           | vendedor responsável pela carteira                                                                                                                           |
| `Email do vendedor`          | e-mail do vendedor                                                                                                                                           |
| `Endereço (obrigatório)`     | endereço de entrega                                                                                                                                          |
| `Endereço 2`                 | endereço adicional                                                                                                                                           |

## Como atualizar clientes que já existem

1. Em **Clientes › Todos os clientes**, filtre o que quer corrigir e clique em **Exportar**. A planilha sai com colunas extras, entre elas `Ativo`.
2. Edite as células. Na coluna `Ativo`, use **S** ou **N** para ativar ou desativar o cliente.
3. Reimporte em **Configurações › Importar dados › Importar clientes**.

O sistema trata cada linha assim:

* O cliente é identificado pelo **e-mail**. Mesmo e-mail com outro CNPJ entra como outra empresa do mesmo cliente (filial), sem abrir cliente novo. Veja [filiais e outros CNPJ](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/empresas-adicionais-no-cadastro-de-clientes.md).
* Célula vazia **não apaga** o dado que já está no cadastro, e linha igual ao cadastro não grava nada.
* A planilha inteira é conferida antes da primeira gravação: um CNPJ/CPF inválido ou um valor diferente de S ou N na coluna `Ativo` recusa o arquivo e mostra as linhas com problema. Nenhuma linha é importada até você corrigir.
* Linha sem CNPJ/CPF é ignorada e contada na mensagem final.
* Em linhas de filial, o status `Ativo` vale pela linha do CNPJ principal.
* Cliente sem e-mail recebe o e-mail temporário `cliente@definir-email.com`. Ele não consegue entrar na loja até você cadastrar o e-mail real.

## Resultado

Ao terminar, a tela mostra quantas linhas foram processadas, quantas foram recusadas pelo limite do plano e o resumo de ativados, desativados e sem alteração. Os clientes aparecem em **Clientes › Todos os clientes**.

## Problemas comuns

<details>

<summary>Arquivo inválido: dados de clientes não encontrados</summary>

A aba da planilha não se chama **Clientes**. Baixe o modelo de novo e use a aba que ele traz.

</details>

<details>

<summary>Importação recusada por quantidade de registros</summary>

O arquivo passou do limite de linhas por importação. Divida em partes menores e importe uma de cada vez.

</details>

<details>

<summary>Clientes novos recusados</summary>

A conta atingiu o limite de clientes do plano atual. Planilhas que só atualizam ou desativam clientes continuam funcionando.

</details>

<details>

<summary>O sistema recusou a planilha inteira por causa de uma linha</summary>

É a conferência antes da gravação: um CNPJ/CPF inválido ou um valor diferente de S ou N em `Ativo` barra o arquivo todo. Corrija as linhas listadas na mensagem e envie de novo.

</details>

<details>

<summary>Cliente importado sem acesso à loja</summary>

Ele ficou sem e-mail e recebeu o endereço temporário. Cadastre o e-mail real no cadastro do cliente (veja [cadastro de clientes](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/cadastro-importacao.md)).

{% hint style="info" %}
Para trazer também o histórico de compras de cada cliente, use a seção **Importar histórico de compras**, na mesma tela. Ele alimenta a lista "Produtos que você costuma comprar" que o comprador vê na loja.
{% endhint %}

</details>

## Perguntas frequentes

<details>

<summary>Posso importar clientes de uma planilha do Excel?</summary>

Pode. Baixe o modelo em **Configurações › Importar dados**, preencha e envie. Aceita arquivos .xls e .xlsx.

</details>

<details>

<summary>Como atualizar vários clientes de uma vez?</summary>

Exporte a lista em **Clientes › Todos os clientes**, corrija as células e reimporte a mesma planilha. Células vazias não apagam dados.

</details>

<details>

<summary>Como desativar clientes em massa?</summary>

Exporte, preencha `N` na coluna `Ativo` dos clientes que quer desativar e reimporte.

</details>

<details>

<summary>A importação envia convite para os clientes?</summary>

Não. Ela só cadastra. O convite de acesso é um passo à parte, em [convidar seus clientes](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/divulgar.md).

</details>

## Veja também

* [Cadastro de clientes](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/cadastro-importacao.md)
* [Filiais e outros CNPJ no cadastro](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/empresas-adicionais-no-cadastro-de-clientes.md)
* [Histórico de produtos no cadastro de clientes](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/historico-de-produtos-no-cadastro-de-clientes.md)
* Quem usa ERP: [integrações](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md) trazem os clientes sem planilha
