Lista de Empresas
Módulo: Empresas e Filiais Caminho na aplicação: Menu lateral > Empresas > Empresas Última atualização: 20/04/2026
Para que serve
Exibe todas as empresas cadastradas no tenant em uma tabela com scroll infinito. Permite buscar, filtrar por situação, navegar para o cadastro de cada empresa e remover registros.
Quem pode usar
Todos os usuários autenticados.
Como usar (passo a passo)
- Acesse Menu lateral > Empresas > Empresas (
/empresas). - A tabela carrega automaticamente as primeiras 50 empresas.
- Use o campo de busca para filtrar por razão social, nome fantasia ou CNPJ.
- Use o seletor Situação para filtrar empresas ativas ou inativas.
- Clique em Limpar para remover os filtros aplicados.
- Role a página para baixo para carregar mais registros (scroll infinito, 50 por vez).
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro da empresa em modo edição.
- Clique no número da coluna Filiais para navegar diretamente à lista de filiais daquela empresa.
- Para remover uma empresa, clique no ícone de lixeira na linha e confirme a exclusão no modal.
- Clique em Nova Empresa no canto superior direito para cadastrar uma nova empresa.
Campos da tela
Listagem: colunas da tabela + filtros.
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca (filtro) | Não | Razão social, fantasia ou CNPJ | Campo de texto livre com lupa |
| Situação (filtro) | Não | Ativa / Inativa | Select com opção "limpar" |
| ID | — | Número interno sequencial | Coluna exibida, gerado pelo sistema |
| Razão Social | — | Nome jurídico da empresa | Coluna exibida |
| Fantasia | — | Nome de fantasia | Exibe "—" se não informado |
| CNPJ | — | CNPJ formatado | Exibido como 00.000.000/0000-00 |
| Regime Tributário | — | Simples Nacional / Lucro Presumido / Lucro Real / MEI | Exibe "—" se não informado |
| Cidade/UF | — | Cidade e estado do endereço | Exibe "—" se endereço não cadastrado |
| Filiais | — | Contagem de filiais vinculadas | Clicável; redireciona para /filiais?empresa_id=... |
| Situação | — | Ativa / Inativa | Tag colorida: verde = ativa, cinza = inativa |
Validações e regras
- Scroll infinito: ao rolar a página até 200px antes do final, o sistema busca automaticamente a próxima página (50 registros).
- Remoção: exige confirmação via modal. A exclusão é permanente.
- Filtros: qualquer alteração nos filtros reinicia a listagem da página 1.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar empresas" | Falha na requisição GET /empresas | Verifique conexão e tente recarregar a página |
| "Empresa removida com sucesso" | Exclusão concluída com sucesso | Informativa, nenhuma ação necessária |
| "Erro ao remover empresa" (ou mensagem do backend) | Falha na requisição DELETE /empresas/:id — pode haver dependências | — |
Integrações e dependências
- Endpoint:
GET /empresas— parâmetros:page,limit,busca,situacao - Endpoint:
DELETE /empresas/:id - Navega para Cadastro de Empresa ao clicar em "Nova Empresa" ou no ícone Editar da linha
- Navega para Lista de Filiais ao clicar no contador de filiais
Dúvidas frequentes
O sistema não mostra todas as empresas de uma vez. Isso é normal? Sim. A listagem usa paginação de 50 registros com scroll infinito. Role a página para baixo para carregar mais.
Como editar uma empresa? Clique no ícone Editar (lápis) na coluna de ações da linha desejada. A tela de edição abrirá em /empresas/:id/editar.
Posso filtrar por CNPJ? Sim. O campo de busca aceita razão social, nome fantasia ou CNPJ (com ou sem formatação).
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |