Configuração Inicial
Após ativar o módulo RH, algumas etapas de configuração são recomendadas antes de começar a gerenciar funcionários e executar a folha de pagamento. Todas as configurações estão acessíveis em Configurações > Configuração RH na barra lateral.
Configurações Gerais
Navegue até Configurações > Configuração RH > Geral para configurar as opções fundamentais.
Mês de Início do Ano Fiscal
Define quando o ano fiscal da sua organização começa. Isso afeta o processamento de transferência de licenças e os cálculos de períodos da folha de pagamento.
- Padrão: Janeiro
- Opções: Qualquer mês (Janeiro–Dezembro)
Exemplo: Se seu ano fiscal vai de abril a março, defina como Abril. A transferência de licenças será processada em 1º de abril de cada ano.
Formato do Código do Funcionário
Controla como os códigos de funcionários são gerados automaticamente ao criar novos funcionários.
| Formato | Exemplo | Descrição |
|---|---|---|
year_increment | 2026-001, 2026-002 | Prefixado com o ano atual, reinicia a cada ano |
increment | 001, 002, 003 | Numeração sequencial simples |
Configurações de Frequência
Navegue até Configurações > Configuração RH > Frequência.
Horas de Trabalho
| Configuração | Padrão | Descrição |
|---|---|---|
| Horas Padrão Por Dia | 8 | Usado para cálculos de horas extras e rateio da folha de pagamento |
| Horário de Início do Trabalho | 09:00 | Horário esperado de entrada |
| Horário de Término do Trabalho | 17:00 | Horário esperado de saída |
Dias de Folga Semanal
Selecione quais dias da semana são dias não trabalhados.
- Padrão: Sábado, Domingo
- Usado nos cálculos da folha de pagamento (contagem de dias úteis) e marcação automática de frequência nos fins de semana
Configurações de Gestão de Licenças
Navegue até Configurações > Configuração RH > Gestão de Licenças.
Fluxo de Aprovação
| Modo | Comportamento |
|---|---|
| Nível Único (padrão) | Um aprovador analisa e aprova/rejeita a solicitação |
| Múltiplos Níveis | A solicitação passa por múltiplas etapas de aprovação |
| Aprovação Automática | As solicitações são automaticamente aprovadas ao serem enviadas |
Tipos de Licença com Aprovação Automática
Selecione tipos de licença específicos que devem ignorar completamente o fluxo de aprovação. Útil para tipos como Trabalho Remoto ou Folga Compensatória onde a aprovação não é necessária.
Transferência de Licenças
| Configuração | Padrão | Descrição |
|---|---|---|
| Transferência Habilitada | Sim | Se os dias de licença não utilizados são transferidos para o próximo ano fiscal |
| Máximo de Dias de Transferência | 10 | Número máximo de dias que podem ser transferidos |
| Expiração da Transferência (meses) | 3 | Os dias transferidos expiram após este número de meses no novo ano fiscal |
A transferência de licenças é processada automaticamente no primeiro dia do mês de início do seu ano fiscal por meio de um comando agendado.
Configurações da Folha de Pagamento
Navegue até Configurações > Configuração RH > Folha de Pagamento.
Base de Cálculo do Salário
Determina como o salário é calculado para meses parciais ou períodos rateados.
| Modo | Descrição |
|---|---|
| Dias Úteis (padrão) | O salário é rateado com base nos dias úteis reais do período |
| Horas de Trabalho | O salário é calculado com base nas horas registradas |
| Mensal Fixo | Salário mensal integral independentemente dos dias úteis |
Horas Extras
| Configuração | Padrão | Descrição |
|---|---|---|
| Horas Extras Habilitadas | Sim | Se as horas extras são consideradas na folha de pagamento |
| Multiplicador de Horas Extras | 1.5x | Multiplicador aplicado à taxa horária para horas extras |
Destinatários de Notificações
Selecione usuários que devem receber notificações por e-mail quando os ciclos de folha de pagamento forem concluídos. Normalmente configurado para gerentes de RH ou membros da equipe financeira.
Departamentos & Projetos
Departamentos
Navegue até Configurações > Configuração RH > Departamentos para criar seus departamentos organizacionais antes de adicionar funcionários. Cada funcionário é atribuído a um departamento.
Exemplos: Recursos Humanos, Engenharia, Vendas, Marketing, Finanças.
Projetos
Navegue até Configurações > Configuração RH > Projetos para definir projetos nos quais os funcionários podem registrar tempo em suas planilhas de horas.
Configurando Tipos de Licença
Antes que os funcionários possam enviar solicitações de licença, você precisa configurar os tipos de licença. Navegue até Gestão de Licenças > Tipos de Licença na barra lateral.
Para cada tipo de licença, configure:
| Campo | Descrição |
|---|---|
| Nome | ex. Licença Anual, Licença Médica, Licença Maternidade |
| Dias Por Ano | Direito anual para este tipo de licença |
| É Remunerada | Se este tipo de licença é remunerada |
| Requer Aprovação | Se as solicitações precisam de aprovação do gerente |
| Transferência | Se os dias não utilizados são transferidos para o próximo ano |
| Máximo de Dias de Transferência | Limite de dias que podem ser transferidos |
| Está Ativo | Ativar ou desativar o tipo de licença |
Você pode usar o comando php artisan hrm:seed-leave-data para criar um conjunto padrão de tipos de licença (Anual, Médica, Pessoal, Maternidade, Paternidade, Luto, Não Remunerada, Trabalho Remoto) com valores padrão sensatos.
Configurando Componentes da Folha de Pagamento
Antes de executar a folha de pagamento, defina seus componentes salariais em Folha de Pagamento > Componentes da Folha de Pagamento.
Os componentes se dividem em três categorias:
| Tipo | Exemplos |
|---|---|
| Abono (Rendimentos) | Salário Base, Abono Habitação, Abono Transporte, Bônus |
| Dedução | Fundo de Previdência, Prêmio de Seguro, Reembolso de Empréstimo |
| Imposto | Imposto de Renda, Contribuição Social |
Cada componente suporta dois métodos de cálculo:
- Fixo: Um valor monetário definido (ex. R$ 500 de Abono Transporte)
- Percentual: Um percentual do salário base ou bruto (ex. 12% de Fundo de Previdência)
Execute php artisan hrm:seed-payroll-data para gerar um conjunto padrão de componentes da folha de pagamento (4 abonos, 3 deduções, 2 impostos) com configurações típicas.
Configuração do Portal do Funcionário
O Portal do Funcionário é configurado pelo arquivo config/employee-portal.php no diretório do módulo RH. Essas configurações controlam o que os funcionários veem e podem fazer quando fazem login.
Opções Principais
| Configuração | Padrão | Descrição |
|---|---|---|
enabled | true | Ativar ou desativar o portal do funcionário |
employee_role_name | Employee | Nome da função atribuída aos usuários funcionários |
auto_create_user | true | Criar automaticamente uma conta de usuário CRM quando um funcionário é criado |
landing_page | /timesheets | A página que os funcionários veem após o login |
Itens de Menu Visíveis
Por padrão, os funcionários podem acessar:
- Planilhas de Horas
- Solicitações de Licença
- Frequência
- Saldos de Licença
- Contracheques
Para conceder aos funcionários acesso a páginas de outros módulos, adicione o caminho da rota ao array allowed_menu_items no arquivo de configuração.
Escopo de Dados
O portal filtra automaticamente os dados para que os funcionários só possam ver seus próprios registros. Isso se aplica a solicitações de licença, saldos de licença, frequência, planilhas de horas, estruturas salariais, entradas da folha de pagamento e contracheques.
Modelos excluídos do escopo (visíveis para todos os funcionários):
- Employee — para que o dropdown BelongsTo funcione ao criar registros
- Leave Type — para que os funcionários possam ver os tipos de licença disponíveis
Ordem de Configuração Recomendada
- Ativar o módulo — Insira seu código de licença em Configurações > Configuração RH > Ativação
- Configurar definições gerais — Definir ano fiscal e formato do código do funcionário
- Criar departamentos — Adicionar sua estrutura organizacional
- Criar projetos — Definir projetos para acompanhamento de planilhas de horas (se aplicável)
- Configurar tipos de licença — Configurar categorias de licença e direitos
- Configurar definições de frequência — Definir horários de trabalho e dias de folga
- Configurar componentes da folha de pagamento — Definir rendimentos, deduções e impostos
- Configurar definições da folha de pagamento — Definir base de cálculo e regras de horas extras
- Adicionar funcionários — Começar a criar registros de funcionários (contas de usuário são criadas automaticamente)
- Atribuir estruturas salariais — Vincular componentes da folha de pagamento a cada funcionário
- Criar saldos de licença — Alocar direitos de licença para o ano atual