Cadastro de Empresa
Módulo: Empresas e Filiais Caminho na aplicação: Menu lateral > Empresas > Empresas > "Nova Empresa" ou ícone Editar na linha Última atualização: 20/04/2026
Para que serve
Cria ou edita o cadastro de uma empresa no tenant. Concentra dados principais (identificação fiscal, contato, porte), endereço, quadro societário e atividades econômicas (CNAEs). Permite importar dados automaticamente a partir do CNPJ consultado na Receita Federal.
Quem pode usar
Todos os usuários autenticados.
Como usar (passo a passo)
Criar nova empresa
- Acesse Menu lateral > Empresas > Empresas e clique em Nova Empresa (
/empresas/novo). - Preencha o CNPJ no campo correspondente.
- Clique em Consultar (lupa ao lado do CNPJ) para importar os dados da Receita Federal. Se houver dados já preenchidos, o sistema pergunta se deseja sobrescrever.
- Confirme ou ajuste os campos importados: Razão Social, Nome Fantasia, Inscrição Estadual, Email, Telefone, Data Abertura, Regime Tributário e Endereço.
- Preencha os demais campos opcionais conforme necessário (Inscrição Municipal, Capital Social, Porte, Site, Natureza Jurídica).
- No card Endereço, informe o CEP e clique na lupa para buscar o endereço automaticamente. Ajuste os campos se necessário.
- Verifique o card Sócios — populado automaticamente via consulta CNPJ. Para atualizar manualmente, clique em Sincronizar Receita.
- Verifique o card Atividades (CNAEs) — populado automaticamente via consulta CNPJ.
- Clique em Cadastrar. O sistema salva e redireciona para
/empresas/:id/editar(modo edição) sem fechar a tela.
Editar empresa existente
- Na Lista de Empresas, clique no ícone Editar (lápis) na linha desejada.
- A tela abre em
/empresas/:id/editarcom os dados preenchidos. - Altere os campos necessários.
- Clique em Salvar. Os dados são recarregados da API e o usuário permanece na mesma tela.
Navegar de volta sem salvar
Clique em Voltar ou Cancelar. Se houver alterações não salvas, o sistema exibe um aviso antes de sair.
Campos da tela
Formulário dividido em quatro cards: Dados Principais, Endereço, Sócios e Atividades (CNAEs).
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| CNPJ | Sim | CNPJ da empresa | Formato 00.000.000/0000-00; botão "Consultar" importa dados da Receita |
| Razão Social | Sim | Nome jurídico completo | Máx. 255 caracteres |
| Nome Fantasia | Não | Nome comercial | Máx. 255 caracteres |
| Inscrição Estadual | Não | IE conforme SEFAZ do estado | Máx. 20 caracteres |
| Inscrição Municipal | Não | IM conforme prefeitura | Máx. 20 caracteres |
| Regime Tributário | Não | Simples Nacional / Lucro Presumido / Lucro Real / MEI | Select; pode ser detectado via consulta CNPJ |
| Situação | Não | Ativa / Inativa | Padrão: Ativa |
| Não | Endereço de e-mail da empresa | Máx. 255 caracteres | |
| Telefone | Não | Telefone com DDD | Formatado automaticamente |
| Site | Não | URL do site | Máx. 500 caracteres |
| Data Abertura | Não | Data de constituição | Formato DD/MM/AAAA |
| Natureza Jurídica | Não | Descrição da natureza jurídica | Máx. 255 caracteres; importado via consulta CNPJ |
| Capital Social | Não | Valor em reais | Campo numérico com prefixo R$, separador decimal vírgula |
| Porte | Não | ME / EPP / Médio Porte / Grande Porte | Select opcional |
| CEP | Não | CEP do endereço | Formato 00000-000; lupa busca endereço automaticamente |
| Logradouro | Não | Rua, Avenida etc. | Preenchido via CEP ou CNPJ |
| Número | Não | Número do logradouro | Máx. 20 caracteres |
| Complemento | Não | Apto, Sala etc. | Máx. 255 caracteres |
| Bairro | Não | Bairro | Máx. 100 caracteres |
| Cidade | Não | Município | Máx. 100 caracteres |
| UF | Não | Estado (2 letras) | Select com todos os estados |
| País | Não | País | Máx. 100 caracteres; preenchido como "Brasil" via consulta CNPJ |
Card Sócios (somente leitura na tabela)
| Coluna | Descrição |
|---|---|
| Nome | Nome completo do sócio |
| CPF/CNPJ | Documento do sócio |
| Qualificação | Papel do sócio (ex.: Sócio-Administrador) |
| Rep. Legal | Indica se é representante legal |
Card Atividades (CNAEs) (somente leitura na tabela)
| Coluna | Descrição |
|---|---|
| CNAE | Código da atividade |
| Descrição | Descrição da atividade |
| Tipo | Principal (azul) ou Secundário (cinza) |
Validações e regras
- CNPJ: obrigatório → mensagem "CNPJ é obrigatório".
- Razão Social: obrigatória → mensagem "Razão social é obrigatória".
- Consulta CNPJ (validação prévia): se CNPJ tiver menos de 14 dígitos → "CNPJ deve ter 14 dígitos"; se CNPJ inválido matematicamente → "CNPJ inválido".
- Consulta CEP: se CEP tiver menos de 8 dígitos → "CEP deve ter 8 dígitos".
- Endereço já preenchido + consulta CEP: exibe modal de confirmação "Deseja sobrescrever os dados de endereço com o resultado do CEP?" — opções: "Sobrescrever" / "Manter atual".
- Dados já preenchidos + consulta CNPJ: exibe modal "Deseja sobrescrever os dados com o resultado da consulta CNPJ?" — opções: "Sobrescrever" / "Manter atual".
- Sincronizar Receita: requer CNPJ válido de 14 dígitos → se ausente: "Informe um CNPJ válido para sincronizar".
- Alterações não salvas: ao tentar sair da tela com campos modificados, o sistema exibe aviso via
useUnsavedChanges. - Criação: após salvar, redireciona para
/empresas/:id/editarcomreplace: true. - Edição: após salvar, recarrega os dados da API e mantém o usuário na tela.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "CNPJ é obrigatório" | Campo CNPJ vazio ao tentar salvar | Preencha o CNPJ |
| "Razão social é obrigatória" | Campo Razão Social vazio ao tentar salvar | Preencha a razão social |
| "CNPJ deve ter 14 dígitos" | CNPJ incompleto ao clicar em Consultar | Complete o CNPJ |
| "CNPJ inválido" | CNPJ com dígito verificador incorreto | Verifique e corrija o CNPJ |
| "CEP deve ter 8 dígitos" | CEP incompleto ao clicar na lupa | Complete o CEP |
| "CEP não encontrado" | CEP inexistente na base de dados | Verifique o CEP e preencha o endereço manualmente |
| "Informe um CNPJ válido para sincronizar" | CNPJ ausente ou incompleto ao clicar em Sincronizar Receita | Preencha o CNPJ antes de sincronizar |
| "Erro ao carregar empresa" | Falha ao buscar o registro na edição | Verifique a conexão; se persistir, volte e reabra o cadastro |
| "Empresa atualizada com sucesso" | Edição salva com sucesso | Informativa |
| "Empresa criada com sucesso" | Criação salva com sucesso | Informativa |
| "Erro ao salvar empresa" (ou mensagem do backend) | Falha na requisição POST/PUT | — |
| "Erro ao consultar CNPJ" (ou mensagem do backend) | Serviço de consulta indisponível ou CNPJ não encontrado | — |
N sócio(s) sincronizado(s) | Sincronização com Receita concluída | Informativa; N é o número de sócios retornados |
| "Nenhum sócio encontrado na Receita" | Consulta retornou lista de sócios vazia | Cadastre os sócios manualmente, se necessário |
Integrações e dependências
POST /empresas— cria empresaPUT /empresas/:id— atualiza empresaGET /empresas/:id— carrega dados para ediçãoGET /empresas/consultar-cnpj/:cnpj— consulta Receita FederalGET /empresas/consultar-cep/:cep— consulta endereço por CEP- Lista de Empresas — origem e destino do fluxo
Dúvidas frequentes
Posso cadastrar uma empresa sem consultar o CNPJ? Sim. A consulta é opcional. Preencha os campos manualmente e clique em Cadastrar.
O sistema sobrescreve os dados que já preenchi ao consultar o CNPJ? Apenas se você confirmar. Se já houver dados no formulário, o sistema exibe uma modal de confirmação antes de sobrescrever.
Os sócios e CNAEs aparecem automaticamente? Sim, quando importados via consulta CNPJ. Para atualizar depois, use o botão "Sincronizar Receita" no card Sócios.
Posso editar sócios e CNAEs diretamente na tela? Não. Os dados de sócios e CNAEs são importados da Receita Federal. A edição manual não está disponível nesta versão.
O que acontece se eu fechar o navegador com dados não salvos? Os dados são perdidos. Salve antes de fechar. O aviso de alterações não salvas só aparece ao navegar dentro do sistema.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |