Ir para o conteúdo

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);

gofas_feriados_admin

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.
gofas_feriados_config

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.

  1. Renomeie o arquivo holidays.json.example localizado na pasta /modules/addons/gofasferiados/ para holidays.json
  2. 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"
            }

  3. Compare o seu arquivo com os exemplos:
    1. Clique aqui para visualizar o arquivo com a lista de feriados fornecida pela Brasil API;
    2. Clique aqui para visualizar o arquivo editado incluindo o exemplo customizado acima.

Importante:

  1. Ao definir feriados no arquivo holidays.json os feriados armazenados no banco de dados são ignorados.
  2. Lembre-se de incluir/manter na lista o ano atual e o ano seguinte;
  3. Use um validador de arquivos json antes de subir o arquivo para produção (jsonformatter.curiousconcept.com);

Informações importantes

  1. Versão mínima do WHMCS: 8.6;
  2. Versão mínima do PHP: 8.1;
  3. Dados obtidos através da Brasil API

Histórico de atualizações

Changelog

v1.1.0 (03/03/2025)

Full Changelog

Implemented enhancements:

  • Compatibilidade com PHP 8.2 e 8.3 #3

v1.0.0 (31/08/2024)

Full Changelog

Implemented enhancements:

  • Lançamento 🎉 #1

* This Changelog was automatically generated by github_changelog_generator

1 comentário

  1. Mario em 14/03/2025 às 12:59

    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.

Deixe um Comentário

Você precisa fazer login para publicar um comentário.

Role para cima