MÓDULO BOLETO FÁCIL PARA WHMCS

O módulo de integração Gofas Boleto Fácil para WHMCS é um software gratuito, desenvolvido para turbinar a gestão de criação de boletos registrados via WHMCS. Oferece o que há de melhor para gerar boletos personalizados diretamente do nosso sistema de cobranças favorito.

Boleto Fácil (BoletoBancario.com) é uma intermediadora de pagamentos sem burocracia, onde qualquer pessoa ou empresa pode gerar boletos hoje mesmo com nosso módulo de integração para WHMCS.

DIVERSAS OPÇÕES DE VIZUALIZAÇÃO

OPÇÕES PARA DIVERSOS MODELOS DE NEGÓCIO

Cobranças com seu CPF ou CNPJ, sem carteira de cobrança e sem burocracia

✓ Juros e multas após o vencimento do boleto

✓ 2ª via automática com valor atualizado (cálculo de multa e juros) ao acessar a fatura

✓ Boleto com suas cores e logotipo

✓ Linha digitável e informações do boleto nos emails das faturas

✓ Link direto para o boleto no email sem necessidade de módulos extra (autologin)

✓ Redireciona (ou não) para o boleto ao acessar a fatura

✓ Dispensa configurações de campos personalizados (CPF/CNPJ)

✓ Notifica administradores do WHMCS sobre erros ao gerar boletos

✓ Exibe a linha digitável do boleto na fatura, com opção de copiar apenas com um clique;

✓ Imagem personalizada para o botão "Finalizar Pagamento"

✓ Desconto por método de pagamento

✓ Desconto para pagamento X dias antes do vencimento

✓ Descontos personalizados em R$ e % diretamente no perfil de clientes específicos

✓ Permite adicionar tarifa adicional / boleto*

✓ Exibe(ou não) na fatura informações de desconto, taxas e demais cálculos

✓ Confirmação de pagamento e da baixa nas faturas pagas automaticamente

E tem mais, o nosso módulo foi desenvolvido para superar limitações encontradas na maioria dos módulos semelhantes e do próprio WHMCS, com uma configuração simplificada e objetiva mas ao mesmo tempo completa. O módulo Gofas Boleto Fácil para WHMCS possui 25 opções projetadas para atender os mais variados modelos de negócio e trabalha em harmonia com outros módulos e com os recursos nativos do WHMCS,  é optimizado para grandes cargas de trabalho e foi testado em produção no WHMCS 7.2 ao 7.6.1.

INFORMAÇÕES DO BOLETO NOS EMAILS

PAINEL DE GERENCIAMENTO REMOTO DE FUNÇÕES DA API

Painel-de-gerenciamento-remoto-API-Boleto-Fácil-

TARIFA PROMOCIONAL

Boleto: R$2,50 fixo por boleto pago;
Cartão de Crédito: 4,79% + R$0,50 - Liberação dos valores em 7 dias  - Pagamentos à vista ou recorrência;
Tarifas válidas para usuários do nosso módulo de integração e para novos clientes que realizarem cadastro neste endereço.

REQUISITOS DO SISTEMA

  1. WHMCS versão 6.3 ou superior;
  2. PHP 5.6 ou superior

INSTALAÇÃO

Para usufruir de todos os recursos da integração, você deverá instalar 2 módulos distintos que trabalham em conjunto, o módulo Gateway Gofas Boleto Fácil + o Módulo Addon Gofas Boleto Fácil.

Ao descompactar o arquivo do download, observe que os diretórios foram distribuídos seguindo a mesma hierarquia dos diretórios padrão do WHMCS, o arquivo + pasta do módulo Gateway está localizado no diretório /modules/gateways/ e a pasta do módulo Addon está localizada no diretório /modules/addons/. Siga os passos a seguir se precisar de mais detalhes:

  1. Faça download do módulo (requer login);
  2. Descompacte o arquivo .zip;
  3. Instalação do Addon: Copie o diretório gofasboletofacil localizado na pasta /modules/addons/ do arquivo recém descompactado, para a pasta /modules/addons/ da instalação do WHMCS;
  4. Instalação do Gateway: Copie o arquivo gofasboletofacil.php + o diretório /gofasboletofacil/, localizados na pasta /modules/gateways/ do arquivo recém descompactado, para a pasta /modules/gateways/ da instalação do WHMCS;

