Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Este documento tem como objetivo descrever todos os passos necessários para implantação do produto Gestão de Receita Recorrente integrado ao Protheus 12.

Para integrações externas ou projetos customizados, disponibilizamos a documentação dos serviços disponíveis para consumo na plataforma: https://api-recorrencia.totvs.app/.

Para que a implantação do sistema GRR - Gestão de Receita Financeira ocorra corretamente, sugerimos verificar alguns itens antes de iniciar este processo. Estes itens estão divididos em processos com objetivo de fornecer uma ordem lógica, e não cronológica, por exemplo, é possível definir as soluções antes de determinar a alocação.

Image Removed

Como está dividido o documento?

O Guia de Implantação está dividido em Ambiente na Configuração do GRR, Configuração do JobScheduler e Parametrização dos adquirentes, a ordem cronológica independe do momento da liberação da plataforma para o clienteExecução do Wizard Protheus, Cadastros e parâmetros Protheus, Serviços (JobScheduler) e Intermediador de pagamento. 

É importante seguir estas etapas de forma sequencial, para garantir que todas as dependências entre os processos sejam executadas da maneira correta.

Deck of Cards
id2C999
Card
defaulttrue
labelAmbiente Configuração do GRR

Logo após a realização da adesão do produto e autorizado pelo time da TOTVS, o sistema processo de geração do contrato irá provisionar de forma automática um ambiente do GRR Gestão de Receita Financeira, para que seja realizado as validações de inclusão, instalação, configuração e teste do software para garantir que esteja funcionando corretamenteRecorrente

Será enviado um e-mail com as instruções necessárias para acessar a plataforma com o usuário de administrador do Fluig e assim começar a utilizá-la.

Caso você não receba o e-mail informando sobre a disponibilização do acesso ao Fluig após o provisionamento do ambiente da plataforma GRR da Totvs, é recomendável que você entre em contato com o suporte técnico da TotvsTOTVS. Você pode abrir um ticket de suporte para informar sobre o problema e solicitar a ativação do acesso ao Fluig.

Modelo Modelos de e-mail (poderá ocorrer mudanças no layout)Image Removed

Image Added

Reserve o número do campo TenantID, pois ele será utilizado no link do gestão do JobScheduler.

Image Added

Você receberá também um e-mail com as credenciais de integração. Essas credenciais são necessárias para configuração da integração com o ERP.

Image Added

Acesse a plataforma com o login do usuário administrador. Através do manager, é possível cadastrar novos usuário para acesso a plataforma. Lembre-se de sempre que criar um novo usuário, associá-lo ap App Recorrência.

Card
labelConfiguração Execução do JobSchedulerWizard Protheus

Para que possa ocorrer a integração com o produto GRR - Gestão de Receita Recorrente é necessário a execução do Wizard Protheus.

Aviso
titlePré-requisitos

Protheus release 12.1.2210 com expedição contínua atualizada: ArquivoImage Added
ou
Protheus na release 12.1.2310 com expedição contínua atualizada: ArquivoImage Added

No caso de ambiente Cloud, a aplicação do pacote deve ser feita através do portal TCloud, conforme documentação abaixo: 
https://centraldeatendimento.totvs.com/hc/pt-br/articles/360024948533-CLOUD-MP-Aplicar-pacote

Verificar no servidor onde o ambiente está instalado se os endereços listados a seguir estão liberados *:

o https://api-recorrencia.totvs.app/api/v1
o https://endpoint-registry.totvs.app/api/v1/services
o https://totvs.rac.totvs.app
o https://admin.rac.totvs.app
o https://recorrencia.totvs.app
o https://app.fluigidentity.com

*Apenas para ambiente On-premisse, em ambiente CLOUD não possui restrições de acesso ás URL's.

Caso não exista, é necessário a inclusão da chaves abaixo no bloco do environment no arquivo Appserver.ini.

*Caso o cliente utilize broker, deverá ser incluído em todos os .ini abaixo deles. Clientes cloud validar essa configuração.

Exemplo:

Bloco de código
languagetext
titleAppserver.ini
[GENERAL]
app_environment=environment

[environment] 
fw-tf-registry-endpoint=https://endpoint-registry.totvs.app/api/v1/services

