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

De BrByte Wiki
(Criou página com '==150px|link=<span style="display:none">Gerencianet</span>== O Gateway Gerencianet é a opção de pagamento para os clientes que trabalha...')
 
 
(30 revisões intermediárias por 8 usuários não estão sendo mostradas)
Linha 1: Linha 1:
==[[arquivo:marca-gerencianet_b.png|150px|link=]]<span style="display:none">Gerencianet</span>==
+
===Efí/Gerencianet===
 +
<br>
 +
Antes de iniciarmos a configuração no seu Controllr, vamos preparar o sistema do Efí. No seu painel, acesse a aba API no menu lateral.
  
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.
+
<div class="img-responsive align-center">[[Arquivo:Controllr-aplicativos-financeiro-formas-de-pagamento-Efí.png|centro|900px]]</div>
 +
<br>
  
'''Status:''' São as informações dos processos, da comunicação do Controllr com o Gerencianet.
+
Em seguida, clique no botão Criar aplicação.  
  
'''Habilitado:''' Marque para ativar essa forma de pagamento.
+
<div class="img-responsive align-center">[[Arquivo:Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-Criação.png|900px|centro]]</div>
 +
<br>
  
'''Padrão:''' Marque para que no ato de cadastrar um contrato, já venha marcado esse banco padrão.
+
Preencha o nome desejado e a próxima ação será selecionar a API que será utilizada.  
 +
<br>
  
'''Identificação:''' Nome da conta do seu Gerencianet
+
<div class="img-responsive align-center">[[Arquivo:Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-API.png|900px|centro]]</div>
 +
<br>
  
'''Client ID:''' ID da sua aplicação da '''API Nova'''
+
Com a conclusão do processo será necessário copiar a Chave Client ID e Chave Client Secret.
 +
<br>
  
'''Client Secret:''' Secret da sua aplicação da '''API Nova'''
+
<div class="img-responsive align-center">[[Arquivo:Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-Secrets.png|1000px|centro]]</div>
 +
<br>
  
'''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.
+
No seu Controllr, em seu método de pagamento escolhido, utilize as chaves geradas.
 +
<br>
  
'''Notification URL:''' '''http://'''<span style="color:red">'''domínio.do.seu.controllr'''</span>''':8083/service/gerencianet/notification'''
+
<div class="img-responsive align-center">[[Arquivo:Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-controllr.png|1000px|centro]]</div>
 +
<br>
  
* <span style="color:red">'''domínio.do.seu.controllr'''</span>: domínio devidamente registrado em empresas como registro.br, godaddy.com, exemplo: meuprovedor.com.br, provedorinternet.com, vendadeinternet.net.br, etc.
+
===Procedimentos dentro do Controllr===
  