PRÉ CONFIGURAÇÃO

  1. Crie um campo personalizado de cliente para CPF e/ou CNPJ, ou se preferir, crie dois campos distintos, um campo apenas para CPF e outro campo para CNPJ. O módulo identifica os campos do perfil do cliente automaticamente;

  2. Opcional: Crie dois campos personalizados se desejar oferecer descontos personalizados para clientes específicos, semelhantes aos campos nesta imagem.

  3. Ative o Addon em Opções > Módulos Addons > Localize o módulo "Gofas Boleto Fácil" > Clique em Ativar > Após ativar, clique em "Configurar" > assinale os grupos de administradores ou operadores que terão permissão para acessar o módulo > clique em "Salvar alterações".;

  4. Ative o Gateway em Opções > Pagamentos > Portais de Pagamento > Aba "All Payment Gateways" > Clique em "Gofas - Boleto Fácil";

  5. Defina o nome de exibição do método de pagamento, exemplo: "Boleto Bancário".Após esses passos básicos, sigas as instruções a seguir atentamente para entender como funciona cada configuração do módulo.

 

CONFIGURAÇÕES DO MÓDULO

  1. Live Token: (Obrigatório) Token gerado em boletobancario.com para ser utilizado na integração, é a senha de acesso à API Boleto Fácil OBTER TOKEN;

  2. Sandbox Token: (Obrigatório) Token gerado em sandbox.boletobancario.com para ser utilizado na integração em modo de TESTES. OBTER SANDBOX TOKEN

  3. Sandbox:  Ative essa opção para gerar cobranças em modo de testes. Recomendamos fortemente que sejam realizados testes em modo sandbox simulando cada possível situação configurada no módulo, para que o administrador do WHMCS esteja familiarizado com cada situação que envolvem cálculos de taxas, descontos, juros, multas, descontos personalizados, datas de vencimento para segunda via, data máxima de pagamento, etc, assim como todas as demais funcionalidades.

  4. Debug: (não use em produção) Mostra informações de diagnóstico na tela de exibição das Faturas (veja o exemplo). Essas informações servem para verificar todas as informações "cruas" processadas pelo módulo na página de vizualização das faturas;

  5. Salvar Logs:  Salva informações de diagnóstico em Utilitários > Logs > Log de Módulo. Para funcionar, antes é necessário ativar o debug de módulo clicando em "Ativar Log de Debug"  na página "Log de Módulo" do painel administrativo do WHMCS;

  6. Valor mínimo do Boleto:  Insira o valor total mínimo da fatura para permitir pagamento via Boleto. Formato: Decimal, separado por ponto. Maior ou igual a sua tarifa (a partir de 2.50) e menor ou igual a 1000000.00.

  7. Informações do Boleto no email:  Adiciona link, linha digitável, vencimento e outras informações do boleto no corpo dos emails de faturas. Essa opção faz o módulo gerar os boletos no momento em que a fatura é gerada, (do contrário o Boleto é gerado no 1º acesso à Fatura). Veja aqui a lista de tags de mesclagem dosponíveis. Para habilitar essa opção antes você precisa instalar e ativar o módulo addon Gofas Boleto Fácil.

  8. Link direto para o Boleto no email:  Substitui o URL padrão gerado pela merge tag {$invoice_link}, do template de email de faturas, pelo URL do boleto, nos emails de nova cobrança e de lembretes de atraso.

  9. Dias adicionais para novo vencimento:  Número de dias que serão somados a data do vencimento do Boleto, ao gerar segunda via do boleto ou quando o cliente acessa uma fatura vencida. Essa opção aplica-se apenas a Faturas vencidas, faturas que ainda não venceram sempre irão gerar Boletos com a mesma data de vencimento da Fatura. As configurações de juros e multa anulam essa configuração.

  10. Máximo de dias para o pagamento:  Número máximo de dias que o boleto poderá ser pago após o vencimento. Zero significa que o boleto não poderá ser pago após o vencimento. Formato: Número inteiro maior ou igual a 0 e menor ou igual a 29. Exemplo: se você configurou esse campo com 5 e o boleto foi gerado com o vencimento para 01/12/2018, será adicionada a instrução ao boleto "Não receber após 06/12/2018". Exemplo 2: se você configurou esse campo com zero e o boleto foi gerado com o vencimento para 01/12/2018, será adicionada a instrução ao boleto "Não receber após o vencimento";

  11. Notificar suporte do WHMCS sobre erros:  Escolha o departamento de suporte que receberá notificação por email quando houver erros ao gerar o boleto. Esse recurso possibilita uma tomada de ação antes que o cliente contacte o suporte ou desista da compra, como por exemplo, quando o boleto não é gerado por um erro de cadastro do cliente.

  12. Desconto ou Taxa:  Escolha de deseja oferecer desconto ou acrescentar taxa para pagamentos via Boleto. Nota: Todos sabemos que cobrar taxa para emissão de boleto é proibido, por isso essa funcionalidade leva esse nome para auxiliar na contabilidade interna do WHMCS mas deve ser apresentada ao cliente de forma que de a entender que,é oferecido um desconto ao optar por outro método de pagamento diferente de boleto;

  13. Tipo de Desconto ou Taxa:  Valor em R$ ou % que será abatido ou acrescentado do valor total das faturas;

  14. Valor do Desconto ou da Taxa:  Valor em R$ ou % que será abatido ou acrescentado do valor total das faturas;

  15. Validade do Desconto:  Dias concedidos de desconto para pagamento antecipado. Exemplo: Desconto válido para pagamento até 10 dias antes do vencimento. Deixe em branco para aplicar desconto mesmo após o vencimento, insira 0 (zero) para aplicar desconto até a data de vencimento da fatura ou insira um número igual ou maior que 1 que será a validade do desconto Nota: Ao ativar essa opção a data de vencimento do boleto será antecipada e será adicionada ao boleto a instrução "não aceitar pagamento após o vencimento";

  16. Campo do Perfil "Valor do Desconto Personalizado":  Escolha o Campo Personalizado de Clientes usado para aplicar descontos diferentenciados para clientes específicos. Formato: Decimal, separado por ponto. Maior ou igual a 0.00 e menor que o valor da cobrança.

  17. Campo do Perfil "Tipo de Desconto Personalizado":  Selecione o ampo Personalizado de Clientes que define o tipo de desconto personalizado em R$(Reais) e %(Porcentagem). Veja aqui como configurar os Campos Personalizados de Clientes para aplicar corretamnete o desconto personalizaodo.

  18. Multa após o vencimento:  Multa ( %/mês ) para pagamento após o vencimento. Formato: Decimal, separado por ponto. Maior ou igual a 0.00 e menor ou igual a 20.00 (2.00 é o valor máximo permitido por lei). Valor padrão: 0.00;

  19. Juros após o vencimento:  Juro ( %/mês ) para pagamento após o vencimento. Formato: Decimal, separado por ponto. Maior ou igual a 0.00 e menor ou igual a 20.00 (1 é o valor máximo permitido por lei, 1% ao mês equivale a 0.033% ao dia). Valor padrão: 0.00.

  20. Exibir linha digitável na Fatura:  Exibe a linha digitável/código de barras do Boleto na fatura, abaixo do botão "visualizar boleto";

  21. Exibir data de Vencimento:  Exibe a data de vencimento do Boleto na fatura, abaixo do botão "visualizar boleto";

  22. Exibir data máxima para pagamento:  Exibe data máxima que o boleto poderá ser pago após o vencimento;

  23. Exibir Descontos e Acréscimos: Exibe desconto, taxa, multa e juros na Fatura e no Boleto;
  24. Redirecionar para o Boleto:  Redireciona o cliente diretamente para o URL do boleto ao acessar a fatura;

  25. Imagem do botão "Visualizar Boleto": Insira o URL da imagem que será usada como botão "Visualizar Boleto" (tamanho recomendado: 160x43px).

