Mudanças entre as edições de "Gerencianet"

De RBX ISP - Manual do Usuário
(Criou página com '=='''Resumo'''== O Gerencianet é um gerenciador financeiro responsável pela emissão de documentos financeiros para o cliente final. Clientes que possuam uma conta no gerenc...')
 
Linha 72: Linha 72:
  
 
Ao clicar para reenviar um documento por e-mail, caso o mesmo esteja integrado, o comando do reenvio será enviado automaticamente para o gerencianet. Este, por sua vez, é o responsável por encaminhar o documento para o cliente.
 
Ao clicar para reenviar um documento por e-mail, caso o mesmo esteja integrado, o comando do reenvio será enviado automaticamente para o gerencianet. Este, por sua vez, é o responsável por encaminhar o documento para o cliente.
 +
 +
=='''Painel de Integração'''==
 +
O Painel de Integração (menu ''Financeiro > Painel Gerencianet'') contém todas as operações enviadas para o Gerencianet e possibilita uma visão geral de todos os documentos integrados. Caso alguma operação dê erro ou o documento tenha sido estornado no RBX ISP, o registro será mostrado na cor vermelha.
 +
 +
 +
<small>Figura 1 - Painel de Integração Gerencianet</small>
 +
[[Arquivo:Gerencianet 2.png|esquerda]]
 +
 +
'''Notificações'''
 +
 +
O gerencianet envia uma nova notificação sempre que ocorre a alteração da situação de um documento. Estas notificações podem ser consultadas no RBX ISP clicando no botão disponível em cada registro do painel, no início da linha.
 +
 +
'''Corrigindo erros de integração'''
 +
 +
O gerencianet tem várias validações de dados cadastrais. Assim, se for gerado um novo boleto para um cliente que não tenha nenhum telefone informado no cadastro, por exemplo, irá ocorrer um erro de integração. Para que este erro seja sanado, será necessário realizar os procedimentos abaixo:
 +
 +
:*Acessar o cadastro do cliente e cadastrar um telefone de contato.
 +
:*Acessar o Painel de Integração Gerencianet
 +
:*Selecionar o registro do documento que deu erro ('''operação Confirmação de boleto''')
 +
:*Clicar no botão ''Reenviar'', localizado na barra de ferramentas superior
 +
 +
De forma geral, todos os erros de integração podem ser tratados corrigindo-se o que ficou errado e enviando novamente o comando para o gerencianet, através do botão ''Reenviar''.

Edição das 07h24min de 4 de junho de 2021

Resumo

O Gerencianet é um gerenciador financeiro responsável pela emissão de documentos financeiros para o cliente final. Clientes que possuam uma conta no gerencianet podem utilizá-lo de forma integrada ao RBX ISP. Assim, todos os lançamentos podem ser feitos em apenas 1 sistema, facilitando o processo. Vamos aprender, a seguir, como configurar uma conta gerencianet no RBX ISP.

Configurando a integração

A tela de configuração do gerencianet está disponível no menu Empresa > Parâmetros > Integrações > Gerencianet. Ao acessar esta opção do menu, você verá uma tela similar à apresentada na imagem 1.

Figura 1 - Tela de configuração do gerencianet

Gerencianet 1.png





























A seguir, breve descrição dos campos:

  • Client Id: esta informação pode ser localizada na opção API > Minhas Aplicações dentro do ambiente do gerencianet.
  • Client Secret: esta informação pode ser localizada na opção API > Minhas Aplicações dentro do ambiente do gerencianet.
  • Ambiente: este campo define se está sendo utilizado o ambiente de testes ou produção. O ambiente de testes sempre deverá ser utilizado para validar a integração entre os sistemas, mesmo que o cliente já utilize o gerencianet de forma avulsa ou integrado a outro sistema.
  • Situação: indica se a integração com o gerencianet está ativa ou inativa.
  • Convênio: indica qual convênio cadastrado no RBX ISP será utilizado para realizar a integração. Este convênio deverá ser criado para o banco 0-Carteira. Neste campo, só serão listados os convênios criados para o banco 0-Carteira.
  • Tarifa de pagamento: neste campo deverá ser informado o valor (em reais) da tarifa cobrada no pagamento de cada documento.
  • Histórico de Recebimento: neste campo deverá ser informado o histórico que será utilizado para baixar o documento.
  • Histórico de Entradas: neste campo deverá ser informado o histórico que será utilizado para creditar o lançamento financeiro na conta corrente cadastrada no convênio indicado acima.
  • Histórico de Tarifas: neste campo deverá ser informado o histórico que será utilizado no lançamento das tarifas.
  • Usuários: neste campo deverão ser selecionados os usuários que receberão notificações a respeito de erros ocorridos durante a integração com o gerencianet.

Só é possível utilizar uma conta gerencianet no sistema. A seguir, veremos as operações disponíveis via integração.

Operações

Após ter configurado a integração, as seguintes operações serão integradas de forma automática nos documentos financeiros:

  • Lançamento de novos boletos;
  • Lançamento de novos carnês;
  • Alteração de vencimento;
  • Baixas manuais;
  • Estornos manuais;
  • Pagamentos.

Lançamentos de novos documentos

Os documentos lançados de forma avulsa e através das rotinas de faturamento (faturamento manual e faturamento automático) serão integrados automaticamente ao gerencianet. Para isto, basta selecionar o convênio cadastrado na integração.

Atenção: o gerencianet envia o boleto para o e-mail do cliente automaticamente.

Lançamento de novos carnês

Os carnês gerados de forma avulsa ou em lote serão integrados automaticamente ao gerencianet. Para isto, basta selecionar o convênio cadastrado na integração. O gerencianet irá enviar um único e-mail contendo o carnê completo para o cliente. O gerencianet possui regras específicas para a geração de carnês, sendo elas:

  • Não é possível gerar carnês com periodicidade diferente de mensal;
  • Não é possível customizar a descrição dos itens de cada parcela do carnê individualmente;
  • Não é possível gerar carnês com parcelas contendo valores diferentes;
  • Não é possível gerar carnês com dias de vencimentos diferentes em cada parcela.

Quando não for possível gerar um carnê, o RBX ISP enviará o comando para geração de boletos avulsos para cada parcela do carnê. Quando apenas a primeira parcela do carnê tiver um valor diferente das demais parcelas, o RBX ISP irá enviar o comando para que a primeira parcela seja gerada como boleto e o carnê comece a partir da segunda parcela. Isso poderá ocorrer quando houver uma cobrança de proporcional no primeiro período do faturamento do contrato.

Alteração de vencimento

Uma vez integrado ao gerencianet, as alterações de vencimento dos documentos serão enviadas automaticamente para o mesmo.

Atenção: o gerencianet não permite alterar o vencimento de um boleto para uma data igual ou menor a hoje.

Baixas e estornos manuais

Caso um documento seja baixado ou estornado, a operação será enviada automaticamente para o gerencianet.

Pagamentos

Quando o cliente paga um boleto do gerencianet, este envia uma notificação para o RBX ISP, que faz a baixa do documento utilizando os parâmetros configurados na integração.

A seguir, você aprenderá como gerenciar os documentos integrados.

Reenvio de boleto por e-mail

Ao clicar para reenviar um documento por e-mail, caso o mesmo esteja integrado, o comando do reenvio será enviado automaticamente para o gerencianet. Este, por sua vez, é o responsável por encaminhar o documento para o cliente.

Painel de Integração

O Painel de Integração (menu Financeiro > Painel Gerencianet) contém todas as operações enviadas para o Gerencianet e possibilita uma visão geral de todos os documentos integrados. Caso alguma operação dê erro ou o documento tenha sido estornado no RBX ISP, o registro será mostrado na cor vermelha.


Figura 1 - Painel de Integração Gerencianet

Gerencianet 2.png

Notificações

O gerencianet envia uma nova notificação sempre que ocorre a alteração da situação de um documento. Estas notificações podem ser consultadas no RBX ISP clicando no botão disponível em cada registro do painel, no início da linha.

Corrigindo erros de integração

O gerencianet tem várias validações de dados cadastrais. Assim, se for gerado um novo boleto para um cliente que não tenha nenhum telefone informado no cadastro, por exemplo, irá ocorrer um erro de integração. Para que este erro seja sanado, será necessário realizar os procedimentos abaixo:

  • Acessar o cadastro do cliente e cadastrar um telefone de contato.
  • Acessar o Painel de Integração Gerencianet
  • Selecionar o registro do documento que deu erro (operação Confirmação de boleto)
  • Clicar no botão Reenviar, localizado na barra de ferramentas superior

De forma geral, todos os erros de integração podem ser tratados corrigindo-se o que ficou errado e enviando novamente o comando para o gerencianet, através do botão Reenviar.