Controllr/Aplicativos/Financeiro/Formas de Pagamento/Gerencianet

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.

Status: São as informações dos processos, da comunicação do Controllr com o Gerencianet.

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.

Enviar cobranças por E-mail: Ao marcar SIM, quando a cobrança é criada no Gerencianet, o próprio Gateway envia-rá o e-mail contendo a cobrança para o seu cliente, desde que o e-mail do mesmo seja válido.

Identificação: Nome da conta do seu Gerencianet

Client ID: ID da sua aplicação da API Nova

Client Secret: Secret da sua aplicação da API Nova

Controllr-financeiro-app-formasdepagamento-gerencianet.png


Integração API NOVA

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

  • Baixa manual e cancelamento via Controllr
  • Gerar carnês para múltiplos clientes
  • 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/service/gerencianet/notification


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