Controllr/Aplicativos/Financeiro/Formas de Pagamento/Efí
Índice
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.
Em seguida, clique no botão Criar aplicação.
Preencha o nome desejado e a próxima ação será selecionar a API que será utilizada.
Com a conclusão do processo será necessário copiar a Chave Client ID e Chave Client Secret.
Após ter copiado as informações acima, basta ir até o Controllr e preencher os campos, conforme mostrado na tabela abaixo.
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. | |
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 Efí, o próprio sistema enviará o e-mail contendo a cobrança para o seu cliente desde que o e-mail seja válido. | |
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. |
Integração API NOVA
Com a nova API do Gerencianet é possível realizar algumas novas ações:
- Baixa manual e cancelamento via Controllr
- 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.
![Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao.png](/images/f/f9/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](/images/2/28/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](/images/2/26/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-codclient.png)
- Notification URL: http://domínio.do.seu.controllr:8083
Bolix
Com o Bolix (Boleto + PIX) ativo, as cobranças geradas após a ativação da funcionalidade conterão além do tradicional código de barras, o QR Code PIX, de modo que o cliente possa escolher qual forma utilizar para realizar o pagamento. Caso a cobrança seja paga via PIX a confirmação de pagamento pelo Gerencianet pode ser enviada para o Controllr em até 10 minutos, e assim que a notificação for recebida pelo sistema é dado baixa na cobrança.
Mais informações em: O que é Bolix?
Ativar o Bolix
Para que os boletos contenham o QR Code PIX é necessário a função estar ativa no Gerencianet e estar na versão 2.0 build 104 do ISP Controllr, para que as cobranças exibidas através do sistema contenham essa informação. Somente irá conter o QR Code Pix as cobranças geradas após a ativação do bolix.
Para ativar bastar seguir o procedimento a seguir [1]:
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
: 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](/images/e/e5/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-off.png)
- Bolinha Verde
: 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](/images/8/88/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-ok.png)
Erros de Criação
- Bolinha Vermelha
: 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 caption](/images/3/37/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro.png)
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 caption](/images/8/84/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-2.png)
Esse erro ocorre devido o CPF/CNPJ estar faltando no cadastro desse cliente.
Unexpected token
![caption caption](/images/0/02/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-3.png)
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 caption](/images/c/ca/Controllr-financeiro-app-formasdepagamento-gerencianet-api-nova-criacao-fatura-erro-4.png)
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