Realize o acesso no ambiente Protheus, em seguida preencher no campo "Programa Inicial" igual a GRRWIZARD.

Para o campo "Ambiente no Servidor",  selecione o ambiente deseja realizar a instalação. Clique em "OK"

Image Added

Selecione oambiente que deseja configurar.

Image Added

Dica
titleProdução e SandBox

Para ambientes de testes e homologação, disponibilizamos o ambiente de SandBox, onde é possível gerar link de pagamento e transações fictícias junto ao provedor de pagamentos.

Em seguida clique em Confirmar.

Image Added

Assistente de configuração está pronto para ser iniciado, clique em "Avançar".

Image Added

Entre com o usuário e senha do administrador Protheus e selecione as empresas que serão integradas ao GRR.

Image Added

Em seguida clique em "Avancar".

Image Added

Após a verificação dos dados de entrada, selecione o botão "Avançar".

Nesta etapa, é necessário selecionar o provedor / intermediador de pagamento que será utilizado pela plataforma. Abaixo serão apresentados os códigos do cadastro, que estarão vinculados ás movimentações financeiras geradas pela plataforma no ERP.

Image Added

Insira o Client ID * e Client Secret *, em seguida clique em "Avançar".

Image Added

 * As informações de  Client ID e Client Secret são enviadas automaticamente no e-mail do administrador do ambiente, assim que o ambiente é provisionado.

Image Added

Após a finalização do Processo de Ativação da Integração, selecione o botão "Concluir".

Image Added

Quando concluído a integração o sistema irá finalizar o processo. Pronto! O Wizard foi executado com sucesso.


Image Added
Card
labelCadastros / Parâmetros Protheus

Configurador / Agendamentos

Configurar o agendamento e execução do serviço GRRJobCommand com a frequência desejada. Certifique-se de que todas as filiais de recorrência estão associadas no agendamento.

Image Added

Configurador / Cadastro / Menus

Será apresentado a tela de "Menus" com algumas opções selecionadas.

Image Added

No canto inferior esquerdo selecione a caixa "Todos os Menus", em seguida marque somente o menu que deseja realizar a configuração, neste exemplo iremos utilizar o menu "Faturamento".

Image Added

No quadrante "Opções" selecione a pasta principal em seguida clique em "Adicionar >>".

Image Added

No quadrante "Novo Menu" selecione o menu que deseja criar a configuração do GRR, clique em "Atualizações".

Na coluna, selecione a opção "Novo Grupo"

Image Added

Adicione a Descrição "Gestão de Receita Recorrente", clique em OK

Image Added

Pronto a criação do Menu foi finalizada, refaça o procedimento caso seja necessário.

Agora vamos Cadastrar os Itens, localize e selecione o menu recem criado "Gestão de Receita Recorrente" em seguida clique na opção "Novo Item".

Image Added

Iremos preencher os campos:

Desc. Português, Espanhol e Inglês.

Programa conforme informado na tabela abaixo;

Módulo: Faturamento (esse módulo foi para exemplo);

Tipo: Função Protheus

Em seguida salve o registro.

Image Added

Grupo: Gestão de Receita Recorrente

Novo Item: Planos x Itens - GRRA020

Image Added

* Não é uma etapa obrigatória, porém através desta interface, é possível visualizar os planos disponíveis, bem como sua composição.

Clique em "Gerar"

Image Added

Coloque o mesmo nome da pasta principal, nesse exemplo será o SIGAFAT, adicione conforme o módulo que estiver cadastrando, me seguida clique me "Gerar".

Image Added

Confirme a gravação "Sim".

Image Added


Confirme a substituição "Sim".

Image Added

Aguarde a Geração do Menu.

Image Added

Pronto ! Configuração finalizada.

E agora aonde vou acessar essa configuração ?

Vá até o modulo onde foi realizado a configuração (Nesse exemplo usamos o "SIGAFAT")

Localize o menu "Atualizações"

Image Added

Desça na barra de rolagem até localizar o Menu Gestão de Receita Recorrente.

Image Added


Cadastro de condição de pagamento

É necessário o cadastro da forma de pagamento RECORRENTE (Tipo 1, Cond.Pagto 1) que indicará que a fatura será direcionada para intermediação e cobrança através da plataforma. Para isso, é necessário marcar a opção "recorrente" no cadastro da condição de pagamento. Nela, você também pode definir como será o processo de geração de Nota Fiscal:

