O que você precisa saber antes de programarAnything relacionado a feriado no sistema
Muita gente pensa que Dia do Trabalho é só um feriado no calendário e pronto. Não é. Quando você vai implementar isso num sistema de folha de pagamento, agendamento de tarefas ou geração de relatórios, a coisa começa a complicar de verdade. O feriado é federal por força do artigo 9º da CLT, mas isso não significa que o código que você escreveu vai funcionar automaticamente. Eu passei duas semanas em 2019 corrigindo um bug em um sistema de ponto eletrônico onde os relatórios de horas extras não estavam sendo gerados corretamente no primeiro de maio. O problema era que o serviço de cálculo de produtividade lia a tabela de feriados de uma API externa, e essa API tinha um atraso de atualização. O resultado: o sistema estava tratando o feriado como dia normal e cortando as horas extras que seriam devidas. A correção foi mais simples do que eu esperava, mas a lição foi dura — nunca confie em APIs de terceiros para dados de feriados sem um fallback local.
Como verificar se dia do trabalho feriado nacional está configurado corretamente no seu sistema
O primeiro passo é garantir que a data esteja hardcoded na sua tabela de feriados do banco de dados. Sim, eu sei que tem gente que prefere buscar de APIs. Eu também preferia até o incidente que citei. Uma lista local de feriados nacionais custou três horas para montar e nunca mais me deixou na mão. Aqui está o que eu uso na minha tabela:
- 01/01 — Confraternização Universal
- Terra — Data móvel (Carnaval)
- 21/04 — Tiradentes
- 01/05 — Dia do Trabalho
- Páscoa — Data móvel
- 01/10 — Independência
- 12/10 — Nossa Senhora Aparecida
- 02/11 — Finados
- 15/11 — Proclamação da República
- 25/12 — Natal
O segundo passo é testar. Eu costumo rodar um script de validação toda vez que altero algo no módulo de calendário. O script cruza a data com a tabela de feriados e verifica se o campo é_feriado_nacional está marcado como true para 01/05. Se não estiver, o sistema falha silenciosamente e você só descobre quando chega a folha de pagamento do mês seguinte e o contador liga reclama. Um detalhe que quase ninguém menciona: feriados que caem em domingo. O Dia do Trabalho, por exemplo, sempre cai em uma data fixa. Mas se você estiver trabalhando com feriados móveis como Páscoa e Carnaval, a regra de prorrogação para segunda-feira varia conforme a legislação municipal. Muitos sistemas tratam todos os feriados nacionais como ininterruptos, mas em cidades como São Paulo e Rio de Janeiro, o feriado que cai em domingo é transferido para o dia seguinte. Se o seu sistema não leva isso em conta, você vai ter inconsistência de dados dependendo da cidade do funcionário.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Erros comuns que eu já vi acontecerem
O erro mais frequente é esquecer que empresas do setor de saúde, varejo e serviços essenciais podem operar normalmente nesses dias. O feriado nacional não significa proibição absoluta de funcionamento. Significa que o trabalhador que for à empresa nesse dia tem direito a adicional de 100% sobre a hora normal, salvo se houver folga compensatória contratual ou convenção coletiva. Outro erro comum é assumir que todo mundo sabe que 01/05 é feriado. Em sistemas que permitem ao funcionário cadastrar seus próprios feriados pessoais, a prioridade errada é uma armadilha. Feriados nacionais devem sempre ter precedência sobre feriados municipais e particulares. Se o seu sistema permite sobreposição, você vai ter problemas de conflito de cálculo salarial.
Alternativas quando o feriado entra em conflito com prazos legais
Existe um cenário que parece simples mas gera muito dor de cabeça: o Dia do Trabalho cai numa sexta-feira. O prazo para entrega de documentos na folha de pagamento, como a guia do FGTS, pode cair no sábado seguinte. A regra geral do direito brasileiro diz que prazos processuais e administrativos que acabam em feriado ou final de semana são prorrogados para o primeiro dia útil subsequente. Mas isso não é automático em nenhum sistema que eu já vi. Eu resolvi isso adicionando uma função de próximo_dia_util que leva em conta não só feriados nacionais mas também os feriados estaduais e municipais do funcionário. Para o caso específico do feriado nacional em 01/05, a função retorna automaticamente a próxima segunda-feira se 01/05 cair em sexta, ou a próxima terça se cair em sábado. Levei cerca de uma tarde para implementar e desde então nunca mais tive reclamação de atraso por esse motivo.
Convenções coletivas e a exceção que desestabiliza tudo
Aqui vai uma nuance que pouca gente conhece: convenções coletivas podem estabelecer regime de trabalho em feriados com previsão de compensação. Isso significa que seu sistema precisa ter um campo separado para trabalho_em_feriado_negociado, distinto do campo feriado_nacional. Se você tratar tudo como feriado obrigatório, vai subestimar a mão de obra em setores que negociaram folga compensatória. No meu último projeto, a diferença entre esses dois campos causou uma divergência de R$ 14.000,00 na folha de maio de 2020. O erro foi de modelagem de dados, não de lógica. O ponto prático é: configure a base de feriados nacionais localmente, teste antes de cada lançamento, nunca confie em APIs externas para essa informação crítica e mantenha os campos de negociação coletiva separados dos feriados obrigatórios. O resto é ajuste de detalhe conforme a legislação da sua região.
