Módulo WHMCS Gerencianet nova API - Boleto

[LucianoZ]

1 minuto atrás, kammabranding disse:

Não é esse o problema. Minha conta no gerencianet é empresarial e está tudo correto. Quero é mostrar os dados empresariais do cliente no boleto apenas

No painel não achei nada ..

Devem ter retirado, faz bastante tempo isso, mas de uma ligada para o 0800 deles, são bem rápidos ou crie um ticket com a solicitação, isso se você deseja mostrar os dados empresarial da sua empresa no sacador em baixo do boleto.

Caso for para exibir apenas os dados do cliente no Boleto no caso a emissão vai para PJ do cliente, basta ter o campo CNPJ e Empresa do WHMCS para que possa funcionar.

[kammabranding]

20 minutos atrás, LucianoZ disse:

Devem ter retirado, faz bastante tempo isso, mas de uma ligada para o 0800 deles, são bem rápidos ou crie um ticket com a solicitação, isso se você deseja mostrar os dados empresarial da sua empresa no sacador em baixo do boleto.

Caso for para exibir apenas os dados do cliente no boleto no caso a emissão vai para PJ do cliente, basta ter o campo CNPJ e Empresa do WHMCS para que possa funcionar.

Entao, o problema é esse. Os dados estão preenchidos (CNPJ e EMPRESA) mas aparece no boleto apenas o CPF e nome do cliente...

[LucianoZ]

26 minutos atrás, kammabranding disse:

Entao, o problema é esse. Os dados estão preenchidos (CNPJ e EMPRESA) mas aparece no boleto apenas o CPF e nome do cliente...

Você marcou a opção no módulo?
Tentou criar uma nova fatura depois para poder ver se atualizou?

[kammabranding]

2 horas atrás, LucianoZ disse:

Você marcou a opção no módulo?
Tentou criar uma nova fatura depois para poder ver se atualizou?

Vou fazer estes testes de gerar uma nova fatura..

[gofas]

15 horas atrás, kammabranding disse:

@gofas 

Na opção " Quando consta empresa e CNPJ no cadastro do cliente, o sistema obriga o envio também do nome e CPF da pessoa física que está concretizando o pagamento em nome da empresa. " Se eu deixar desmarcado, o boleto é gerado normalmente e não tem problemas no gerencianet? Obrigado!

Oi galera, essa opção tem uma longa história, deixa eu tentar explicar, no final vocês podem até sugerir uma edição no texto para ficar mais claro como funciona.

Se você ativar a opção "Exigir CPF e CNPJ de Pessoa Jurídica", obrigatoriamente, vc precisa:
1) configurar dois campos personalizados no perfil do cliente, um apenas para CPF e outro apenas para CNPJ;
2) apontar a ordem desses dois campos na configuração "Ordem do campo CPF e/ou CNPJ" e "Ordem do campo CNPJ";
3) obrigar os clientes que desejam pagar com CNPJ a preencher também o campo CPF, com essa opção ativa, se o cliente possui CNPJ mas não possui CPF, será exibido um erro avisando que o cliente precisa fornecer também o CPF para concretizar o pagamento.
Essa opção é uma forma de sempre associar uma pessoa física à transação realizada em nome da empresa.
Sobre a exibição dos dados do cliente, se essa opção estiver marcada, será exibido o CPF, nome e sobre nome do cliente no Boleto, o CNPJ e nome da empresa ficam gravados apenas no log da GN API.

Agora, se a opção "Exigir CPF e CNPJ" estiver desativada, o módulo faz o reconhecimento dos dados do cliente e gera a transação de acordo com os dados fornecidos.
As configurações "Ordem do campo CPF e/ou CNPJ" e "Ordem do campo CNPJ", informam ao módulo onde procurar e analisar essas informações.
A partir disso, existem 32 possibilidades diferentes que o módulo analisa antes de decidir qual informação irá usar para gerar a transação, o resultado final depende dos dados fornecidos e da ordem de prioridade que o módulo dá às informações.
Alguns exemplos de como a análise e prioridade funcionam:
1) se o cliente possui o campo CNPJ e Nome da Empresa preenchidos no cadastro, esses serão os dados que o módulo vai usar na primeira tentativa de gerar o boleto;
2) mas se a API não aceitar o CNPJ e/ou Nome da Empresa, o módulo tenta gerar o boleto novamente usando o CPF e/ou nome do cliente, se esses dados também existirem no cadastro do cliente;
3) da mesma forma que o módulo tenta gerar o boleto com o CNPJ, ele tenta associar o valor do campo Nome da Empresa ao boleto, mas se o cliente possui CNPJ mas não possui "Nome da empresa" preenchido no cadastro, o módulo substitui esse campo pelo Nome e Sobrenome do cliente, enviando para API o nome do cliente no lugar do nome da empresa;

