Controllr/Aplicativos/Financeiro/Formas de Pagamento/Efí

Gerencianet

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.

Status: São as informações dos processos, da comunicação do Controllr com o Gerencianet.

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.

Identificação: Nome da conta do seu Gerencianet

Client ID: ID da sua aplicação da API Nova

Client Secret: Secret da sua aplicação da API Nova

Enviar cobranças por E-mail: Ao marcar SIM, quando a cobrança é criada no Gerencianet, o próprio Gateway envia-rá o e-mail contendo a cobrança para o seu cliente, desde que o e-mail do mesmo seja válido.

Notification URL: http://domínio.do.seu.controllr:8083/service/gerencianet/notification

• domínio.do.seu.controllr: domínio devidamente registrado em empresas como registro.br, godaddy.com, exemplo: meuprovedor.com.br, provedorinternet.com, vendadeinternet.net.br, etc.

• Atenção¹: Esta URL será cadastrada em cada cobrança gerada no Gerencianet para enviar as mensagens de notificações como pagamento, cancelamento.

• Atenção²: É possível utilizar o seu IP público no lugar do domínio para cadastrar a Notification URL. Porém, caso mude o IP público do seu Controllr, as notificações serão enviadas para o IP antigo e seu novo IP não receberá as confirmações de pagamento e cancelamento.

• Atenção³: O Gerencianet, em sua API nova, não tem suporta a troca de URL. Sendo necessária a troca manual em todas as cobranças em aberto. Para realizar a troca das URL cadastradas em cada cobrança é um trabalho custoso, e será cobrado uma taxa de consultoria para o procedimento. Por este motivo aconselhamos a utilização de um domínio.

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/service/gerencianet/notification

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.