Histórico da Página

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.

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

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:

[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"

Selecione oambiente que deseja configurar.

Em seguida clique em Confirmar.

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

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

Em seguida clique em "Avancar".

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.

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

 * 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.

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á finalizar o processo. Pronto! O Wizard foi executado com sucesso.

Cadastro de Menu

Gestão de Receita Recorrente

Planos - GRRA010
Planos x Itens - GRRA020

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 condição 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.

Image Removed

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.

Image Removed

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. 

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