Execuções de folha¶
Uma execução de folha calcula e processa a remuneração de um período de pagamento, produzindo um holerite para cada funcionário incluído.
A lista de execuções¶
Acesse Payroll → Execuções. Cada cartão de execução mostra o período, um número consecutivo, o número de funcionários, os totais bruto e líquido, o status e a estação (se a execução estiver restrita a uma).
Use os filtros:
- Intervalo de datas e intervalo de valores (sobre o bruto).
- Chips de Status: Rascunho, Processando, Concluída, Falhou, pending_approval, approved, voided.
- Mostrar anuladas para revelar execuções anuladas.
Criar uma execução¶
- Clique em Executar Folha (isto abre o assistente em
/payroll/runs/new).
Etapa 1 — Selecione o período de pagamento¶
- Defina o Início do Período e o Término do Período (padrão: o mês atual).
- Opcionalmente, filtre por estação.
- O assistente mostra quantos funcionários ativos serão incluídos — aqueles com uma folha de ponto aprovada que se sobreponha ao período (e que corresponda ao filtro de estação).
- Clique em Visualizar.
Folhas de ponto aprovadas são obrigatórias
Um funcionário só é incluído se tiver uma folha de ponto aprovada no período. Se ninguém se qualificar, o assistente mostra “Nenhuma folha de ponto aprovada para este período.”
Etapa 2 — Revise a visualização¶
A visualização é uma planilha que você pode ajustar antes de executar:
| Coluna | Editável | Observações |
|---|---|---|
| Funcionário | Não | Coluna fixa |
| Localização | Não | Estação ou “Não atribuído” |
| Tipo | Não | Fixo / Por hora |
| Horas | Sim | A edição recalcula o bruto |
| Pagamento Normal | Não | Bruto − horas extras |
| HE | Não | Apenas horas extras aprovadas |
| Pagamento de HE | Não | Calculado com multiplicadores do país |
| DT / DI | Não | Dias trabalhados / dias de incapacidade |
| Bruto | Sim | A edição recalcula os impostos, a menos que você os tenha sobrescrito |
| Encargos Sociais | Sim | Contribuições de previdência social do funcionário |
| Descontos | Sim | Condicional |
| Bônus | Sim | Condicional |
| Líquido | Não | Sempre recalculado |
| Despesas de Viagem | Não | Abre um detalhamento por funcionário |
A barra de ferramentas mostra totais contínuos (bruto, encargos sociais, descontos, bônus, líquido) por moeda.
- Despesas de Viagem abre um modal para inserir quantidades e preços unitários por categoria (transporte, refeições, hospedagem, outros). Se uma categoria estiver marcada como Obrigatória nas configurações, as quantidades são preenchidas automaticamente a partir dos dias trabalhados.
- Salvar Rascunho armazena a execução para depois; o salvamento automático ocorre a cada 120 segundos.
- Finalizar e Executar gera os holerites e conclui a execução.
Etapa 3 — Conclusão¶
O assistente confirma a execução e oferece Ver Holerites.
Motor de cálculo¶
Salário bruto¶
- Salário fixo: um mês calendário completo paga o salário integral; um mês parcial paga
salário × (dias no período ÷ 30). As horas não reduzem o salário base. - Por hora:
(horas trabalhadas − horas de intervalo não remunerado) × taxa horária. - Horas extras: horas extras aprovadas × taxa horária × multiplicador do país (salário fixo ÷ 160 para a taxa horária base).
Bônus e descontos¶
- Bônus Pendentes que se sobrepõem ao período são adicionados.
- Descontos Ativos que se sobrepõem ao período subtraem
min(parcela, saldo restante).
Licença¶
Para licenças aprovadas com remuneração inferior a 100%, a parcela não remunerada é subtraída do bruto para funcionários com salário fixo. Taxa diária = salário fixo ÷ 30 (ou taxa horária × 8).
Impostos e contribuições do empregador¶
As contribuições do funcionário e do empregador são calculadas a partir das regras fiscais que você configurou (veja Impostos e Conformidade). A alíquota se aplica ao bruto tributável; um limite atua como piso.
Salário líquido¶
Net = gross + bonuses + holiday pay − unpaid-leave deduction
− employee social charges − employee deductions
Os descontos são limitados para que o líquido nunca fique negativo.
Despesas de viagem são informativas
Viáticos são mostrados no holerite, mas não são adicionados ao bruto ou ao líquido — eles são reembolsados separadamente. Veja Despesas de viagem.
Multimoeda¶
Funcionários pagos em moedas diferentes são agrupados em uma execução por moeda. Rascunhos são combinados por período, estação e moeda.
Ciclo de vida da execução¶
| Status | Significado |
|---|---|
| Rascunho | Salva, mas não finalizada; totalmente editável |
| Processando | Sendo calculada |
| Concluída | Holerites gerados; dispara o envio automático de e-mail |
| pending_approval | Enviada para uma segunda pessoa aprovar |
| approved | Aprovada e bloqueada para análises |
| rejected | Devolvida para Rascunho com um motivo |
| voided | Cancelada com um motivo |
| Falhou | Erro de processamento |
As ações disponíveis dependem do status:
- Rascunho: Editar Rascunho, Enviar para Aprovação, Excluir.
- pending_approval: Aprovar, Rejeitar.
- Concluída / approved: Reverter para Rascunho, Anular.
- Qualquer execução (a menos que anulada): Bloquear / Desbloquear período.
- Exportações: CSV, PDF, Excel.
Anular exige um motivo. Reverter para Rascunho é bloqueado quando o período está bloqueado.
Exportações¶
Cada execução pode ser exportada como:
- CSV — colunas por funcionário mais um bloco de resumo.
- Excel — uma planilha de Dados e uma planilha de Resumo.
- PDF — uma tabela em paisagem ordenada por estação.
Relacionado¶
Ainda tem dúvidas? Pergunte no Discord ou explore os tutoriais.