¶
Efí - Gerencianet Bolix
Agora, pagar suas faturas ficou ainda mais simples com a integração Bolix da Gerencianet/Efí. Gere seus boletos como de costume, e ao acessar a Central do Assinante, seus clientes podem optar pelo Pix para efetuar o pagamento de forma rápida e prática.
Para começar a utilizar, será configurada uma Carteira de Cobrança específica para o Bolix, com as credenciais da Efí. A homologação deve ser feita através do contato com o nosso SUP - Suporte Carteira de Cobrança - IXC Provedor.
Como criar a carteira de cobrança Efí - Gerencianet
Criando a carteira
Para cadastrar no seu IXC uma carteira de cobrança do Gerencianet, siga o seguinte passo a passo:
- Acesse o menu Cadastros;
- Pasta Financeiro;
- Selecione a opção Carteira de cobrança e clique no botão Novo.
¶ Aba Carteira de cobrança
- No campo Descrição insira o nome que deseja dar para sua carteira. No campo Tipo de recebimento selecione a opção "Gateway".
No parâmetro Enviar e-mail para cliente ao gerar financeiro do contrato marcar como "Não", do contrário, corre o risco de causar duplicidade na comunicação dos boletos.
- Para realizar a configuração da Conta que será vinculada a carteira, acesse o campo Conta através da lupa, conforme imagem abaixo.
Criando a conta
- Na tela de Contas, clicar no botão Novo
- Para a configurar a conta é necessário preencher os seguintes campos:
Conta: Preencha o nome da conta nesse campo.
Tipo de conta: Marque a opção Banco.
Data da abertura: Coloque o dia atual.
Planejamento analítico: É necessário criar um planejamento analítico para essa conta.
Permitir pagamento com saldo negativo: Escolha uma das opções, sim ou não.
Ativo: Mantenha a conta marcada como ativo.
Realizados os procedimentos acima, a conta pode ser salva e inserida na Carteira criada.
Aba Configurações Gateway
Nesta aba temos que definir as seguintes opções:
Gateway: Selecione "Gerencianet"
Nova API: Para novas carteiras, deve ser obrigatoriamente marcado como "Sim"
Client_Id: Informação que consta no Gerencianet, abaixo mostraremos onde você encontra em sua conta.
Client_secret: Informação que consta no Gerencianet, abaixo mostraremos onde você encontra em sua conta.
Call-Back Nesse campo, você irá clicar no botão Gerar para gerar a URL que fará a comunicação entre o Gerencianet e o IXC.
Você deve estar acessando seu sistema através de seu domínio, exemplo https://SeuDominio.com.br/adm.php para que ao clicar em gerar, o mesmo gere a URL com seu domínio e não com seu IP.
Identificador da conta: Informação que consta no Gerencianet, abaixo mostraremos onde você encontra em sua conta.
Envia e-mail gateways: Valida o e-mail do cliente se marcado como "Sim", para impressão e envio de e-mail de cobrança através do banco.
Lança tarifa gateway: Marca a opção de quando o Gerencianet cobra de você a tarifa, se na impressão ou no recebimento.
Valor tarifa gateway: Preencha com o valor de tarifa que você paga nos boletos. Ex: 3.50 (Utilize ponto para separar). Saiba mais sobre: Tarifas Gateway
Depois, crie no Gerencianet a aplicação para pegar as informações de Cliente_ID, Cliente_Secret e o Identificador da conta para inserir na sua carteira:
¶ Configuração de aplicação no Gerencianet (Versão 7.0)
Para criar a aplicação, acesse sua conta do EFÍ e siga os seguintes passos:
- No menu principal, selecione a opção API
- Em Introdução, selecionar a opção Criar aplicação
- Descreva o nome da Aplicação e clique em Continuar
- Na tela se Seleção de escopos, marcar em API de Emissão a opção de Emissão de cobranças, conforme imagem, desça até o final da página e clique no botão Continuar
- Digite sua Assinatura eletrônica para confirmar a criação
- Após isso clique na aplicação que foi criada, nela estarão o Client ID e Client Secret que devem ser copiados para os respectivos campos na carteira de cobrança no IXC.
- O Identificador da conta pode ser encontrado retornando ao menu Introdução, no canto superior direito da tela:
- Insira as informações de Client ID, Client Secret e Identificador na carteira e salve:
Aba Juros/Multas/Desconto
Para a configuração dessa aba, siga as instruções de Juros/Multas/Desconto
Aba Instruções
Para a configuração dessa aba, verifique: Instruções
Aba Impressão
Para a configuração dessa aba, verifique a Wiki Impressão
Como reenviar notificação de pagamento Efí (Nova API)
Para reenviar uma notificação de pagamento de um boleto da Efí - (Gerencianet) para o IXC, você irá seguir o seguinte passo a passo:
- Acessando sua conta Efí, clique no menu API;
- Em seguida clique no menu API.
- Dentro do menu API, clique em Minhas Aplicações.
- No menu de Aplicações, localize a sua aplicação de API e clique nos três pontos localizados a direita da descrição da aplicação;
- Nos botões que abrirem, clique em Detalhar.
- Você será direcionado para a aba Cobranças dentro da sua aplicação, onde terá a listagem de todas as faturas que foram geradas por ela;
- Localize a fatura que deseja reenviar a notificação (cujo status seja pago), e clique no ícone da fatura com uma lupa (detalhar), na aba ações;
- Nesta janela de visualização de sua fatura, clique no botão localizado no canto superior direito da janela (Reenviar notificação), ao lado do botão de fechar.
Feito o reenvio, localize o novo envio deste log em seu IXC e faça o Processamento do Log Gateway.
Processamento do Log Gateway.
Como identificar pra qual IP (URL) a Efí esta enviando as notificações
Para identificar para qual IP/URL a Efí está enviando as notificações de pagamentos, iremos seguir os seguintes passos:
- Acessando sua conta Efí, clique no menu API;
- Em seguida clique no menu API.
- Dentro do menu API, clique em Minhas Aplicações.
- No menu de Aplicações, localize a sua aplicação de API e clique nos três pontos localizados a direita da descrição da aplicação;
- Nos botões que abrirem, clique em Detalhar.
- Clique na aba Notificações;
- Na listagem abaixo irá conter todas as notificações da sua API enviadas pela Efí, e conterá alguns dados, como o IP/URL para qual as notificações estão sendo enviadas.
Caso esteja diferente do Domínio do seu IXC, contate nosso suporte! Sempre que forem feitas alterações de IP/Domínio deve-se alterar também na Gerencianet/Efí para que continue recebendo as notificações. Sendo assim, ao alterar seu domínio de IP contate imediatamente nosso Suporte Carteira de Cobrança.
Boletos importados tipo carnê
Para clientes que utilizam os boletos Efí do tipo Carnê, foi criado este parâmetro para a impressão:
- Acesse o Menu "Cadastros".
- "Financeiro".
- E em "Carteira de Cobrança", clique em Editar.
É necessário que no campo Tipo de recebimento esteja selecionada a opção Gateway, pois somente desta maneira irá aparecer a aba de "Configurações Gateway", conforme imagem abaixo:
Em seguida, clique na aba Configurações gateway, e marque o parâmetro "Utiliza Carnê" como Sim.
Identificar origem do boleto Efí
De maneira simples, é possível verificar a origem de um boleto em sua conta Efí. Desta maneira, você pode identificar se o boleto foi gerado pela interface bancária, ou se foi gerado por integração de algum outro software.
Para localizar o boleto, acesse:
- Menu "Receber (Cobranças)".
- E em "Gestão de cobranças", vá para a opção "Boletos".
- Neste ambiente estarão disponíveis os boletos gerados por sua conta, onde você pode utilizar as caixas de pesquisa para localizar alguma fatura específica caso desejar:
- Se o boleto for gerado pela interface bancária, estará com a informação "Criado via: Sistema":
- Se o boleto for gerado pela integração com o IXC Soft, estará com a informação "Criado via: API: IXC Soft".
No exemplo acima, o boleto foi gerado pela API: IXC Soft, para verificar as aplicações que você possui em sua conta, vá até:
- Menu "API".
- Você será direcionado para a tela de Introdução, onde poderá clicar em Criar aplicação, ou clicar em Minhas aplicações (ou menu lateral Aplicações) para visualizar as aplicações que você tem criadas:
¶ Erros comuns durante a comunicação de boletos
Boletos saindo em branco
Caso você esteja enfrentando dificuldades ao imprimir ou comunicar boletos utilizando a API do Efí e perceba que os boletos estão saindo em branco, é importante saber como identificar o motivo do erro.
Para isso, acesse sua conta no Efí e vá para a seção da API relacionada à aplicação do boleto. Em seguida, role a página até chegar ao histórico de requisições e localize a requisição com o erro. Clique no ícone de visualização correspondente a essa requisição.
Ao abrir a tela mencionada, será possível identificar a causa do erro.
No exemplo acima, o erro está relacionado ao formato inadequado do número de celular inserido no cadastro do cliente.
Certifique-se de preencher o telefone celular no formato correto, como (51) 99710-8088, e também preencher o campo do telefone residencial, se necessário.
Outro motivo comum de erro é o limite de impressões do boleto ter sido excedido. Nesse caso, é importante clicar no link fornecido para mais informações sobre como resolver esse problema, clique aqui.
Se existir erros que você não consiga identificar, contate o suporte da IXCSoft.
cURL error6: Could not resolve host: api.gerencianet.com.br (see http://curl.haxx.se/libcurl-erros.html)
Esse erro se refere a porta de acesso que pode estar vencida. Para resolver você pode contatar o Suporte de Manutenção de Redes e Servidores da IXC Soft, para que o técnico reabilite a porta e os títulos voltem a comunicar.
O Valor (x) é maior que o máximo 330
Esse erro ocorre quando nas configurações da Carteira de cobrança do Efí está definido um valor de Juros maior do que o permitido pelo banco, que é de 0.033% ao dia (de acordo com a legislação).
A propriedade (expire at) informada é invalida
Esse erro ocorre devido ao título já estar vencido sem ter sido comunicado/registrado no banco. Gateways de pagamento não permitem o registro de boletos já vencidos.
Limite de emissões diárias excedido
Esse erro ocorre porquê o Efí trabalha com um limite de emissões diárias, sendo elas:
- 13 emissões ao dia para o mesmo CPF, Telefone ou E-mail.
- 30 emissões ao mês para o mesmo CPF, Telefone ou E-mail.
Para solucionar este erro é necessário conferir no sistema se não há mais de um cadastro de cliente de mesmo CPF, Telefone ou e-mail. Se não existir repetição, deve entrar em contato com o Efí - Gerencianet para ajuste do limite de emissões.
A string não corresponde ao modelo: ^[1-9]{2}9?[0-9]{8}$.
Esse erro ocorre quando há alguma divergência nas informações do cadastro de telefone do cliente.
Neste caso, é necessário verificar se o número de telefone está devidamente inserido de acordo com o aceito pelo padrão nacional:
- Para Telefone Móvel: (49) 9 9999-9999 (considerando o dígito 9 adicional).
- Para Telefone Fixo: (49) 9999-9999.
Tipo inválido: number (esperado integer)
Esse erro ocorre porquê os campos de Juros e Multa estão preenchidos tanto em percentual (%), quanto em reais (R$), ocorrendo uma divergência de valores e não permitindo a impressão dos boletos.
¶ Status API Efí - Gerencianet
Confira o status dos sistemas Gerencianet: situações atípicas, inatividades e manutenções programadas:
Status API Efí - Gerencianet
Retorne ao menu Gateways
Retorne ao menu Carteira de Cobrança