Cadastro de Funcionário
Módulo: Pessoas Caminho na aplicação: Menu > Pessoas > Funcionários > "Novo Funcionário" ou ícone Editar na linha Última atualização: 20/04/2026
Para que serve
Permite criar e editar o cadastro completo de um funcionário, incluindo dados principais, endereço, informações de contato (particular e corporativo), dados familiares, observações e arquivos anexos.
Quem pode usar
Todos os usuários autenticados.
Como usar (passo a passo)
Criação
- Na lista de funcionários, clique em Novo Funcionário.
- Informe o Nome e o CPF do funcionário.
- Preencha os demais campos conforme necessário (datas, cargo, endereço, contatos, família).
- Informe o CEP — o sistema preenche logradouro, bairro, cidade, UF e IBGE automaticamente.
- Clique em Cadastrar Funcionário.
- O sistema redireciona para a tela de edição do registro recém-criado (
/funcionarios/:id/editar).
Edição
- Na lista de funcionários, clique no ícone Editar (lápis) na linha do funcionário.
- Altere os campos desejados.
- Clique em Salvar Alterações.
- O sistema recarrega os dados do registro e mantém o usuário na mesma tela.
Consulta de CEP
Digite o CEP (ou clique na lupa). O sistema preenche logradouro, bairro, cidade, UF e IBGE. Se já houver endereço em modo edição, uma confirmação é exibida antes de substituir.
Campos da tela
Seção Dados Principais
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Status | Não | Ativo / Inativo | Padrão: Ativo. |
| Nome | Sim | Nome completo do funcionário | Mínimo 2 caracteres. |
| CPF | Sim | CPF no formato 000.000.000-00 | Formatado automaticamente. Validação de dígitos verificadores. |
| Nascimento | Não | Data de nascimento (DD/MM/AAAA) | Seletor de data. |
| Admissão | Não | Data de admissão (DD/MM/AAAA) | Seletor de data. |
| Cargo | Não | Cargo ou função exercida | Texto livre. |
| Demissão | Não | Data de demissão (DD/MM/AAAA) | Seletor de data. Preenchido somente quando aplicável. |
Seção Endereço
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| CEP | Não | CEP no formato 00000-000 | Consulta automática ao completar 8 dígitos. |
| Logradouro | Não | Nome da rua, avenida etc. | Preenchido automaticamente pelo CEP. |
| Número | Não | Número do imóvel | Texto livre. |
| Complemento | Não | Apto, sala, bloco etc. | Texto livre. |
| Bairro | Não | Bairro | Preenchido automaticamente pelo CEP. |
| Cidade | Não | Nome da cidade | Preenchido automaticamente pelo CEP. |
| UF | Não | Sigla do estado (2 letras) | Select com todas as UFs brasileiras. |
| País | Não | Nome do país | Padrão: Brasil. |
| IBGE | Não | Código IBGE do município | Preenchido automaticamente pelo CEP. |
Seção Contato
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Telefone | Não | Telefone particular (00) 0000-0000 | Formatado automaticamente. |
| Celular | Não | Celular particular (00) 00000-0000 | Formatado automaticamente. |
| Email (Particular) | Não | E-mail pessoal | Validação de formato. |
| Telefone Corp. | Não | Telefone corporativo (00) 0000-0000 | Formatado automaticamente. |
| Celular Corp. | Não | Celular corporativo (00) 00000-0000 | Formatado automaticamente. |
| Email Corporativo | Não | E-mail da empresa | Validação de formato. |
Seção Família
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Nome da Mãe | Não | Nome completo da mãe | Texto livre. |
| Nome do Pai | Não | Nome completo do pai | Texto livre. |
| Nome do Cônjuge | Não | Nome do cônjuge | Texto livre. |
| Telefone Cônjuge | Não | Telefone do cônjuge (00) 00000-0000 | Formatado automaticamente. |
Seção Observações
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Observações | Não | Informações adicionais sobre o funcionário | Campo texto livre (3 linhas). Sem label visível — campo direto no card. |
Seção Arquivos (somente em edição)
Gerenciamento de arquivos anexados ao funcionário. Disponível somente após o cadastro ser salvo.
Validações e regras
- Nome: obrigatório, mínimo 2 caracteres → exibe "Informe o nome" → bloqueia o envio.
- CPF: obrigatório → exibe "Informe o CPF" → bloqueia o envio. Dígitos verificadores validados no frontend → exibe "CPF inválido".
- Email (particular ou corporativo): formato de e-mail → exibe "Email inválido" → bloqueia o envio.
- Alterações não salvas: ao tentar sair com campos modificados, um alerta de confirmação é exibido.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar funcionário" | Falha ao buscar os dados na edição. | Verifique a conexão; o sistema redireciona para a lista. |
| "Funcionário criado com sucesso" | Criação bem-sucedida. | Nenhuma ação; o sistema redireciona para edição. |
| "Funcionário atualizado com sucesso" | Atualização bem-sucedida. | Nenhuma ação; o formulário é recarregado. |
| "Erro ao salvar funcionário" | Falha na requisição de criação ou atualização. | — |
| "Erro ao consultar CEP" | CEP não encontrado ou erro na API. | — |
Integrações e dependências
GET /funcionarios/:id— carrega dados para edição.POST /funcionarios— cria novo funcionário.PUT /funcionarios/:id— atualiza funcionário existente.GET /cep/:cep— consulta endereço por CEP (via backend).- Componente
FuncionarioArquivos— gerencia arquivos no S3 (somente em edição). - Tela relacionada: Lista de Funcionários.
Dúvidas frequentes
Posso salvar um funcionário sem informar o CPF? Não. O CPF é obrigatório e validado antes do envio.
A seção "Arquivos" aparece ao criar um novo funcionário? Não. Ela só fica visível após o cadastro ser salvo pela primeira vez.
O campo "Demissão" desativa o funcionário automaticamente? Não. O campo registra a data, mas a desativação deve ser feita manualmente pelo campo Status.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |