Árvore de páginas

Versões comparadas

Chave

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

...

Deck of Cards
id2C
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 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 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 Totvs. 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.

Card
labelExecução do Wizard Protheus
Aviso
titlePré-requisitos

Protheus na release 12.1.2210, com pacote de expedição contínua atualizado .
Protheus na release 12.1.2310, com pacote de expedição contínua atualizado

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

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 app.fluigidentity.com

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

Bloco de código
languagetext
titleAppserver.ini
 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 Sandbox.

Em seguida clique em Confirmar.

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

Selecione as empresas que serão integradas no GRR.

Em seguida clique em "Avancar".

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

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

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 Protheus. Pronto o Wizard foi instalado com sucesso.


Card
id9
labelCadastros / Parâmetros Protheus

Cadastro de Menu

Gestão de Receita Recorrente

Planos - Rotina GRRA020
Planos x Itens - Rotina GRRA030GRRA030

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

Empresa (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 forma de pagamento

É necessário o cadastro da forma de pagamento RECORRENTE, 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

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

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. 

Card
labelConfiguraçã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.totvs.app/ 

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

Cadastro de Perfis:  Nessa tela o administrador deverá selecionar o tipo de Scheduler e suas funcionalidades.

Tela de 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/

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

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.

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

Deck of Cards
idParametrização dos adquirentes
Card
labelMaxi Pago
Card
defaulttrue
labelMaxi Pago

Procedimento abaixo é destinado a realização do cadastro do adquirente Maxi Pago

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.

Tela com informações fictícias, meramente ilustrativa.

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

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

Acesse a plataforma do GRR, em seguida selecione a opção "Configurações". Selecione a organização recém criada logo após clique em Configurar.

Realize o preenchimento dos campos informando com o conteúdo armazenado na criação do cadastro na MaxiPago.

Resultado final igual a "Ativo".

Informações
titleDocumentação Maxi Pago

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

Card
labelAdyen
Card
labelAdyen

Procedimento abaixo é destinado a realização do cadastro do adquirente Adyen com cartão de crédito.

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.

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

Clique em Settings.

Realize o preenchimento dos campos do merchant account.

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.


Informações
titleDocumentação Adyen

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