> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://hoopdecor.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Importação de Especificadores/Arquitetos no HoopCRM

O HoopCRM permite a importação de dados de especificadores, facilitando a inclusão de grandes volumes de informações de forma rápida e eficiente.

Neste artigo, você verá:
* [Configurações de Importação](#3-configuracoes-de-importacao)
* [Campos e Validações](#3-campos-e-validacoes)
* [Como importar](#3-como-importar)
* [Regras de Duplicidade e ID](#3-regras-de-duplicidade-e-id)

### Configurações de Importação
No menu lateral esquerdo, passe o mouse sobre a aba **Importação de Dados** → **Especificadores**.
![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot9_18a7xf2.png =231xauto)

* Na tela que abrir, você verá a estrutura da tabela aceita pelo sistema.
Antes de importar seus especificadores, é importante verificar a configuração que controla o comportamento ao encontrar duplicatas.
**Onde acessar:**
* Procure pela seção **"Configurações"** no topo da página.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek3_1mz257p.gif =1017xauto)

###### Chave "Editar especificadores com e-mail ou telefone iguais"
Esta opção controla como o sistema se comporta quando encontra um especificador já existente com o mesmo e-mail ou telefone:
* **Ativada (ligada)** ✅: O sistema irá **editar e atualizar** o especificadores existente com os novos dados da importação.
* **Desativada (desligada)** ❌: O sistema irá **bloquear a linha** com erro de duplicidade.
> 💡 **Dica importante**: Se você está importando uma atualização de especificadores já existentes, certifique-se de que esta opção está **ligada**. Caso contrário, todas as linhas com e-mail ou telefone repetido serão rejeitadas.

### Campos e Validações
###### Campos Obrigatórios
Para que a importação seja bem-sucedida, **estes campos são imprescindíveis**:
**Nome**
* Identificação do especificador.
* Não pode estar vazio.
**Tipo**
* Apenas dois valores aceitos: **PF** (Pessoa Física) ou **PJ** (Pessoa Jurídica)
* Qualquer outro valor bloqueará a linha.
**E-mail ou Telefone** (pelo menos um dos dois)
* É obrigatório preencher **no mínimo um** desses campos.
* Se ambos estiverem vazios, a linha falhará com o erro: *"Campo email ou telefone deve ser preenchido".*

###### Campos Opcionais
Você pode preencher também:
* **ID**
* **E-mail**
* **CPF/CNPJ**
* **Data de Nascimento**
* **Telefone**
* **Endereço** (logradouro, número, complemento, bairro, cidade, estado, CEP)
* **Número**
* **Complemento**
* **Bairro**
* **Cidade**
* **Estado (Sigla)**
* **CEP**
* **Categoria**
* **RT**
* **Responsável**
* **CPF/CNPJ escritório**
* **Nome Escritório**
* **Email Escritório**
* **Telefone escritório**
* **Cargo**
Cada um desses campos tem regras de validação específicas:
**E-mail**
* Formato obrigatório: [__usuario@dominio.com__](mailto:usuario@dominio.com)
* Exemplo válido: [__jefferson@hoopcompany.com__](mailto:jefferson@hoopcompany.com)
**CPF/CNPJ**
* Apenas números, pontos e hífens.
* Exemplos válidos: `123.456.789-10` ou `12345678000190`
**Telefone**
* Números, hífen, parênteses, pontos e espaços.
* Exemplos válidos: `(11) 98765-4321` ou `11 9 8765 4321`
**Número do Endereço**
* Apenas números.
* Exemplo: `250` (não aceita `250A` ou `250 apto`)
**Estado**
* Sigla com exatamente 2 letras maiúsculas.
* Exemplos válidos: `SP`, `RS`, `MG`, `BA`
**CEP**
* Apenas números e hífen.
* Formato: `12345-678` ou `12345678`
> 💡 **Dica**: Se um campo opcional estiver presente na sua planilha, ele será validado conforme o formato acima. Se não estiver preenchido, a validação é pulada automaticamente.

### Como importar
Copie os dados da sua planilha (**CTRL+C**) e cole diretamente na grade do sistema (**CTRL+V**).
> 💡 **Dica**: Utilize o modelo oficial fornecido pelo HoopCRM para garantir a compatibilidade: [**Modelo de Planilha Padrão Especificadores**](https://docs.google.com/spreadsheets/d/1MldFWZAl5uWr2y5rDK3H4jYwspfWalKoQ-MOc7chivc/edit?usp=sharing).
> Coluna vermelha: **Campo obrigatório**
> Coluna laranja: **Precisa preencher E-mail OU Telefone do contato**.


![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot2_mfh6qr.png =1039xauto)

###### Envie os Dados
Após preencher todos os dados na sua planilha e copiá-los para a área de texto no sistema, clique em "**Enviar Dados**".
![](https://storage.crisp.chat/users/helpdesk/website/377a4172135ea400/unnamed-2023-03-28t153520644_gatum3.png)
### Regras de Duplicidade e ID
Ao importar especificadores, o sistema verifica se já existe um registro semelhante:

###### Sem a Coluna ID Preenchida
**E-mail Repetido**
* Comportamento depende da chave **"Editar especificadores com e-mail ou CPF/CNPJ iguais"** [(veja seção 2)](#3-configuracoes-de-importacao):
  * **Se ligada** ✅: O sistema irá editar o especificador existente com os novos dados.
  * **Se desligada** ❌: A linha é bloqueada com erro de duplicidade.
**CPF/CNPJ Repetido**
* Comportamento também depende da mesma chave:
  * **Se ligada** ✅: O sistema irá editar o especificador existente com os novos dados.
  * **Se desligada** ❌: A linha é bloqueada com erro de duplicidade.

###### Com a Coluna ID Preenchida
**Comportamento Especial do ID:**
* Se a coluna **ID** estiver preenchida, o sistema **sempre atualiza** o especificador com aquele ID, **independente da configuração da chave**.
* Se o ID preenchido **não existir** na base de dados, a linha **falha** com erro.
> ⚠️ **Importante**: A coluna ID é um identificador direto do especificador no sistema. Se você o informar, a importação usará esse ID como referência de atualização, ignorando as regras de duplicidade normais.