¶ Efí - Gerencianet
A integração com a plataforma Efí, conhecida anteriormente como Gerencianet, tem como objetivo principal, a emissão e compensação de boletos bancários. Através de APIs, o HubSoft irá se comunicar com a Efí para:
- Emitir Boletos e Carnês
- Cancelar Boletos e Carnês
- Verificar Pagamentos
¶ Painel Efí - Gerencianet
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta Efí - Gerencianet.
Com a sua conta aberta, acesse o menu API, conforme a imagem abaixo:
Em seguida, acesse o menu Aplicações > Criar Aplicação
Preencha o Nome da aplicação.
Clique na opção API Cobranças, selecione a Emissão de cobranças e avance para a próxima etapa.
Por fim, inclua sua Assinatura Eletrônica e finalize a aplicação.
Após finalizar, as credencias serão geradas.
Volte ao painel de Aplicações e copie a Chave Client ID e também a Chave Client Secret em Produção para serem utilizadas no Hubsoft.
¶ Configurando no HubSoft
Agora, com todos os dados em mãos, vamos até o HubSoft para cadastrar a Integração.
O primeiro passo é acessar o Menu lateral > Configuração > Integrações > Pagamento, conforme imagem abaixo
Clique em Adicionar e inclua os dados da integração coletados no painel da Efí, sendo eles:
- client_id (obrigatório)
- client_secret (obrigatório)
- ambiente (opcional) - caso não preenchido, será considerado como «producao»)
- transmite_email (opcional) - caso não preenchido, o email do cliente não será enviado para a plataforma)
- transmite_baixa (opcional) - caso não preenchido, a baixa dos boletos quitados/cancelados não será enviada para plataforma)
Após preencher, clique em Salvar e a integração será cadastrada. Para validar se as credenciais estão corretas, basta realizar o teste da integração, em Ações > Testar Integração.
Feito isso, devemos configurar a Forma de Cobrança. É necessário associar a integração à forma de cobrança, para que os boletos sejam registrados e compensados.
Vá ao Menu lateral e acesse Configuração > Financeiro > Forma de Cobrança e clique em Adicionar
Preencha o banco como Gerencianet e selecione a Integração criada. Na próxima aba Configuração, preencha os dados obrigatórios (*) e por fim, clique em Salvar.
Ao finalizar, já estará configurado para emitir seus boletos no Hubsoft integrado ao Efí - Gerencianet.
¶ BOLIX
Em busca de melhorias e agiliada nas integrações de pagamento, a Efí disponibilizou uma nova modalidade de emissão de boletos, que é chamada de BOLIX.
Nessa modalidade, ao emitir um boleto bancário, automaticamente já é emitido um PIX com os mesmos dados do boleto. Dessa forma, em um único boleto, o cliente conseguirá pagar utilizando o código de barras ou QR Code do PIX.
Os boletos serão baixados em até 8 minutos no sistema após o pagamento ser efetuado pelo QRcode PIX.
O HubSoft já possui todas as integrações necessárias para o funcionamento do BOLIX, bastando apenas que seja ativado essa opção, dentro do painel Efí - Gerencianet.
Dentro do painel Efí - Gerencianet, vá até a Aplicação já cadastrada, clique em Configurações e ative todas as opões da API PIX e confirme a alteração incluindo a Assinatura Eletrônica. Por fim, clique em Salvar para que seja alterado para o BOLIX.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados ao Efí/Gerencianet. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ A integração com o Efí/Gerencianet, transmite baixas automaticamente?
Sim, caso a forma de cobrança permita baixas e na integração tenha o parâmetro transmite_baixa com valor true indica que a integração irá transmitir as baixas de títulos, por exemplo: recebimentos na empresa, descontos totais, ou seja, situações onde o título deverá ser baixado no gateway. Valores aceitos (true|false). O não preenchimento desse atributo, faz com que o sistema não transmita as baixas para o Efí/GerenciaNet
¶ E é possível transmitir baixas como cancelamentos?
É sim, temos também o parâmetro transmite_baixa_sendo_cancelamento que indica se a integração deve transmitir as baixas de títulos como cancelamentos na plataforma.
Para ativar essa opção, o parâmetro transmite_baixa deve ser configurado como true. Usos típicos incluem casos como recebimentos na empresa ou concessão de descontos totais, em que o título deve ser baixado no gateway. Os valores aceitos são true ou false. Se este atributo não for preenchido, o sistema transmitirá as baixas como pagas, e não como cancelamentos, para o Efí/GerenciaNet.
