Controllr/Aplicativos/Financeiro/Formas de Pagamento/Efí

De BrByte Wiki

Marca-gerencianet b.pngGerencianet

O Gateway Gerencianet é a opção de pagamento para os clientes que trabalha de forma automática, tanto na criação da cobrança quanto em sua baixa, a vantagem do gateway de pagamento é que não há necessidade de Remessa ou Retorno bancário para processar/registrar as cobranças, com gateway, todas estas ações são realizadas online.


Controllr-financeiro-app-formasdepagamento-gerencianet.png


Novo
Campo Descrição Exemplo
Habilitado Marque para ativar essa forma de pagamento.
Padrão Marque para que no ato de cadastrar um contrato, já venha marcado esse banco padrão.
Boleto Marque para ativar essa forma de pagamento.
Enviar cobranças por E-mail Ao marcar, quando a cobrança for criada no Gerencianet, o próprio Gateway enviará o e-mail contendo a cobrança para o seu cliente, desde que o e-mail do mesmo seja válido.
Depurar Ao habilitar permite que a equipe de suporte obtenha mais informações sobre a comunicação e requisição de informações com o Gerencianet. Habilite apenas se instruído pela equipe de suporte da Brbyte.
Instituição Instituição Financeira a ser cadastrada. Gerencianet
Identificação Nome da conta do seu Gerencianet Gerencianet Teste
Client ID ID da sua aplicação da API Nova
Client Secret Secret da sua aplicação da API Nova


Integração API NOVA

Com a nova API do Gerencianet é possível realizar algumas novas ações:

  • Baixa manual e cancelamento via Controllr
  • Desconto até o vencimento
  • Juros e multa configurável no Controllr




Para aqueles que já utilizam o Gerencianet e esta atualizando para a Build 128 deve criar uma NOVA aplicação na API do Gerencianet deixando a "anterior" sem alterações. Seta-hand-right.gif


Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao.png


ATENÇÃO: não pode alterar o módulo de compatibilidade e nem remover a sua aplicação da Build 127 e anteriores.

Como identificar a API Antiga da Nova?

  • A API "Antiga" tem o "Modo de compatibilidade" ATIVADO <- ANTIGA
  • Possui token de integração e URLs de Callback.

A API Nova não tem o modo de compatibilidade e também o token. Agora possui Client ID e Client Secret


Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova.png


Após criar a nova aplicação da API nova do Gerencianet, deve preencher o Client ID e o Client Secret da forma de pagamento Gerencianet no seu Controllr. (Somente a partir da Build 128) O Client ID e o Client Secret está presente em 3 abas na sua aplicação. Deve ser copiado da aba Produção

Atenção: Não crie uma nova Forma de Pagamento para o GerenciaNet, apenas edite clicando sobre o nome Gerencianet.


Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-codclient.png


  • Notification URL: http://domínio.do.seu.controllr:8083

Bolix

Com o Bolix (Boleto + PIX) ativo, as cobranças geradas após a ativação da funcionalidade conterão além do tradicional código de barras, o QR Code PIX, de modo que o cliente possa escolher qual forma utilizar para realizar o pagamento. Caso a cobrança seja paga via PIX a confirmação de pagamento pelo Gerencianet pode ser enviada para o Controllr em até 10 minutos, e assim que a notificação for recebida pelo sistema é dado baixa na cobrança.

Mais informações em: O que é Bolix?

Ativar o Bolix

Para que os boletos contenham o QR Code PIX é necessário a função estar ativa no Gerencianet e estar na versão 2.0 build 104 do ISP Controllr, para que as cobranças exibidas através do sistema contenham essa informação. Somente irá conter o QR Code Pix as cobranças geradas após a ativação do bolix.

Para ativar bastar seguir o procedimento a seguir [1]: Controllr-financeiro-app-formasdepagamento-gerencianet-ativar-bolix.png

Faturas Criadas no Gerencianet

Após criar a nova aplicação da API no seu Gerencianet e editar a forma de pagamento do Gerencianet no Controllr, já se pode criar as faturas através da nova API.

Com a nova API o Controllr consegue capturar todos os logs da criação das faturas.

A cor da bolinha determina a situação dessa cobrança criada no Controllr.

  • Bolinha Cinza Bank-gerencianet.png Dot-light.png: A cobrança ainda não foi criada no Gerencianet, então essa fatura pode ser editado o valor, a data de vencimento, juros e multa e desconto até o vencimento. Depois quer for criada no Gerencianet essa fatura não pode ser mais alterada.


Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-off.png


  • Bolinha Verde Bank-gerencianet.png Dot-green.png: A cobrança criada no Controllr foi criada com sucesso também no seu Gerencianet.


Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-ok.png


Erros de Criação

  • Bolinha Vermelha Bank-gerencianet.png Dot-red.png: A fatura não foi criada no Gerencianet devido à algum dado preenchido de forma errada. Ao passar o mouse em cima da bolinha vermelha o Gerencianet irá informar o motivo do erro.

Segue a lista de alguns erros mais comuns:



Phone Number

caption


Esse erro ocorre quando está sem número de telefone no cadastro desse cliente ou está formatado de forma errada (faltando DDD). Se não tiver número deve-se preencher com um número qualquer. Ex: Telefone da sua empresa.


CPF é Obrigatória

caption

Esse erro ocorre devido o CPF/CNPJ estar faltando no cadastro desse cliente.


Unexpected token

caption

Esse erro ocorre porque existe quebra de linha ou caracter especial como ( / \ | ˜ ] [ ´; > < * & ¨ % $ ) ( #@! etc) no cadastro do complemento do endereço desse cliente.

Se este erro estiver ocorrendo abra o cadastro de endereço do cliente e reveja o campo de complemento de endereço do cliente.

O valor 1000 é maior que o máximo 330

caption

Esse erro ocorre pois o Juros limite permitido pelo Gerencianet é de 1% ao mês, que é igual a 0.033% ao dia. Esse valor de 0.033 deve ser editado em configurações do seu Controllr de juros de mora.


Video Verificações de Erros