Atualização: Módulo Gerencianet Boleto para WHMCS v2.2.1

Atualização: Módulo Gerencianet Boleto para WHMCS v2.2.1

Reformulamos o módulo Gerencianet Boleto para WHMCS, essa é a maior atualização desde a última versão disponibilizada (v1.2.3) e a versão que apresentamos hoje (v2.2.1). Foram adicionadas diversas funcionalidades novas e várias áreas foram melhoradas.

Agradecemos a todos os usuários que contribuíram com a evolução desse software, em especial à Jr Infra que financiou a funcionalidade de inclusão das informações do boleto no email, entre outras melhorias, agradecemos também à Go Suite que financiou a possibilidade de inclusão de configurações personalizados e mais duas opções ao módulo para evitar a criação de boletos ao gerar a fatura, em casos específicos (mais detalhes a seguir).

Os destaques da nova versão do módulo:

1. Informações do boleto no email. Agora em conjunto com o addon Gerencianet que acompanha o pacote de download, opcionalmente, o módulo gera o boleto quando a fatura é gerada e fornece mergetags para os modelos de email de faturas que, exibem diretamente no corpo do email enviado ao cliente, a linha digitável, link para versão em HTML e PDF, data de vencimento e ID do boleto. Agora o cliente nem precisa sair do email para realizar o pagamento;
   
2. Link direto para o Boleto utilizando a tag padrão {$invoice_link} dos templates de email. Essa opção substitui automaticamente os links das faturas nos emails, pelo link direto para o Boleto, sem necessidade de redirecionamentos ou autenticação;
3. Aviso de atualização e verificação de versão diretamente nas configurações do módulo;
4. Campos de configurações customizadas (avançado). Agora é possível (com conhecimento básico em php), incluir , funções e alterar o funcionamento do gateway, sem editar diretamente o código original, apenas incluindo as customizações em pastas específicas do módulo. Dessa forma é possível atualizar o módulo no futuro sem perder as alterações. Como demonstração do funcionamento das opções personalizadas, oferecemos duas customizações cedidas generosamente pela Go Suite e mais uma customização criada por nós para contornar a situação descrita neste tópico do fórum. Vaja as customizações e saiba mais sobre como incluir configurações adicionais e manipular as variáveis do módulo neste artigo.
5. – Debug no log de módulo do WHMCS. Agora o módulo além de exibir informações de diagnóstico na tela das faturas, também oferece a opção de salvar o debug no log de módulo do WHMCS;
   
   
6. – Cancelar o Boleto anterior ao gerar um novo. Diferente da opção já existente que cancelava o boleto apenas quando já havia vencido;
7. Cancela o Boleto ao cancelar Fatura. Dispensa a necessidade de acessar o painel de controle Gerencianet para cancelar um boleto, basta cancelar a fatura no WHMCS e o boleto associado à ela será cancelado também;
8. – Melhoria nos cálculos de taxas, descontos, multa, juros, crédito e demais valores variáveis que devem ser calculados nas mais variadas hipóteses;
9. – Exibe mais informações na Fatura, sobre descontos, multa , juros, taxas, etc;
10. – Taxas exibidas como itens de linha no boleto;
11. – Descrição do serviço agora são exibidas nas linhas/itens do Boleto quando há taxas adicionais configuradas (antes era exibido Fatura ID #XX)
12. – Gera novo boleto ao aplicar crédito à fatura, (e cancela o anterior se a opção descrita no item 7 estiver ativada) ou quando o valor da fatura mudou e já existe um boleto associado à essa fatura;
13. – Opções numeradas nas configurações, para localização mais rápida;
14. – Mais opções de redirecionamento para o Boleto: Ao adicionar o parâmetro redirectToBillet=true no URL da fatura, o cliente será redirecionamento para o boleto ao acessar a fatura e ao adicionar o parâmetro redirectToBillet=false no URL da fatura (se a opção de redirecionamento estiver ativada nas configurações do módulo), o redirecionamento da fatura para o boleto será desativado apenas para essa fatura. Muito útil para aditar os templates de email, adicionando regras de redirecionamento para o boleto específicas para cada situação
    Exemplo 1: substitua a tag {$invoice_link} por {$invoice_link}&redirectToBillet=false nos templates de email e será formado um URL semelhante a este:

    https://whmcs.gofas.net/viewinvoice.php?id=138&redirectToBillet=false

    Exemplo 2: Digamos que você não deseja redirecionar para o boleto clientes que possuem crédito, para que os mesmos acessem a fatura e adicionem o crédito manualmente, utilize as tags dessa forma no template de email:

    {if {$client_credit} }
{$invoice_link}&redirectToBillet=false
{else}
{$invoice_link}&redirectToBillet=true
{/if}
15. Copiar a linha digitável do boleto com um clique;
    
    
16. Copiar debug com um clique;
17. Obtém CPF e CNPJ sem necessidade de configuração, agora o módulo detecta automaticamente os campos personalizados de cliente referentes ao CPF e CNPJ
18. Selecionar os campos de perfil do cliente em um menu suspenso, quando requeridos nas configurações do módulo, ao invés de definir o nº de ordem , ID ou qualquer informação confusa ou complexa de obter como no passado, agora é exibido um menu com todos os campos personalizados existentes no WHMCS, onde o só admin só precisa selecionar o custom field;
    
    
19. Selecionar o departamento de suporte com um clique na opção “Notificar suporte do WHMCS sobre erros” das configurações do módulo. Semelhante a opção anterior, agora o módulo obtém uma lista dos departamentos de suporte configurados para o administrador selecionar;
    
20. Removida a opção CPF + CNPJ para Pessoa Jurídica por não ser mais obrigatória ao usar a API Gerencianet;
21. Corrigido o link que aponta para a área do cliente em caso de erros, quando o admin do WHMCS não definiu nas configurações gerais do WHMCS o URL da instalação incluindo o diretório da instalação.
22. Módulo Addon Gerencianet atualizado,
    1. Agora ele é compatível com as versões mais recentes do gateway e do WHMCS
    2. Traz os hooks necessários para ações em segundo plano (como gerar o boleto ao gerar a fatura)
    3. Corrigido o erro que estava atrapalhando o cancelamento dos Boletos a partir do ID da fatura
23. Corrigido o erro que subtraia R$0,01 nos cálculos de juros + multa + taxa – desconto/crédito, em versões específicas do php e php-fpm;
24. Melhoria no callback de boletos com desconto, agora o módulo edita a fatura adicionando um item de linha com o mesmo valor do desconto evitando que a fatura fique em aberto.

Voltamos em breve com mais novidades, agradecemos o feedback!