Se você utiliza apenas um campo personalizado para CPF e CNPJ, vc não deve ativar a opção "Exigir CPF e CNPJ de Pessoa Jurídica", isso ira retornar um erro, afinal, não tem como exigir dois documentos se vc só usa um campo personalizado.
Se você utiliza apenas um campo personalizado para CPF e CNPJ, serão realizadas outras verificações e variações de uso das informações cadastrais dos clientes, semelhantes às descritas acima, além da verificação que determina se o documento é um CPF ou CNPJ pela quantidade de caracteres, mantendo a prioridade de uso dos dados ao tentar gerar o boleto (1ª tentativa com CNPJ + Nome da Empresa, 2º CNPJ + Nome do cliente, etc...)

Mas por que existe a opção "Exigir CPF e CNPJ de Pessoa Jurídica"?

Quem já usa o módulo desde as primeiras versões, deve lembrar que "antigamente", ao gerar uma cobrança como pessoa jurídica (CNPJ), era obrigatório o envio à GN API também dos dados da pessoa física que estava concretizando o pagamento (CPF).
Mas depois de um tempo a Gerencianet mudou essa regra, passando a permitir o envio apenas do CNPJ, como já haviam usuários usando o módulo com os campos CPF e CNPJ, eu achamos melhor apenas tornar o envio dos dois documentos opcional, para que os usuários do módulo não tivessem que alterar a estrutura do cadastro dos clientes devido a atualização do módulo. Descobrimos também que mesmo sendo opcional o envio dos dois documentos, existem usuários que preferem forçar o envio de CPF e CNPJ quando a cobrança é realizada em nome de empresa.

O módulo é repleto de funcionalidades complexas que na maioria dos casos passa despercebido,
a dica é muito cuidado com cada opção e teste todas as possibilidades que você imaginar, principalmente se tratando recursos que trabalham com dados inseridos pelos clientes nos formulários de cadastro, sempre pode haver alguma inconsistência que deve ser prevista.

Todo mundo entendeu?

[Joel Emanoel]

16 horas atrás, gofas disse:

Oi galera, essa opção tem uma longa história, deixa eu tentar explicar, no final vocês podem até sugerir uma edição no texto para ficar mais claro como funciona.

Se você ativar a opção "Exigir CPF e CNPJ de Pessoa Jurídica", obrigatoriamente, vc precisa:
1) configurar dois campos personalizados no perfil do cliente, um apenas para CPF e outro apenas para CNPJ;
2) apontar a ordem desses dois campos na configuração "Ordem do campo CPF e/ou CNPJ" e "Ordem do campo CNPJ";
3) obrigar os clientes que desejam pagar com CNPJ a preencher também o campo CPF, com essa opção ativa, se o cliente possui CNPJ mas não possui CPF, será exibido um erro avisando que o cliente precisa fornecer também o CPF para concretizar o pagamento.
Essa opção é uma forma de sempre associar uma pessoa física à transação realizada em nome da empresa.
Sobre a exibição dos dados do cliente, se essa opção estiver marcada, será exibido o CPF, nome e sobre nome do cliente no boleto, o CNPJ e nome da empresa ficam gravados apenas no log da GN API.

Agora, se a opção "Exigir CPF e CNPJ" estiver desativada, o módulo faz o reconhecimento dos dados do cliente e gera a transação de acordo com os dados fornecidos.
As configurações "Ordem do campo CPF e/ou CNPJ" e "Ordem do campo CNPJ", informam ao módulo onde procurar e analisar essas informações.
A partir disso, existem 32 possibilidades diferentes que o módulo analisa antes de decidir qual informação irá usar para gerar a transação, o resultado final depende dos dados fornecidos e da ordem de prioridade que o módulo dá às informações.
Alguns exemplos de como a análise e prioridade funcionam:
1) se o cliente possui o campo CNPJ e Nome da Empresa preenchidos no cadastro, esses serão os dados que o módulo vai usar na primeira tentativa de gerar o boleto;
2) mas se a API não aceitar o CNPJ e/ou Nome da Empresa, o módulo tenta gerar o boleto novamente usando o CPF e/ou nome do cliente, se esses dados também existirem no cadastro do cliente;
3) da mesma forma que o módulo tenta gerar o boleto com o CNPJ, ele tenta associar o valor do campo Nome da Empresa ao boleto, mas se o cliente possui CNPJ mas não possui "Nome da empresa" preenchido no cadastro, o módulo substitui esse campo pelo Nome e Sobrenome do cliente, enviando para API o nome do cliente no lugar do nome da empresa;

