Manual de integração do EFI - Gerencianet.Bolix ao sistema MK-Auth
Abertura de nova conta no EFI - Gerencianet - passos de 1 a 2;
Copiar identificador da conta e preencher no campo correto - passos de 3 a 7;
Gerar nova aplicação de integração API - passos de 8 a 13;
Preenchimento do cadastro de nova conta bancária no sistema - passo 14;
Ativar o Bolix, o QR Code do PIX nos boletos - passos de 15 a 17;
Informações importantes e esclarecimentos finais - final da pagina.
Bom dia prezados(as),
Para fazer a integração do EFI - Gerencianet ao sistema, siga os passos abaixo:
Antes de começar, seguem algumas informações importantes:
- A integração com o EFI - Gerencianet com Bolix, está disponivel a partir da versão do sistema 21.04.
- Nos cadastros dos clientes, devem conter pelo menos o Nome completo, o CPF, o Endereço, o CEP, o E-mail e o Celular.
1. Para abrir uma conta no EFI - Gerencianet, acesse o sistema MK-AUTH, vá em em Provedor > Contas bancarias e clique no "+" para adicionar uma nova conta.
(Se já possui uma conta no EFI - Gerencianet, pule para o passo 3)
Selecione a conta EFI - Gerencianet.API Bolix e clique no local indicado na seta 3, como mostra na imagem abaixo:
2. Clique em "Abra sua conta grátis" e siga os passos informados para a abertura de conta no EFI - Gerencianet:
3. Depois de aberto a conta, faça login em sua conta do EFI - Gerencianet: https://login.sejaefi.com.br/
4. No menu do lado esquerdo, clique em "API":
5. Clique em "Identificador de conta" do lado direito da página, para obter o identificador da conta:
6. Copie o identificador da conta e clique no "x", para voltar a janela anterior:
7. Volte na janela de cadastro da conta do sistema e cole o identificador da conta no local indicado:
8. Volte para a janela da conta do EFI - Gerencianet e clique em "Criar aplicação":
9. Dê um nome para a nova aplicação e depois clique em "Continuar":
10. Expanda as opções clicando primeiro no local indicado pela seta 1 e depois no local indicado na seta 2:
11. Habilite as opções, conforme indicado na imagem abaixo e clique em "Continuar", no final da página:
12. Digite a senha da assinatura eletrônica de 5 dígitos, no painel com as letras no centro da página, indicado na seta 1 e depois clique em "Continuar":
13. Copie a cheve indicada na seta 1 e cole no campo referente, no cadastro da conta, depois faça o mesmo com a chave indicada na seta 2 e clique em "Acessar aplicação":
14. Depois de colar as chaves Client_ID, Client_Secret e o identificador da conta, preencha o restante dos dados para terminar de cadastrar a conta no sistema.
Quando todos os campos necessários estiverem preenchidos, clique em "Gravar", no final da página, para salvar o cadastro:
Sobre os campos:
- Seta 1: A Chave Client_ID que foi copiada em passos anteriores;
- Seta 2: A Chave Client_Secret que foi copiada em passos anteriores;
- Seta 3: A URL de retorno deve ser preenchida de acordo com o IP ou Domínio de acesso ao sistema; Exemplo:
http://192.168.0.5/retorno/gerencianet_confirma.hhvm
- Seta 4: No Cedente, preencha com o nome do proprietário da conta;
- Seta 5: O nome da conta no sistema, para selecionar no cadastro do cliente.
- Documento CPF/CNPJ: Preencher com o CPF ou CNPJ do proprietário da conta;
As instruções ao caixa no momento de pagamento, referente à multa, juros e desconto, devem ser preenchidos nos campos de instrução. (Somente se utilizar os campos de multa, juros e desconto) Exemplos:
- Instrução linha 1: APOS VENCIMENTO MULTA DE R$ %percentual_multa%%
- Instrução linha 2: APOS VENCIMENTO COBRAR MORA DE R$ %valor_mora% AO DIA
- Instrução linha 3: Conceder desconto se pago ate %data_original% no valor de %valor_desconto%
15. Para ativar o Bolix, o QR Code do PIX nos boletos, clique no botão da engrenagem, para abrir o menu com as opções de configuração:
16. No menu do lado esquerdo, clique em "Configurações de cobranças" e em seguida clique em "Boletos bancários e carnês":
17. Habilite a opção de Bolix, conforme na imagem abaixo e clique em "Salvar configurações":
Pronto, a integração foi concluida com sucesso.
Agora é só fazer os lançamentos, para os clientes.
Seguem alguns pontos importantes:
- Para gerar boletos para os clientes, é necessário e obrigatório o preenchimento correto dos campos de Nome, CPF, Endereço, CEP, E-mail e Celular, do cadastro do cliente.
- Para sair o QR Code do PIX nos boletos, é necessário está na versão 21.04 ou superior, do sistema.
- Não é possível gerar boletos com datas de vencimentos passadas, ou seja, não é possível gerar boletos já vencidos.
- Os procedimentos de alteração, geração da segunda via, cancelamento/exclusão e recebimento em mãos, podem ser feitos dentro do próprio sistema MK-AUTH. (Podem demorar até 24 horas para serem registrados no EFI - Gerencianet, exceto a geração da segunda via do boleto, que é instantânea.)
- Se a URL de retorno for alterada no sistema e não for solicitado a atualização da URL na plataforma do EFI - Gerencianet, o sistema não vai receber as notificações de pagamento dos boletos gerados antes da alteração.
- Os IPs que o EFI - Gerencianet utiliza, não podem estar bloqueados no firewall: https://sejaefi.com.br/artigo/quais-enderecos-de-ip-gerencianet-utiliza/
Qualquer dúvida, estamos à disposição.
Atenciosamente,
Equipe MK-AUTH
Respostas
Bom dia prezado(a),
1- Na integração pela nova API, os carnês gerados no sistema ficam como boletos na plataforma do EFÍ, sempre foi assim.
A integração fortunus funcionava diferente, pois os títulos e carnês ficavam na plataforma do EFÍ e toda vez que abria ou enviava era necessário o sistema baixar as informações deles.
A Diferenças das duas integrações é que a nova API é mais segura e todas as informações do boleto também ficam no sistema, sendo possível criar e alterar o layout dos boletos e utiliza somente uma URl de retorno configurada no sistema.
2- Na nova API não é mais necessário cancelar um boleto na plataforma do EFÍ, basta excluir no sistema, que ele se encarrega de enviar as informações de cancelamento para o EFÍ.
Obs.: Se você cancelar um boleto na plataforma do EFÍ e a URL de retorno estiver funcional, o sistema receberá a notificação e cancelará no sistema.
3- Se a URL de retorno estiver correta, o sistema receberá a notificação, registrará nos logs de notificação e dará baixa no boleto.
Os logs do sistema é diferente dos logs de notificações.
Se não estiver dando baixa automática, pode ser por vários motivos:
- Mudança de endereço do sistema: Quando a URL muda, é necessário solicitar ao EFÍ a atualização da URL dos boletos gerados ates da mudança.
- URL antiga: A URL antiga foi descontinuada e é necessário utilizar o novo modelo conforme este manual de integração orienta.
- URL incorreta ou sistema offline: se a URL estiver incorreta ou o sistema não estiver online ou no roteador ou firewall estiver bloqueando as notificações que vem do EFÍ, o sistema não vai receber as notificações e não vai dar baixa automática.
Segue o tutorial para identificar as notificações com erro ou falha, apartir do passo 8:
https://mk-auth.com.br/forum/topics/como-identificar-erros-de-emiss...
Qualquer dúvida, estamos à disposição.
Atenciosamente,
Atendimento de suporte ao sistema
___________ MK-AUTH __________
1️⃣ A integração do EFI BOLIX funciona dessa forma com o MK-AUTH. Mesmo você gerando um carnê, dentro do EFI cada lâmina é tratada separadamente como um boleto.
2️⃣ Ao cancelar um boleto dentro do EFI, é necessário realizar o cancelamento também no MK-AUTH. ESSA NÃO TENHO 100% pois pode ter mudado. mais acredito que precise cancelar em ambos, pessoal pode me corrigir essa parte amanha pela manha
3️⃣ Sobre a baixa automática, os registros ficam em Provedor → Logs de Notificações. verifica se sua url de retorno esta correta
Estou gerando carnê e o gerencianet gera boletos, e ao cancelar um boleto não cancela no mk-auth e não ta aparecendo a baixa nos logs do mk-auth.
Após mudar a integração encontrei esses preoblemas:
1-Ao escolher carnê o gerencianet entende (Boleto) e gera cada boleto separado.
2-Ao cancelar uma cobrança no gerencianet não cancela no MK-AUTH.
3-Ao receber uma baixa automatica não aparece no LOG do MK-AUTH.
ja tem correção?
Não, tudo funcionando perfeitamente.
O que seria esse boleto jato?
Boa tarde Thiago,
Não temos conhecimento de outros IPs que precisam ser liberados para a geração de títulos ou o recebimento de notificações do EFí Gerencianet.
Está com dificuldades de gerar ou de receber as notificações?
Qualquer dúvida, estamos à disposição.
Atenciosamente,
Atendimento de suporte a integração EFí - Gerencianet
_________________ Sistema MK-AUTH _________________
Prezados, boa tarde!
Além dos IPS descritos na API da Efi, "Os IPs que o EFI - Gerencianet utiliza, não podem estar bloqueados no firewall: https://sejaefi.com.br/artigo/quais-enderecos-de-ip-gerencianet-uti..."
Agradeço a resposta.
Boa tarde prezado(a),
Tem que colocar o http:// na URL de retorno.
Qualquer dúvida, estamos à disposição.
Atenciosamente,
Equipe MK-AUTH
ALGUEM SABE COMO RESOLVO ISSO ?
Bom dia prezado(a),
Olha nos logs do Gerencianet, se apresenta alguma falha.
https://mk-auth.com.br/forum/topics/como-identificar-erros-de-emiss...
Qualquer dúvida, estamos à disposição.
Atenciosamente,
Equipe MK-AUTH
-
1
-
2
de 2 Próximo