1 - Emite NF após o pagamento (B2C)

Esta opção é utilizada quando a liberação do pedido de venda para faturamento depende da confirmação do pagamento do cliente.

2 - Emite NF no vencimento (B2B)

Esta opção é utilizada quando a liberação do pedido de venda para faturamento não depende da confirmação de pagamento, podendo ocorrer paralelamente ou após a geração da Nota Fiscal.

Image Added

Cadastro de produto / serviço

É necessário indicar os produtos que farão partede um plano recorrente da plataforma GRR, através da rotina de atualização de produtos.

Image Added

Motivo de Baixa

É necessário cadastrar o motivo de baixa do título que será utilizado para baixar o título originalmente gerado ao cliente.

Image Added

Parâmetros

MV_GRRACTI = T - Valida se a integração do GRR está Ativa.
MV_GRRBCOC = 1 - Indica a medida que controla o processo de conciliação das faturas da plataforma. Onde: 1=dias, 2=horas e 3=minutos. Trabalha junto com o MV_GRRBCOV. 
MV_GRRBCOV = 1 - Indica o intervalo (tempo) entre as execuções do  processo de conciliação das faturas da plataforma. 
MV_GRRBPAY = - Banco utilizado para gerar contas a pagar para o  parceiro comercial. 
MV_GRRCPAY =   - Cliente utilizado para gerar o contas a pagar para o parceiro comercial.  
MV_GRRDVEN = 28 - Número de dias para recebimento do título contra a administradora financeira tendo como base o vencimento do título original. 
MV_GRRFPAY =   Fornecedor utilizado para gerar contas a pagar para o adquirente.   
MV_GRRGNOC = 1 - Indica a medida que controla o processo de recorrência das faturas da plataforma. Onde: 1=dias, 2=horas e 3=minutos. Trabalha junto com o MV_GRRGNOV. 
MV_GRRGNOV = 1 - Indica o intervalo (tempo) entre as execuções do  processo de recorrência das faturas da plataforma. Este parâmetro trabalha junto com o MV_GRRGNOC.   
MV_GRRICST = .F. - Verifica se pode customizar os valores e quantidades dos itens dos Planos GRR 
MV_GRRNFSE = UNI - Indica a série para geração das notas fiscais atreladas ao produto GRR. Por padrão utilizamos UNI. 
MV_GRRPPAY =   Fornecedor utilizado para gerar contas a pagar para o parceiro comercial.     
MV_GRRPTXA = 1.99 - Taxa de transação da administradora financeira.   
MV_GRRSBPC = 3 Indica a medida que controla o processo das movimentações de títulos no Protheus. Onde: 1=dias, 2=horas e 3=minutos. Trabalha junto com o MV_GRRSBPV. 
MV_GRRSBPV = 5 Indica o intervalo (tempo) entre as execuções de  sincronismo das movimentações de títulos no Protheus. Trabalha junto com o MV_GRRSBPC.  
MV_GRRSNCC = D - Situação utilizada para gerar contas a pagar para o parceiro comercial.      
MV_GRRSSOC = 3 - Indica a medida que controla o sincronismo de liberação de pedidos pagos. Onde: 1=dias, 2=horas e 3=minutos. Trabalha em conjunto com o MV_GRRSSOV.   
MV_GRRSSOV = 5 - Indica o intervalo (tempo) entre as execuções de liberação dos pedidos pagos na plataforma. Este parâmetro trabalha junto com o MV_GRRSSOC. 
MV_GRRSYNC = 7 - Indica o intervalo em dias em que a sincronização de cadastros entre o Protheus e a plataforma GRR  será executada. 
MV_GRRTPRO = .T. - Gera titulos provisórios a pagar / receber para a adquirente.    
MV_GRRTXPG = .T. - Define se gera um contas a pagar contra a administradora financeira com a taxa da transação. Por padrão taxa será debitada do valor original do título
MV_GRRBPAY = RED|REDE |REDE - Banco utilizado para gerar contas a pagar
MV_GRRCPAY = REDE  |01 - Cliente utilizado para gerar contas a pagar      
MV_GRRFPAY = REDE  |01 - Fornecedor utilizado para gerar contas a pagar  
MV_GRRBPAY = RED|REDE |REDE - Banco utilizado para gerar contas a pagar   
MV_GRRCPAY = REDE  |01 - Cliente utilizado para gerar contas a pagar  
MV_GRRFPAY = REDE  |01 - Fornecedor utilizado para gerar contas a pagar

Serviços de sincronismo de dados (GRRJOBCOMMAND)

Empresa (GRRI010)
Produto (GRRI020)
Planos e Itens (GRRI030)
Cliente (GRRI040)
Subscrição (GRRI050) 
Faturas Pagas (GRRI060)
Recorrência (GRRI080)
Conciliação Bancária (GRRI070)

Tabelas utilizadas

TabelaDescrição
HRDPlanos de Recorrência do GRR  
HREPlano x Itens Recorrentes     
HRFControle de mensagens do GRR  
HRGProduto Recorrente            
HRHAssinatura GRR                
HRIOrdem de Pagamento GRR        
Card
labelRotinas de Protheus GRR

Segue a lista de Rotinas que são utilizadas dentro do Protheus para a Integração com a Plataforma. Essas rotinas são executadas via Job, porém caso necessário poderam ser incluídas via Menu para sua execução.

Rotina Descrição
GRRI020Irá sincronizar os produtos com a plataforma.  
GRRI030Irá sincronizar com os planos e itens criados na plataforma.
GRRI060Irá processar os itens a que foram pagos na plataforma.
GRRI070AProcessará os registros de provisionamente e recebimento da plataforma ( Conciliação )            
GRRI080Função que controla a criação dos pedidos de venda de acordo com as faturas geradas 
pela plataforma                
GRRI090

Função que cria as pastas e envia para plataforma os Boletos Protheus.     

GRRI100

Envio dos titulos pagos no Protheus para a plataforma

FwTotvsLinkJob

Rotina do Frame que faz o processamente de mensagens vindas via SmartLink

Card
idjobScheduler
labelServiços (JobScheduler)

Esta etapa é destinada a configurar a periodicidade e frequênca de execução dos processos do produto.

Deck of Cards
idjobscheduler
Card
labelAcesso / Configuração

Configuração do administrador do RAC e associação de perfil

Para solicitar o acesso e configuração do JobScheduler, você pode seguir os seguintes passos:

  1. Entre em contato com o suporte técnico da Totvs e solicite a ativação do JobScheduler no seu ambiente. Eles podem fornecer informações adicionais sobre como configurar e usar o JobScheduler.
  2. Após a ativação do JobScheduler, você precisará criar e configurar as tarefas ou jobs que deseja executar. Para isso, é recomendável consultar a documentação do JobScheduler para obter orientação sobre como criar e configurar tarefas.
  3. Certifique-se de que as configurações do JobScheduler estejam corretas antes de iniciar a execução dos jobs. Isso inclui verificar as configurações de agendamento, o tempo de execução estimado e as configurações de notificação.
  4. Quando as tarefas estiverem configuradas corretamente, você pode iniciar a execução dos jobs por meio do JobScheduler. É importante monitorar os logs de execução para garantir que os jobs estejam sendo executados corretamente e solucionar quaisquer problemas que possam surgir.
  5. Em resumo, para solicitar o acesso e configuração do JobScheduler na plataforma Totvs, você precisará entrar em contato com o suporte técnico da Totvs e seguir as orientações fornecidas para criar e configurar tarefas ou jobs. Certifique-se de verificar as configurações antes de iniciar a execução dos jobs e monitorar os logs de execução para garantir que tudo esteja funcionando corretamente
Tela de configuração do administrador do RAC

Será disponibilizado o link de acesso para o cadastro de usuário e parametrização dos jobs de trabalho. Nesse passo iremos utilizar o tenantid reservado na documentação Ambiente GRR

Formatação do tenantid: 

De: c63cf3fc969f4bc19c57cf4255f2fd6g

Para: c63cf3fc-969f-4bc1-9c57-cf4255f2fd6g (separando por "-")

Exemplo do link: https://

admin

tenant-"informar o TenantId".rac

.prod

.totvs.app/

totvs.rac/

Image Removed

Tela de

 

Cadastro de Usuários: Realize o cadastro acionando o botão "+Incluir".

Image Modified

Cadastro de Perfis:  Nessa tela o administrador deverá selecionar

o tipo de Scheduler e suas funcionalidades.

os processos do GRR que devem estar associados ao perfil.

Image Added

Associar usuário ao Perfil:  Nessa tela o administrador deverá associar o usuário ao perfil.

Image Added

Card
labelProcessos

Agendamento/Monitoramento dos Jobs associados a plataforma GRR.

Para acessar o serviço, clique no menu Agendamentos na página principal. Siga instruções em: Menu Agendamentos

Ao realizar a autenticação e validação do usuário no JobScheduler o sistema irá apresentar a pagina inicial contendo 02 (dois) Menus:

Image Modified

Monitoramento:

A tela de monitoramento do JobScheduler é uma funcionalidade que permite aos administrador monitorar o status de tarefas ou jobs que foram programados usando o JobScheduler. Essa tela é geralmente integrada ao aplicativo em desenvolvimento e é acessada pelo desenvolvedor para visualizar informações importantes sobre as tarefas em execução.

A tela de monitoramento do JobScheduler exibe informações úteis sobre as tarefas em execução, como a hora de início e término, o status atual da tarefa, o tempo restante até a próxima execução agendada e outras informações relevantes. O administrador pode usar essas informações para monitorar o desempenho do aplicativo e detectar problemas que possam surgir durante a execução de tarefas em segundo plano.

Além disso, a tela de monitoramento do JobScheduler permite que o administrador visualize estatísticas importantes, como o número total de tarefas agendadas e executadas, a taxa de sucesso das tarefas e outras informações relevantes. Isso pode ajudar o desenvolvedor a identificar problemas com o desempenho do aplicativo e a ajustar o agendamento das tarefas para melhorar a eficiência do aplicativo.

Em resumo, a tela de monitoramento do JobScheduler é uma ferramenta essencial para os administrador que desejam monitorar e otimizar o desempenho do aplicativo ao usar o JobScheduler.

Image Modified

Agendamento: 

A tela de agendamento do JobScheduler é uma funcionalidade que permite aos administradores programar tarefas ou jobs para serem executados em momentos específicos ou em determinadas condições.

O JobScheduler é uma API disponível que gerencia a execução de tarefas em segundo plano, permitindo que aplicativos executem tarefas sem afetar a experiência do usuário ou drenar a bateria do dispositivo.

A tela de agendamento do JobScheduler permite que o administrador defina a hora e a frequência de execução de uma tarefa, bem como as condições para que ela seja executada, como a disponibilidade de rede ou a carga da bateria. 

A tela de agendamento do JobScheduler pode ser usada para uma variedade de finalidades, como enviar notificações, sincronizar dados, baixar atualizações e realizar outras tarefas em segundo plano. É uma ferramenta útil para garantir que as tarefas sejam executadas em momentos apropriados, otimizando a eficiência do aplicativo e melhorando a experiência do usuário

Image Modified

Todos os processos associados ao produto Gestão de Receita Recorrente devem ter seus agendamentos configurados, de acordo com a frequência necessária do cliente (única, diária, semanal, mensal).

Processos que necessitam de agendamento:

Image Added

Exemplo de parametrização do processo "Criação de faturas", todos os dias úteis ás 7 da manhã:

Image Added

Card
labelIntermediador de pagamento

Para que a plataforma possa notificar e disponibilizar o link de pagamento, é necessário que seja feita a configuração do provedor que irá intermediar esta transação. Segue abaixo o passo a passo da configuração para os provedores disponíveis:

Deck of Cards
idParametrização dos adquirentes
Card
labelRede (MaxiPago)
Card
defaulttrue
labelRede (MaxiPago)

Procedimento abaixo é destinado a realização do cadastro do intermediador MaxiPago com cartão de crédito, boleto e PIX.

Primeiramente, crie uma conta Maxi Pago e colete as informações necessárias, como nome da empresa, MerchantAccountName / Loja e Api-Key / Chave para serem adicionados na tela de Configurações da Plataforma GRR.

Ao realizar o credenciamento, essas informações são enviadas para o e-mail do credenciado:

Image Added

