Módulo Feriados Brasileiros para WHMCS
Garante que o vencimento das faturas não caiam em finais de semana ou feriados
Principais funcionalidades
✓ Vencimento Perfeito: Atualiza automaticamente as datas de vencimento das faturas para evitar coincidências com finais de semana e feriados nacionais.
✓ Calendário Completo: Armazena o calendário anual de feriados nacionais do ano atual e do próximo, diretamente no banco de dados do WHMCS.
✓ Atualização Automática: Obtém e atualiza dados de feriados da Brasil Api quando o módulo é ativado, e atualiza a listagem de feriados anualmente.
✓ Personalização: Adicione sua própria lista de feriados customizada com facilidade. (saiba mais);

Documentação
Instalação do módulo no WHMCS
- Copie a pasta
/modules/addons/gofasferiados/
para dentro do diretório padrão de módulos addons do WHMCS:/whmcs/modules/addons/
. - Ative o Addon em
Opções > Módulos Addons
; - Insira a chave de licença, salve e pronto. Agora mais nenhuma fatura terá a data de vencimento em finais de semana e feriados.

Editar lista de feriados (avançado/opcional)
A lista com todos os feriados nacionais do ano atual e do próximo ano é obtida através de um serviço externo gratuito fornecido pela Brasil API, mas opcionalmente, você pode definir sua própria lista de feriados. Caso deseje evitar que o vencimento das as faturas caia em feriados estaduais, municipais ou qualquer outra data de sua preferência. Siga os passos a seguir para editar a lista de feriados.
- Renomeie o arquivo
holidays.json.example
localizado na pasta/modules/addons/gofasferiados/
paraholidays.json
- Edite adicionando um novo bloco aos dois anos listados no arquivo
holidays.json
mantendo o seguinte formato (a ordem da lista não importa):
{
"2024":[
{
"date":"2024-09-18",
"name":"Aniversário da minha cidade",
"type":"national"
} - Compare o seu arquivo com os exemplos:
Importante:
- Ao definir feriados no arquivo holidays.json os feriados armazenados no banco de dados são ignorados.
- Lembre-se de incluir/manter na lista o ano atual e o ano seguinte;
- Use um validador de arquivos json antes de subir o arquivo para produção (jsonformatter.curiousconcept.com);
Informações importantes
- Versão mínima do WHMCS:
8.6
; - Versão mínima do PHP:
8.1
; - Dados obtidos através da Brasil API
Histórico de atualizações
v1.1.0 (03/03/2025)
Implemented enhancements:
- Compatibilidade com PHP 8.2 e 8.3 #3
v1.0.0 (31/08/2024)
Implemented enhancements:
- Lançamento 🎉 #1
* This Changelog was automatically generated by github_changelog_generator
1 comentário
Deixe um Comentário
Você precisa fazer login para publicar um comentário.
Módulo espetacular! Resolveu todos os meus problemas de emissão considerando datas válidas para pagamento. Depois da aquisição nunca mais tive um cliente chamando com dificuldade de pagar uma fatura vencida em finais de semana e feriados. Parabéns Maurício por mais um excelente trabalho.