Lista de Funcionários
Módulo: Pessoas Caminho na aplicação: Menu > Pessoas > Funcionários (/funcionarios) Última atualização: 20/04/2026
Para que serve
Exibe todos os funcionários cadastrados na empresa. Permite pesquisar por nome, CPF, cargo ou e-mail e remover registros. O ícone Editar (lápis) na coluna de ações abre o cadastro para edição.
Quem pode usar
Todos os usuários autenticados.
Como usar (passo a passo)
- Acesse Menu > Pessoas > Funcionários.
- A lista carrega automaticamente os primeiros 50 registros.
- Use o campo de busca para filtrar por nome, CPF, cargo ou e-mail.
- Role a página para baixo para carregar mais registros (scroll infinito, 50 por vez).
- Clique em Novo Funcionário para abrir o cadastro.
- Clique no ícone Editar (lápis) na coluna de ações da linha para editar o funcionário.
- Para remover, clique no ícone de lixeira na linha desejada e confirme a exclusão.
- Clique em Limpar para redefinir o filtro de busca.
Campos da tela
Listagem com as seguintes colunas e filtros:
| Campo | Tipo | Descrição |
|---|---|---|
| ID | Coluna | Identificador interno sequencial (id_interno). |
| Nome | Coluna | Nome completo do funcionário. |
| CPF | Coluna | CPF formatado (000.000.000-00). |
| Cargo | Coluna | Cargo do funcionário; exibe "—" se não informado. |
| Email Corp. | Coluna | E-mail corporativo; exibe "—" se não informado. |
| Celular | Coluna | Celular formatado; exibe "—" se não informado. |
| Cidade/UF | Coluna | Cidade e UF do endereço. |
| Status | Coluna | Tag Ativo (verde) ou Inativo (cinza). |
| Busca | Filtro | Pesquisa por nome, CPF, cargo ou e-mail. |
Validações e regras
- Remoção: ao confirmar a exclusão o sistema executa soft delete (desativa o registro). A lista é recarregada do início após a operação.
- Scroll infinito: ao chegar perto do fim da página o sistema carrega a próxima página de 50 registros. Quando todos estiverem carregados exibe "Todos os registros carregados".
- Filtro reativo: qualquer alteração no campo de busca recarrega a lista a partir da página 1.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar funcionarios" | Falha na requisição à API ao listar. | Verifique a conexão e recarregue a página. |
| "Erro ao remover funcionario" | Falha na requisição à API ao deletar. | Verifique a conexão e tente novamente. |
| "Funcionario removido com sucesso" | Confirmação de remoção bem-sucedida. | Nenhuma ação necessária. |
Integrações e dependências
- Endpoint:
GET /funcionarios(parâmetros:page,limit,busca). - Endpoint:
DELETE /funcionarios/:id. - Tela de destino ao ícone Editar ou "Novo Funcionário": Cadastro de Funcionário.
Dúvidas frequentes
A exclusão apaga o funcionário do banco de dados? Não. O sistema aplica soft delete: o funcionário é desativado e deixa de aparecer na listagem, mas o registro permanece no banco.
Não há filtro por tipo de pessoa. Por quê? Funcionários são sempre pessoas físicas, portanto o filtro de tipo não se aplica a esta tela.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |