# Importação de Contatos

O recurso de importação facilita o cadastro de novos registros através de arquivos no formato **.csv**. Este formato é o padrão de exportação da maioria dos sistemas de mercado, permitindo uma migração eficiente de dados.

## Como Realizar a Importação

Para iniciar o processo de envio de arquivos para o sistema, siga os passos abaixo:


1. Acesse o menu **Contatos**.
2. Clique no ícone de **três pontos** e selecione a opção **Importar**.
3. Na página de importação, pode optar por **Baixar Exemplo** para alinhar os seus dados ao modelo do sistema ou carregar o seu ficheiro pessoal.
4. Clique em **Procurar**, selecione o arquivo CSV (com codificação **UTF-8**) e clique em **Abrir**.
5. **Mapeamento:** Relacione cada coluna do seu arquivo com o campo correspondente dentro do sistema.
6. Clique em **Importar**. O processo será executado em segundo plano e, caso existam falhas, o sistema exibirá uma página indicando exatamente a linha e o erro encontrado.

## Regras e Campos Obrigatórios

Para que o sistema processe o arquivo corretamente, certas colunas devem ser preenchidas obrigatoriamente, dependendo do tipo de contato:

* **Contato do tipo Empresa:** É obrigatório informar **Empresa/Nome Fantasia**, **País** e **Tipo**.
* **Contato do tipo Pessoa:** É obrigatório informar **Nome/Razão Social**, **Empresa/Nome Fantasia**, **País** e **Tipo**.
* **Dependência:** Para cadastrar uma Pessoa, é obrigatório que o contato do tipo Empresa ao qual ela pertence já exista ou esteja sendo criado no mesmo arquivo.

## Organização do Layout de Dados

Durante a preparação do seu arquivo, considere as seguintes regras de preenchimento para garantir a qualidade da base:

* **Razão Social (Empresa):** Caso seja importado uma empresa com "Nome/Razão Social" igual a uma já cadastrada no sistema, o registro deverá apenas atualizar as informações.
* **Nome (Pessoa):** O sistema permite que sejam cadastrados pessoas com o mesmo nome e informações mais de 1 vez. 


* **Tipo e Fase:** Informe se o registro é Pessoa ou Empresa e defina a fase entre Lead, Prospect ou Cliente.
* **Inteligência de Cadastro:** Se informar uma **Situação**, **Origem**, **Ramo de Atividade** ou **Região** que ainda não existe no sistema, o Procedo irá criá-las automaticamente durante a importação.
* **Responsável:** Utilize o e-mail de um usuário já cadastrado no sistema para atribuir o contato a ele. Se o campo estiver vazio, os contatos serão atribuídos a quem realizou a importação.
* **Endereço e Localização:** 
  * Utilize siglas para o campo **UF** (Estado). 
    * Se o valor da linha para **UF** tiver algum caracter especial ( - , / ) um erro será gerado informando o usuário a necessária correção.
  * Na coluna **Cidade**, caso a linha possua um caracter especial ( - ) será atribuído a primeira cidade do sistema que tiver o -. 
  * A coluna **País** deve ser criada obrigatoriamente para todos os registros. 
    * Se o valor da linha para coluna **País** estiver em branco, automaticamente o país atribuído será **Brasil**.

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)