Mudanças entre as edições de "Controllr/Aplicativos/Financeiro/Formas de Pagamento/Efí"

De BrByte Wiki
Linha 2: Linha 2:
  
 
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.
 
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.
 
'''Habilitado:''' Marque para ativar essa forma de pagamento.
Linha 15: Linha 17:
 
'''Client Secret:''' Secret da sua aplicação da '''API Nova'''
 
'''Client Secret:''' Secret da sua aplicação da '''API Nova'''
  
'''Local de pagamento:''' Informação que será informada na impressão do boleto pelo sistema
+
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet.png]]</div>
  
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet.png|link=]]</div>
 
 
'''URL de notificação:''' Para receber informações da API em seu Controllr a sua URL de notificação deve estar devidamente configurada nas [[Controllr/Aplicativos/Configura%C3%A7%C3%B5es#Endere.C3.A7o_.28Externo.29|Configurações do sistema]].
 
  
 
=Integração API NOVA=
 
=Integração API NOVA=
Linha 52: Linha 51:
  
  
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova.png]]</div>
+
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova.png|link=]]</div>
  
  
Linha 62: Linha 61:
  
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-codclient.png|link=]]</div>
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-codclient.png|link=]]</div>
 +
 +
 +
 +
* Notification URL: '''http://'''<span style="color:red">'''domínio.do.seu.controllr'''</span>''':8083/service/gerencianet/notification'''
  
  

Edição das 16h04min de 31 de março de 2020

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