TAGS DE MESCLAGEM

Utilize as mergetags geradas pelo módulo addon para exibir informações do Boleto nos emails de Faturas do WHMCS.

Para adicionar as tags edite os templates de email referentes à faturas em WHMCS admin > Opções > Modelos de Email.

As tags de mesclagem permitem adicionar um bloco html ao email com as principais informações do boleto, ou cada informação separadamente, para auxiliar na formatação do texto dos emails.

Tags disponíveis

{$gbf_link}: Exibe o URL do boleto;

{$gbf_barcode}: Exibe a linha digitável do Boleto (nº que forma o código de barras);

{$gbf_due_date}: Exibe a data de vencimento do Boleto;

{$gbf_amount}: Exibe o valor total do Boleto;

{$gbf_code}: Exibe o código do Boleto(ID registrado na API Juno);

{$gbf_billet_info}: Exibe um bloco com as principais informações sobre o boleto;

DOWNLOAD GRATUITO

Ao baixar esse módulo você concorda com nosso contrato de licenciamento de softwareEsse módulo foi desenvolvido com amor e cedido gratuitamente para download sob os termos da nossa licença, que nos eximem de qualquer responsabilidade por erros, perdas e danos que nosso software possa causar no sistema do usuário. Também é importante salientar que não damos garantia de suporte e não nos comprometemos em prestar qualquer atendimento para usuários dos nossos produtos e serviços gratuitos.

ATUALIZAÇÕES

  • v1.0.3
    • Melhorada a verificação de faturas no callback.
  • v1.0.2
    • Corrigida a funcionalidade que obtinha dados de todos os clientes, ao consultar o nº do documento associado à fatura do WHMCS;
    • Corrigida a funcionalidade que define o nome do cliente com "Nome + Sobrenome" ou "Nome da Empresa" de acordo com o tipo de documento.
  • v1.0.1
    • Aprimoramento no obtenção do CPF e/ou CPNJ do banco de dados a partir do nome do campo personalizado do WHMCS;
  • v1.0.0
    • Lançamento.

Atualizações por email

Digite seu endereço de email para ser notificado por e-mail sempre que o módulo fora atualizado.

Deixe seu Comentário

Você precisa fazer login para comentar.