* Atenção¹: Esta URL será cadastrada em cada cobrança gerada no Gerencianet para enviar as mensagens de notificações como pagamento, cancelamento.
+
{|class="table table-bordered table-striped" style="margin:auto;"
 +
!style="text-align:center; width:20%" | Campo
 +
!style="text-align:center"| Descrição
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Habilitado
 +
| style="text-align:left; vertical-align:middle;"| Marque essa opção para habilitá-la nas listagens de busca.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Padrão
 +
| style="text-align:left; vertical-align:middle;"| Marque essa opção para indicar que essa forma de pagamento é a padrão.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Boleto
 +
| style="text-align:left; vertical-align:middle;"| Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Cartão
 +
| style="text-align:left; vertical-align:middle;"| Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Pix
 +
| style="text-align:left; vertical-align:middle;"| Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Identificação
 +
| style="text-align:left; vertical-align:middle;"| Defina um nome para identificar essa nova forma de pagamento.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Escritório
 +
| style="text-align:left; vertical-align:middle;"| Insira o escritório que está vinculado essa forma de pagamento.
 +
|-
 +
!style="text-align:center" colspan="2"| Gateway
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Gateway
 +
| style="text-align:left; vertical-align:middle;"| Ativa ou desativa a conexão com a instituição financeira.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Run
 +
| style="text-align:left; vertical-align:middle;"| Permite o envio de dados para a instituição e o recebimento da informação por parte deles.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Depurar
 +
| style="text-align:left; vertical-align:middle;"| Permite a captação de logs através do código executável do Controllr.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Enviar cobranças por E-mail
 +
| style="text-align:left; vertical-align:middle;"| Marcando essa opção, quando a cobrança for criada no banco, o próprio sistema enviará o e-mail contendo a cobrança para o seu cliente desde que o e-mail seja válido.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Cancelar no pagamento manual
 +
| style="text-align:left; vertical-align:middle;"| Após a baixa manual da cobrança, o Controllr enviará automaticamente um pedido de cancelamento da cobrança para o banco selecionado.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Client ID
 +
| style="text-align:left; vertical-align:middle;"| Insira a identificação do serviço gerada pelo sistema.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Client Secret
 +
| style="text-align:left; vertical-align:middle;"| Insira o código secreto que foi gerado para comunicação entre os sistemas.
 +
|-
 +
!style="text-align:center" colspan="2"| Boleto
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Local de pagamento
 +
| style="text-align:left; vertical-align:middle;"| Contém uma instrução ao pagador do título (cobrança).
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Linhas instruções
 +
| style="text-align:left; vertical-align:middle;"| Caso precise, poderá adicionar até '''quatro linhas de instruções''' para aparecer no boleto. Um exemplo seria para não aceitar após de 30 dias de vencimento essa cobrança.<br><br>Lembre-se de colocar no boleto as variáveis relacionadas: {BANK_INSTRU1}, {BANK_INSTRU2}, {BANK_INSTRU3} e {BANK_INSTRU4}.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Linhas de demonstrativo
 +
| style="text-align:left; vertical-align:middle;"| Caso precise, poderá adicionar até '''duas linhas de demonstrativo''' para aparecer no boleto.
 +
|-
 +
! style="text-align:center" colspan="2" | Configuração
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Permitir pagamento manual
 +
| style="text-align:left; vertical-align:middle;"| Permite que essa forma de pagamento esteja na listagem dos bancos disponíveis no momento da baixa da cobrança.<br><br>Lembre-se que, independentemente das configurações do usuário na Permissões - Usuários, essa opção precisa estar marcada para poder aparecer na listagem. Você pode definir manualmente as permissões para cada usuário. [[Controllr/Aplicativos/Cadastros/Permissão_de_Usuário#Usu.C3.A1rio_do_Banco|Clique aqui]] para conferir.
 +
|-
 +
| style="text-align:left; vertical-align:middle;"| Inserir no fluxo de caixa
 +
| style="text-align:left; vertical-align:middle;"| Selecione uma das opções que compete as informações que serão inseridas no seu fluxo de caixa:<br><br>• '''Não:''' Nenhuma ação.<br>• '''Pagamentos manuais:''' Inserir no fluxo de caixa a baixa manual das cobranças desse banco.<br>• '''Retornos bancários:''' Inserir no fluxo de caixa o retorno bancário das cobranças emitidos pelo banco.<br>• '''Ambos:''' Todas as ações.
 +
|-
 +
! style="text-align:center" colspan="3" | Observação
 +
|-
 +
| style="text-align:center; vertical-align:middle;" colspan="3" | Nesse campo, você poderá adicionar algum comentário em relação a essa forma de pagamento.
 +
|-
 +
|}
  
* Atenção²: É possível utilizar o seu IP público no lugar do domínio para cadastrar a Notification URL. Porém, caso mude o IP público do seu Controllr, as notificações serão enviadas para o IP antigo e seu novo IP não receberá as confirmações de pagamento e cancelamento.
 
  
* Atenção³: O Gerencianet, em sua API nova, não tem suporta a troca de URL. Sendo necessária a troca manual em todas as cobranças em aberto. Para realizar a troca das URL cadastradas em cada cobrança é um trabalho custoso, e será cobrado uma taxa de consultoria para o procedimento. Por este motivo aconselhamos a utilização de um domínio.
+
===Video Verificações de Erros===
 
+
<div class="video-container">
 
+
{{#ev:youtube|https://youtu.be/pfbbeXb5IP0}}
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet.png]]</div>
+
</div>
 
+
[[Category:Formas de Pagamento]]
 
 
===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''' <span style="color:red">''' ''deve criar'' '''uma NOVA aplicação na ''API'' '''</span> do Gerencianet''' deixando a "anterior"  <span style="color:red">'''sem alterações.'''</span> [[arquivo:seta-hand-right.gif|link=]]
 
 
 
 
 
 
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao.png|link=]]</div>
 
 
 
 
 
 
 
<font size="4" color="red">'''ATENÇÃO:''' não pode alterar o módulo de compatibilidade e nem remover a sua aplicação da Build 127 e anteriores. </font>
 
 
 
Como identificar a '''API''' ''Antiga'' da ''Nova''?
 
* A API ''"Antiga"'' tem o '''"Modo de compatibilidade"''' <span style="background-color: green"><span style="margin:10px"><span style="color:white">ATIVADO</span></span></span> <- ANTIGA
 
* <div>Possui '''token de integração''' e '''URLs de Callback'''.</div>
 
 
 
A API ''Nova'' '''não tem''' o modo de compatibilidade e também o token. Agora possui '''Client ID''' e '''Client Secret'''
 
 
 
 
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova.png|link=]]</div>
 
 
 
 
 
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 <span style="color:red">''' ''Produção'' '''</span>
 
 
 
Atenção: Não crie uma nova Forma de Pagamento para o GerenciaNet, apenas edite clicando sobre o nome Gerencianet.
 
 
 
 
 
<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'''
 
 
 
 
 
 
 
===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''' [[arquivo:bank-gerencianet.png|link=]]  [[arquivo:dot-light.png|link=]]: 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.
 
 
 
 
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-off.png|link=]]</div>
 
 
 
 
 
* '''Bolinha Verde''' [[arquivo:bank-gerencianet.png|link=]]  [[arquivo:dot-green.png|link=]]: A cobrança criada no Controllr foi criada com sucesso também no seu Gerencianet.
 
 
 
 
 
<div class="img-responsive align-center">[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-ok.png|link=]]</div>
 
 
 
 
 
* '''Bolinha Vermelha''' [[arquivo:bank-gerencianet.png|link=]]  [[arquivo:dot-red.png|link=]]: 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:
 
 
 
 
 
 
 
 
 
<div class="img-responsive align-center">
 
===Phone Number===
 
 
 
[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro.png|link=|caption|center]]
 
 
 
 
 
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===
+
__NOEDITSECTION__
 
 
 
 
[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-2.png|link=|caption|center]]
 
 
 
Esse erro ocorre devido o CPF/CNPJ estar faltando no cadastro desse cliente.
 
 
 
 
 
 
 
===Unexpected token===
 
 
 
 
 
[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-3.png|link=|caption|center]]
 
 
 
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===
 
 
 
 
 
[[arquivo:controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-4.png|link=|caption|center]]
 
 
 
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.
 
 
 
</div>
 

Edição atual tal como às 10h49min de 21 de agosto de 2024

Efí/Gerencianet


Antes de iniciarmos a configuração no seu Controllr, vamos preparar o sistema do Efí. No seu painel, acesse a aba API no menu lateral.

Controllr-aplicativos-financeiro-formas-de-pagamento-Efí.png


Em seguida, clique no botão Criar aplicação.

Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-Criação.png


Preencha o nome desejado e a próxima ação será selecionar a API que será utilizada.

Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-API.png


Com a conclusão do processo será necessário copiar a Chave Client ID e Chave Client Secret.

Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-Secrets.png


No seu Controllr, em seu método de pagamento escolhido, utilize as chaves geradas.

Controllr-aplicativos-financeiro-formas-de-pagamento-Efí-controllr.png


Procedimentos dentro do Controllr

Campo Descrição
Habilitado Marque essa opção para habilitá-la nas listagens de busca.
Padrão Marque essa opção para indicar que essa forma de pagamento é a padrão.
Boleto Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
Cartão Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
Pix Marque essa opção para indicar que essa forma de pagamento vai gerar pagamento via boleto e enviado na forma de boleto registrado.
Identificação Defina um nome para identificar essa nova forma de pagamento.
Escritório Insira o escritório que está vinculado essa forma de pagamento.
Gateway
Gateway Ativa ou desativa a conexão com a instituição financeira.
Run Permite o envio de dados para a instituição e o recebimento da informação por parte deles.
Depurar Permite a captação de logs através do código executável do Controllr.
Enviar cobranças por E-mail Marcando essa opção, quando a cobrança for criada no banco, o próprio sistema enviará o e-mail contendo a cobrança para o seu cliente desde que o e-mail seja válido.
Cancelar no pagamento manual Após a baixa manual da cobrança, o Controllr enviará automaticamente um pedido de cancelamento da cobrança para o banco selecionado.
Client ID Insira a identificação do serviço gerada pelo sistema.
Client Secret Insira o código secreto que foi gerado para comunicação entre os sistemas.
Boleto
Local de pagamento Contém uma instrução ao pagador do título (cobrança).
Linhas instruções Caso precise, poderá adicionar até quatro linhas de instruções para aparecer no boleto. Um exemplo seria para não aceitar após de 30 dias de vencimento essa cobrança.

Lembre-se de colocar no boleto as variáveis relacionadas: {BANK_INSTRU1}, {BANK_INSTRU2}, {BANK_INSTRU3} e {BANK_INSTRU4}.
Linhas de demonstrativo Caso precise, poderá adicionar até duas linhas de demonstrativo para aparecer no boleto.
Configuração
Permitir pagamento manual Permite que essa forma de pagamento esteja na listagem dos bancos disponíveis no momento da baixa da cobrança.

Lembre-se que, independentemente das configurações do usuário na Permissões - Usuários, essa opção precisa estar marcada para poder aparecer na listagem. Você pode definir manualmente as permissões para cada usuário. Clique aqui para conferir.
Inserir no fluxo de caixa Selecione uma das opções que compete as informações que serão inseridas no seu fluxo de caixa:

Não: Nenhuma ação.
Pagamentos manuais: Inserir no fluxo de caixa a baixa manual das cobranças desse banco.
Retornos bancários: Inserir no fluxo de caixa o retorno bancário das cobranças emitidos pelo banco.
Ambos: Todas as ações.
Observação
Nesse campo, você poderá adicionar algum comentário em relação a essa forma de pagamento.


Video Verificações de Erros