> ## 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 Escritórios

A importação de escritórios permite que você cadastre múltiplos escritórios de arquitetura de forma rápida no HoopCRM, utilizando uma planilha padrão. Isso agiliza o processo e evita o cadastro manual item por item.

### Como importar
No menu, vá em **Importação de Dados** e clique na opção **Escritórios**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_80y0la.png =209xauto)
### Estrutura da planilha
Para garantir que a importação funcione corretamente, é necessário utilizar a planilha padrão disponibilizada:
👉 [Planilha Padrão - Importação de Escritórios](https://docs.google.com/spreadsheets/d/1NTtCOFqsmjIbSvobu9uMzz2an9Q_BBWEHsxe1vsopjo/edit?gid=0#gid=0)

Certifique-se de:
* Não alterar o nome das colunas
* Preencher os dados corretamente conforme o modelo
* Manter o padrão exigido pelo sistema
Assim como em outros tipos de importação, o uso da planilha modelo garante compatibilidade e evita falhas no processamento

### Configurações da importação

Antes de importar, certifique do que deseja fazer. Se você quer criar novos escritórios, atualizar escritórios ou ambos, é importante verificar a configuração que controla o comportamento ao encontrar duplicatas.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_8xl90y.gif =928xauto)
###### Chave "Editar escritórios com e-mail ou telefone iguais"
Esta opção controla como o sistema se comporta quando encontra um escritório 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 escritórios 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 escritório.
* 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**
* **Razão Social**
* **E-mail**
* **CPF/CNPJ**
* **Telefone**
* **Responsável**
* **Categoria**
* **Endereço** (logradouro, número, complemento, bairro, cidade, estado, CEP)
* **Número**
* **Complemento**
* **Bairro**
* **Cidade**
* **Estado (Sigla)**
* **CEP**
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 realizar a importação
Após preparar a planilha:
1. Copie os dados da planilha (**CTRL + C**)
2. Cole diretamente na grade do sistema (**CTRL + V**)
3. Verifique se as colunas estão corretamente alinhadas
4. Clique em **Enviar Dados**

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

O sistema irá validar as informações antes de concluir a importação, garantindo que os dados estejam corretos
O preenchimento incorreto pode impedir a importação ou gerar inconsistências nos dados.

### Regras de Duplicidade e ID
Ao importar escritórios, o sistema verifica se já existe um registro semelhante:

###### Sem a Coluna ID Preenchida
**E-mail Repetido**
* Comportamento depende da chave **"Editar escritórios com e-mail ou CPF/CNPJ iguais"**:
    * **Se ligada** ✅: O sistema irá editar o escritório 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 escritório 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 escritório 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 escritório no sistema. Se você o informar, a importação usará esse ID como referência de atualização, ignorando as regras de duplicidade normais.

### Observações importantes
* Utilize sempre a planilha modelo oficial
* Evite linhas em branco ou dados fora do padrão
* Grandes volumes podem levar alguns minutos para processamento
* Caso haja erro, revise os dados antes de reenviar
|| Agora você aprendeu como importar escritórios no HoopCRM, permitindo cadastrar múltiplos registros de forma rápida, organizada e sem retrabalho manual dentro do sistema.