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.

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
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.

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
- 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
- Exemplo válido: jefferson@hoopcompany.com
CPF/CNPJ
- Apenas números, pontos e hífens.
- Exemplos válidos:
123.456.789-10ou12345678000190
Telefone
- Números, hífen, parênteses, pontos e espaços.
- Exemplos válidos:
(11) 98765-4321ou11 9 8765 4321
Número do Endereço
- Apenas números.
- Exemplo:
250(não aceita250Aou250 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-678ou12345678
💡 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:
- Copie os dados da planilha (CTRL + C)
- Cole diretamente na grade do sistema (CTRL + V)
- Verifique se as colunas estão corretamente alinhadas
- Clique em Enviar Dados

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
Atualizado em: 23/09/2026
Obrigado!
