Controllr/Aplicativos/Financeiro/Formas de Pagamento/Efí
Índice
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.
| Novo | ||
|---|---|---|
| Campo | Descrição | Exemplo |
| Habilitado | Marque para ativar essa forma de pagamento. | |
| Padrão | Marque para que no ato de cadastrar um contrato, já venha marcado esse banco padrão. | |
| Boleto | Marque para ativar essa forma de pagamento. | |
| Enviar cobranças por E-mail | Ao marcar, quando a cobrança for criada no Gerencianet, o próprio Gateway enviará o e-mail contendo a cobrança para o seu cliente, desde que o e-mail do mesmo seja válido. | |
| Depurar | Ao habilitar permite que a equipe de suporte obtenha mais informações sobre a comunicação e requisição de informações com o Gerencianet. Habilite apenas se instruído pela equipe de suporte da Brbyte. | |
| Instituição | Instituição Financeira a ser cadastrada. | Gerencianet |
| Identificação | Nome da conta do seu Gerencianet | Gerencianet Teste |
| Client ID | ID da sua aplicação da API Nova | |
| Client Secret | Secret da sua aplicação da API Nova | |
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 deve criar uma NOVA aplicação na API do Gerencianet deixando a "anterior" sem alterações. 
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
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.
- 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.
- Bolinha Verde
: A cobrança criada no Controllr foi criada com sucesso também no seu Gerencianet.
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
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
Esse erro ocorre devido o CPF/CNPJ estar faltando no cadastro desse cliente.
Unexpected token
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
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
