Á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 na Configuração do GRR, Execução do Wizard Protheus, Cadastros e parâmetros Protheus, Configuração do Serviços (JobScheduler e Parametrização dos adquirentes. ) 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
labelConfiguraçã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 Recorrente

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.

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

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

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.

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
labelExecução do Wizard 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 na release 12.1.2210 , com pacote de expedição contínua atualizado Image Removed.atualizada: Arquivo 1Image AddedArquivo 2Image Added
ou
Protheus na release 12.1.2310 , com pacote de expedição contínua atualizado atualizada: Arquivo 1Image AddedArquivo 2Image Modified

Para que possa ocorrer a integração com o produto GRR - Gestão de Receita Recorrente é necessário a execução do Wizard Protheus.
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

*
No caso do ambiente ser CLOUD, o mesmo
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"

Selecine o Modo SandboxSelecione oambiente que deseja configurar.

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.

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

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

Em seguida clique em "Avancar".

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

Nesta etapa, será necessário preencher as é 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

. Essas credenciais

são enviadas automaticamente no e-mail do administrador do ambiente, assim que o ambiente é provisionado.

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

Image Removed

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

Quando concluído a integração o sistema irá disponibilizar a tela de autenticação do Protheusfinalizar o processo. Pronto o ! O Wizard foi instalado executado com sucesso.

Image Removed


Image Added
Card
id9
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

Planos - GRRA010
Planos x Itens - GRRA020

Serviços de integração / sincronismo de dados

" 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 AddedEmpresa (GRRI010)
Produto (GRRI020)
Planos e Itens (GRRI030)
Cliente (GRRI040)
Subscrição (GRRI050) 
Faturas Pagas (GRRI060)
Recorrência (GRRI080)
Conciliação Bancária (GRRI070)


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.

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.

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 integracao do GRR esta Ativa. 

MV_GRRICST = .F. - Verifica se pode customizar os valores e quantidades dos itens dos Planos GRR (Alterar para .T. quando é necessário realizar medição)

MV_GRRNFSE = UNI - Indica a serie para geracao das notas fiscais atreladas ao produto GRR. Por padrao utilizamos UNI. 

MV_GRRTPRO = .T. - Gera titulos provisiorio a pagar / receber para a adquirente. 

MV_GRRTXPG - .T. - Gera titulo a pagar com os valores de taxa para a adquirente. 

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

Configuração do JobScheduler

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://tenant-"informar o TenantId".rac.

staging.

Image Removed

Tela de

totvs.app/ 

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.

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://tenant-"informar o TenantId".scheduler.staging.totvs.app/

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:

Maxi Pago
Deck of Cards
idParametrização dos adquirentes
Card
label
Maxi Pago
Rede (MaxiPago)
Card
defaulttrue
label
Rede (MaxiPago)

Procedimento abaixo é destinado a realização do cadastro do

adquirente Maxi Pago

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

a

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 Modified

Abra o Swagger e realize o procedimento de autenticação (saiba mais clicando em aqui), em seguida localize o endpoint "Organizations" 

Image Removed

Realize o preenchimento dos valores e realize a requisição.

Image Removed

Acesse a plataforma do GRR, em seguida selecione a opção "Configurações". Selecione a organização

recém criada logo após

que será associada a conta de credenciamento MaxiPago e clique em Configurar.

Image Modified

Realize o preenchimento dos campos informando

com o conteúdo armazenado na criação

os dados das credenciais do cadastro na MaxiPago.

Image Removed

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 Modified

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

adquirente

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 Modified

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 Modified

Clique em Settings.

Image Modified

Image Modified

Image Modified

Realize o preenchimento dos campos do merchant account.

Image Modified

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 Modified

Image Modified

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