Se você utiliza apenas um campo personalizado para CPF e CNPJ, vc não deve ativar a opção "Exigir CPF e CNPJ de Pessoa Jurídica", isso ira retornar um erro, afinal, não tem como exigir dois documentos se vc só usa um campo personalizado.
Se você utiliza apenas um campo personalizado para CPF e CNPJ, serão realizadas outras verificações e variações de uso das informações cadastrais dos clientes, semelhantes às descritas acima, além da verificação que determina se o documento é um CPF ou CNPJ pela quantidade de caracteres, mantendo a prioridade de uso dos dados ao tentar gerar o boleto (1ª tentativa com CNPJ + Nome da Empresa, 2º CNPJ + Nome do cliente, etc...)

Mas por que existe a opção "Exigir CPF e CNPJ de Pessoa Jurídica"?

Quem já usa o módulo desde as primeiras versões, deve lembrar que "antigamente", ao gerar uma cobrança como pessoa jurídica (CNPJ), era obrigatório o envio à GN API também dos dados da pessoa física que estava concretizando o pagamento (CPF).
Mas depois de um tempo a Gerencianet mudou essa regra, passando a permitir o envio apenas do CNPJ, como já haviam usuários usando o módulo com os campos CPF e CNPJ, eu achamos melhor apenas tornar o envio dos dois documentos opcional, para que os usuários do módulo não tivessem que alterar a estrutura do cadastro dos clientes devido a atualização do módulo. Descobrimos também que mesmo sendo opcional o envio dos dois documentos, existem usuários que preferem forçar o envio de CPF e CNPJ quando a cobrança é realizada em nome de empresa.

O módulo é repleto de funcionalidades complexas que na maioria dos casos passa despercebido,
a dica é muito cuidado com cada opção e teste todas as possibilidades que você imaginar, principalmente se tratando recursos que trabalham com dados inseridos pelos clientes nos formulários de cadastro, sempre pode haver alguma inconsistência que deve ser prevista.

Todo mundo entendeu?

Entendido sr. Gofas :). Obrigado pela explicação.

[gofas]

E aí pessoal, tudo beleza!?

Passei para avisar que tem atualização disponível para o módulo, incluímos novas opções, como por ex.: juros/multa e várias outras melhorias, foi praticamente uma reconstrução:
https://gofas.net/blog/atualizacao-modulo-gerencianet-boleto-para-whmcs-v0-2-3/

[kammabranding]

Em 09/11/2016 at 15:29, gofas disse:

E aí pessoal, tudo beleza!?

Passei para avisar que tem atualização disponível para o módulo, incluímos novas opções, como por ex.: juros/multa e várias outras melhorias, foi praticamente uma reconstrução:
https://gofas.net/blog/atualizacao-modulo-gerencianet-boleto-para-whmcs-v0-2-3/

Para atualizar, basta substituir os arquivos ? Ou precisa algo em especial?

No momento estou com um cliente que não consegue emitir um boleto.

Aparece erro:  Erro: 4600027 C C

 

obrigado

 

 

[gofas]

E aí galera, quanto tempo hein!?

As coisas estão cada vez mais agitadas com os módulos para WHMCS no gofas.net, por isso eu acabei pulando 3 atualizações sem avisar o pessoal que acompanha aqui no fórum.

Lançamos ontem a 19ª release, o Módulo Gerencianet Boleto para WHMCS está atualmente na versão 0.2.6,
a última atualização traz melhorias na verificação da origem da requisição ao script do módulo,
para impedir que as funções do módulo sejam executadas ao gerar faturas e emails em massa, evitando assim a interrupção de processos que possam invocar as funções do módulo. (Gratidão aoLuis Augustopela contribuição )

Quem perdeu as últimas atualizações, acesse o histórico completo de atualizações.

Obs.: O módulo PayPal Plus para WHMCS também foi atualizado para impedir a mesma falha.

Gratidão!

Em 02/01/2017 em 11:24, kammabranding disse:

Para atualizar, basta substituir os arquivos ? Ou precisa algo em especial?

No momento estou com um cliente que não consegue emitir um boleto.

Aparece erro:  Erro: 4600027 C C

 

obrigado

 

 

Basta substituir os arquivos, mas é bom seguir estas recomendações.
Assim como é recomendado fazer todos os testes e atualizações, do WHMCS e de qualquer outro módulo, numa instalação "beta", como citei nesse post.

[gofas]

Para quem acompanha esse tópico, temos um novo módulo de integração com a Gerencianet,
o módulo Gerencianet Cartão para WHMCS.
O módulo suporta pagamentos recorrentes e pessoas físicas ou jurídicas podem usar, com ativação instantânea, ou seja, sem precisar aguardar homologação:
https://gofas.net/blog/whmcs/modulo-gerencianet-cartao-para-whmcs-checkout-transparente-e-pagamento-recorrente/