> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.
# criar clientes via planilha
a importação em massa cobre três planilhas: a principal, que cria e atualiza clientes, e as de endereços e de contatos, que gerenciam essas listas em clientes já cadastrados.
| planilha | o que faz |
| - | - |
| clientes | cria clientes novos e atualiza os existentes, com o endereço principal e o representante principal na mesma linha |
| associar endereços a clientes | gerencia todos os endereços de um cliente já cadastrado, uma linha por endereço |
| associar contatos a clientes | gerencia todos os contatos de um cliente já cadastrado, uma linha por contato |
marca com integração de clientes ativa não baixa os modelos de endereços e de contatos.
## importar
acesse **configurações** → **importações de arquivo** → botão de ação → **baixar modelo** e escolha a planilha.
para trabalhar sobre os dados atuais, use a exportação da planilha em vez do modelo em branco. o arquivo baixa preenchido com o que já está cadastrado.
o modelo traz uma aba de instruções e uma linha de exemplo. as colunas de código da teceo servem de referência e não são editadas.
campos personalizados da marca entram como colunas ao final da planilha de clientes, com a instrução de formato no cabeçalho.
em **importações de arquivo**, clique em **importar arquivo**, escolha o tipo e envie a planilha em xlsx.
a tela de detalhe mostra a barra de progresso e lista as linhas com erro, com o nome da coluna e a mensagem.
linha com erro não impede o processamento das demais. o relatório de erros existe apenas em tela.
abra cada cliente e configure o que ficou de fora: classificações, arquivos e demais endereços ou contatos.
## planilha de clientes
a coluna **código teceo do cliente** decide o comportamento da linha: em branco cria um cliente novo, preenchida atualiza o cliente daquele código.
| coluna | o que preencher | obrigatória |
| - | - | - |
| código teceo do cliente | referência, não editar. em branco cria cliente novo | não |
| localização | o país da loja. editável apenas em rascunho | sim |
| tipo do documento | CNPJ, CPF, TAX\_ID, NIF, passaporte ou outros. editável apenas em rascunho | sim |
| nº do documento | o número do documento. não editável fora de rascunho | com localização BR e tipo CPF ou CNPJ |
| código ERP | o código no sistema de gestão. não preencher em marca com integração de clientes | não |
| nome da loja | o nome que identifica o cliente | sim |
| razão social | a razão social da loja | fora de rascunho |
| inscrição estadual | a inscrição estadual da loja | não |
| código SUFRAMA | a inscrição na Zona Franca de Manaus | não |
| e-mail principal | o endereço que recebe as comunicações da marca | fora de rascunho |
| código do país do telefone | de 1 a 3 dígitos | com telefone preenchido |
| telefone principal | o telefone da loja | fora de rascunho |
| código do país do WhatsApp | de 1 a 3 dígitos | com whatsapp preenchido |
| WhatsApp | o whatsapp da loja | não |
| canal digital | o perfil digital da loja | não |
| observações | texto livre | não |
| classificações de cliente | no formato código do tipo, dois-pontos e código da classificação. múltiplas separadas por vírgula | não |
| status do cadastro | rascunho, pendente, ativo, inativo ou bloqueado | sim |
| agendar conexão | sim ou não. em branco assume não | não |
| código teceo do endereço principal | referência, não editar. em branco cria endereço novo | não |
| código (endereço principal) | o código externo do endereço | não |
| CEP do endereço principal | 8 dígitos com localização BR | com qualquer coluna de endereço preenchida |
| endereço principal | o logradouro | com o CEP preenchido |
| número do endereço principal | o número | com CEP preenchido e localização BR |
| complemento do endereço principal | o complemento | não |
| bairro do endereço principal | o bairro | com CEP preenchido e localização BR |
| cidade do endereço principal | a cidade | com o CEP preenchido |
| estado do endereço principal | a sigla de 2 letras | com CEP preenchido e localização BR |
| país do endereço principal | o país | com o CEP preenchido |
| tipo do endereço principal | entrega, comercial ou cobrança. em branco assume entrega | não |
| código do representante principal | o código de um representante já cadastrado | não |
| nome do representante principal | referência, preenchido a partir do código | não |
| código de outros representantes | códigos separados por vírgula, sem repetição | não |
| grupo do cliente | um grupo já cadastrado | não |
| tabela de preço do grupo | sim ou não | não |
| código da tabela de preço | em branco assume a tabela principal | não |
**agendar conexão** não dispara convite na importação. a coluna registra o cliente para conexão automática, que acontece quando aquele cliente se cadastra pelo link personalizado da marca.
## planilha de endereços
a planilha vale como a lista completa de endereços de cada cliente. importar apaga os endereços atuais e grava o que está no arquivo: endereço ausente é endereço que sai do cadastro.
para incluir um endereço sem perder os demais, use o arquivo exportado com os dados atuais como base.
| coluna | o que preencher | obrigatória |
| - | - | - |
| código teceo de cliente | referência, não editar. o cliente precisa existir | sim |
| localização | referência. igual em todas as linhas do mesmo cliente e igual à do cadastro | sim |
| nome da loja | referência, não editar | não |
| razão social | referência, não editar | não |
| código teceo de endereço | referência, não editar. em branco cria endereço novo | não |
| código do endereço | o código externo. não preencher em marca com integração de clientes | não |
| CEP | 8 dígitos com localização BR | sim |
| logradouro | o logradouro | sim |
| número | o número | com localização BR |
| complemento | o complemento | não |
| bairro | o bairro | sim |
| cidade | a cidade | sim |
| estado | a sigla do estado | com localização BR |
| país | o código de 2 caracteres | sim |
| tipo de endereço | entrega, comercial ou cobrança. em branco assume entrega | não |
| endereço principal | sim ou não. exatamente um por cliente | sim |
linha com todas as colunas de dado em branco é ignorada, e não funciona como comando de exclusão.
## planilha de contatos
a planilha vale como a lista completa de contatos de cada cliente. importar apaga os contatos atuais e grava o que está no arquivo.
| coluna | o que preencher | obrigatória |
| - | - | - |
| código teceo de cliente | referência, não editar. o cliente precisa existir | sim |
| nome da loja | referência, não editar | não |
| razão social da loja | referência, não editar | não |
| código teceo de contato | referência, não editar. em branco cria contato novo | não |
| nome do contato | o nome | sim |
| sobrenome do contato | o sobrenome | não |
| e-mail do contato | único entre as linhas do mesmo arquivo | não |
| código internacional do país | de 1 a 3 dígitos | com telefone preenchido |
| telefone do contato | único entre as linhas do mesmo arquivo | com o código do país preenchido |
| função do contato | proprietário, diretor, gerente, supervisor ou comprador | não |
e-mail, telefone ou código de contato repetidos no mesmo arquivo reprovam as linhas antes da gravação.
## o que a planilha exige em cada status
a obrigatoriedade da planilha soma três camadas: o formato da coluna, os campos exigidos pelo status de destino e as regras próprias da marca. a linha reprova se qualquer uma delas falhar.
## conteúdos relacionados
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.