Tela de acesso ao portal MaxiPago com informações fictícias, meramente ilustrativa.

Image Added

Acesse a plataforma do GRR, em seguida selecione a opção "Configurações". Selecione a organização que será associada a conta de credenciamento MaxiPago e clique em Configurar.

Image Added

Realize o preenchimento dos campos informando os dados das credenciais do cadastro na MaxiPago.

Api-Key/Chave = Chave de integração do estabelecimento (Canais Digitais / MaxiPago)

MerchantAccountName / Loja = Número do estabelecimento (Canais Digitais / MaxiPago)

PV (Ponto de Venda) = Número do ponto de venda do estabelecimento cadastrado na Rede. (Esta informação é necessária para conciliação financeira através dos serviços de gestão de vendas da Rede. Após esta configuração, no portal Rede é necessário autorização do usuário do produto para consultar os dados)

Image Added

Associe o provedor aos métodos de pagamento que serão disponibilizados:

Image Added

Resultado final igual a "Ativo".

Image Added

Informações
titleDocumentação Maxi Pago

https://www.userede.com.br/n/gateway-de-pagamento-rede

Procedimento para configuração do provedor MaxiPago, quando necessário para autorizar o acesso das API´s de gestão de vendas da Rede para a plataforma do GRR – Gestão de Receita Recorrente, de forma manual.

Acesse e realize a autenticação através do site: meu.userede.com.br/home, em seguida clique no ícone de “Notificações” e acesse a opção “Solicitação”.

Image Added

Localize e clique no link “Conciliação”, em seguida selecione a solicitação de acesso.

Image Added

Confirme os dados da empresa, em seguida clique no botão “Compartilhar”.

Image Added

Sistema irá apresentar a mensagem de Compartilhamento realizado com sucesso.

Image Added


Informações
titleDocumentação Maxi Pago

https://developer.userede.com.br/gestao-vendas

Card
labelProtheus

Procedimento abaixo é destinado a realização do cadastro da comunicação bancária do próprio ERP para intermediação do pagamento.

Aviso
titleIntegração GRR x FIN

Primeiramente, certifique-se que o ERP possui toda a configuração bancária cadastrada, para geração de borderô e documento de cobrança (boleto). Certifique-se também de que a função de envio do documento á fatura no GRR foi implementado no RdMake.

*Maiores detalhes vide documentações GRR x FIN - Protheus com o provedor de pagamentos e Backoffice Linha Protheus - SIGAFIN - Boletos no Protheus

Acesse a plataforma do GRR, em seguida selecione a opção "Configurações". Selecione a organização que será associada ao Protheus e clique em Configurar.

Image Added

Resultado final igual a "Ativo".

Card
labelAdyen
Card
labelAdyen

Procedimento abaixo é destinado a realização do cadastro do intermediador Adyen com cartão de crédito, boleto e PIX.

Primeiramente, crie uma conta Adyen e forneça as informações necessárias, como nome da empresa, informações de contato e informações bancárias.

Image Added

Configure a plataforma: Depois de criar uma conta, configure a plataforma Adyen. Isto envolve a configuração de opções de pagamento, configuração de processamento de pagamentos, configuração de notificações e integração com o seu site ou aplicativo.

Abaixo seguem primeiros passos, entretanto demais configurações acessar a documentação do adquirente.

Procedimento para criação do Webhooks da Adyen

Image Added

Clique em Settings.

Image Added

Image Added

Image Added

Realize o preenchimento dos campos do merchant account.

Image Added

Após realizado as demais parametrizações, acesse a plataforma GRR, clique em Configurações e realize o preenchimento dos campos para a empresa selecionada.

Image Added

Image Added

Associe o provedor aos métodos de pagamento que serão disponibilizados:

Image Added

Resultado final igual a "Ativo".

Image Added

Informações
titleDocumentação Adyen

https://docs.adyen.com/?utm_source=ca_test

O procedimento de exclusão do item é utilizado nos casos em que o registro não seja mais necessário para o negócio. Os itens vinculados ao plano ativo não serão afetados com o procedimento.

Na tela Manutenção de Itens selecione um registro aleatório, em seguida clique em Deletar Item.

Image Removed

Sistema disponibiliza a mensagem Item excluído com Sucesso.

Image Removed