Lista de Filiais
Módulo: Empresas e Filiais Caminho na aplicação: Menu lateral > Empresas > Filiais Última atualização: 20/04/2026
Para que serve
Exibe todas as filiais cadastradas no tenant em uma tabela com scroll infinito. Permite buscar, filtrar por tipo e situação, navegar para o cadastro de cada filial e remover registros. Também pode ser acessada filtrada por empresa a partir da Lista de Empresas.
Quem pode usar
Todos os usuários autenticados.
Como usar (passo a passo)
- Acesse Menu lateral > Empresas > Filiais (
/filiais). - A tabela carrega automaticamente as primeiras 50 filiais.
- Use o campo de busca para filtrar por razão social, nome fantasia, CNPJ ou código.
- Use o seletor Tipo para filtrar por Matriz, Filial, Depósito ou Virtual.
- Use o seletor Situação para filtrar filiais ativas ou inativas.
- Clique em Limpar para remover todos os filtros.
- 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 filial em modo edição.
- Para remover uma filial, clique no ícone de lixeira na linha e confirme a exclusão no modal.
- Clique em Nova Filial no canto superior direito para cadastrar uma nova filial.
Campos da tela
Listagem: colunas da tabela + filtros.
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca (filtro) | Não | Razão social, fantasia, CNPJ ou código | Campo de texto livre |
| Tipo (filtro) | Não | Matriz / Filial / Depósito / Virtual | Select com opção "limpar" |
| Situação (filtro) | Não | Ativa / Inativa | Select com opção "limpar" |
| ID | — | Número interno sequencial | Gerado pelo sistema |
| Razão Social | — | Nome jurídico da filial | Coluna exibida |
| Fantasia | — | Nome de fantasia | Exibe "—" se não informado |
| CNPJ | — | CNPJ formatado | Exibido como 00.000.000/0000-00 |
| Tipo | — | Matriz / Filial / Depósito / Virtual | Tag colorida: Matriz=azul, Filial=verde, Depósito=laranja, Virtual=roxo |
| Cidade/UF | — | Cidade e estado do endereço | Exibe "—" se endereço não cadastrado |
| Ambiente NFe | — | Produção / Homologação | Tag colorida: Produção=verde, Homologação=laranja; exibe "—" se não configurado |
| 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.
- Filtro por empresa: quando acessada via link na Lista de Empresas (parâmetro
?empresa_id=...), a listagem já vem filtrada pela empresa correspondente.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar filiais" | Falha na requisição GET /filiais | Verifique conexão e recarregue a página |
| "Filial removida com sucesso" | Exclusão concluída | Informativa |
| "Erro ao remover filial" (ou mensagem do backend) | Falha na requisição DELETE /filiais/:id | — |
Integrações e dependências
- Endpoint:
GET /filiais— parâmetros:page,limit,busca,tipo,situacao,empresa_id - Endpoint:
DELETE /filiais/:id - Acessada a partir de Lista de Empresas via coluna Filiais
- Navega para Cadastro de Filial ao clicar em "Nova Filial" ou no ícone Editar da linha
Dúvidas frequentes
Como ver só as filiais de uma empresa específica? Na Lista de Empresas, clique no número da coluna Filiais. A tela de Filiais abre já filtrada pela empresa.
Como editar uma filial? Clique no ícone Editar (lápis) na coluna de ações da linha desejada. A tela de edição abrirá em /filiais/:id/editar.
O que significa o tipo "Virtual"?
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |