01. VISÃO GERAL

Visando melhorar a forma que é feita a integração dos dados entre a Retaguarda, Central PDV e PDV, disponibilizamos a Integração TOTVS PDV.
A Integração TOTVS PDV é uma solução de integração de dados robusta e flexível projetada para facilitar a transferência eficiente de dados entre os ambientes, com sua arquitetura baseada em API REST, a Integração TOTVS PDV simplifica o processo permitindo que os ambientes Central PDV e PDV estejam atualizados conforme os dados da Retaguarda de maneira rápida e segura.

Recursos Principais:

a.Transferência dos dados utilizando API REST: Proporcionando uma conexão rápida, segura e confiável.

1. 1. Múltiplas threads para a baixa dos dados: Oferece a opção de configuração de várias threads, possibilitando baixar os dados de integração de mais de uma tabela de forma paralela.

   2. Monitoramento: Disponibiliza um monitor oferecendo diversos tipos de visões de monitoramento, possibilitando verificar o status de cada registro de integração, separados por ambiente.

   3. Escalabilidade e Desempenho: Arquitetura garante que a Integração PDV possa lidar com grandes volumes de dados e se adaptar às necessidades do seu negócio à medida que ele cresce.

02. INCLUINDO AS ROTINAS NO MENU

Acesse o módulo Configurador, Ambiente → Cadastros → Menus, selecione o menu Controle de Lojas.

Inclua as rotinas conforme a lista abaixo:

Inclua o grupo Integração TOTVS PDV no menu Atualizações > Smart Hub, e neste grupo, inclua as rotinas Grupos de Tabelas, Ponto de Integração e Configuração de Assinante e no Sub Grupo chamado Wizards inclua as rotinas Integração Manual.

03. PRÉ REQUISITOS

Para o funcionamento da Integração TOTVS PDV é necessário que as tabelas citadas abaixo estejam nesta configuração:

Existência das tabelas MHO, MHP, MHQ, MIP, MIN, MHP, MIQ e MIR.

Compartilhamento:

É necessário que o serviço REST esteja ativo no server da Retaguarda que irá gerar as integrações.

Exemplo de configuração do REST

04. CONFIGURAÇÃO ASSINANTE TOTVS PDV

           Na tela de configuração do Assinante TOTVS PDV, informe as seguintes informações:

            Usuário: Usuário para acesso ao Rest, este usuário não precisa ter acesso a nenhum módulo.

            Senha: Senha do usuário para acesso ao Rest.

            Url Rest: Url do Rest configurado no ambiente.

            Quantidade máxima por lote de integração: Informe a quantidade máxima de registros por lote da integração.

05. CADASTRO GRUPO DE TABELAS

No cadastro de Grupo de Tabelas é possível informar as tabelas que deseja gerar a integração dos dados, separando essas tabelas em grupos da forma que desejar.

No módulo Controle de Lojas na Retaguarda, acesse o menu Atualizações →  Integração TOTVS PDV → Grupo de Tabelas, ao acessar a tela pela primeira vez será apresentado a mensagem perguntando se deseja que sejam criados automaticamente os grupos de tabelas padrões, caso escolha por criar, serão criados alguns grupos com as tabelas mínimas necessárias para a realização de vendas no PDV ou Central PDV.

Caso necessite, é possível alterar ou excluir os grupos padrões e criar novos grupos com as tabelas de sua preferência.

Esta tela oferece também a opção de Ativar ou Desativar o grupo, com isso, se por alguma razão haja a necessidade de cessar a geração de integração de algum grupo, é possível desativá-lo.

Devido ao relacionamento de tabelas, não é possível deletar a tabela do grupo, mas sim, desativar a tabela, com isso não é mais gerado a integração desta tabela, e permite que esta tabela seja inclusa em outro grupo. 

Não é possível uma mesma tabela estar como ativa em mais de um grupo.

IMPORTANTE!

Só serão gerados registros de Integração das tabelas Ativas no grupo, sendo assim os grupos desativados e tabelas desativadas no grupo não terão os registros de integração gerados.

06. CADASTRO DE PONTO DE INTEGRAÇÃO

Ponto de Integração é qualquer outro ambiente que receberá a integração gerada pela Retaguarda, podendo ser uma Central PDV ou o próprio TOTVS PDV.

No módulo Controle de Lojas na Retaguarda, acesse o menu Atualizações → Integração TOTVS PDV → Ponto de Integração.

Também é possível desativar o Ponto de Integração, com isso, não serão mais gerados registros de Integração para este Ponto de Integração.

IMPORTANTE!

Só serão gerados registros de integração para os Pontos de Integração Ativos.

07. CONFIGURAÇÃO DOS JOBS DA RETAGUARDA

Deverá ser configurado dois JOBS, são eles: RMIPublica e RMIEnviaPdv, veja abaixo mais detalhes.

RMIPublica

Abra o Appserver.ini e configure o JOB conforme o exemplo abaixo:

[OnStart]
Jobs=RMIPUBLICA_1
RefreshRate=5

[RMIPUBLICA_1]
Main=RmiPublica
Environment=NOME DO AMBIENTE
nParms=6
Parm1=CODIGO DA EMPRESA
Parm2=CPDIGO DA FILIAL
Parm3=1
Parm4=10:00:00
Parm5=2
Parm6=CÓDIGO DOS GRUPOS

O serviço JOB RMIPublica é responsável por ler as tabelas de dados dos grupos e publicar os registros em formato JSON. Essa publicação ocorre sempre que há uma alteração nos registros das tabelas. Os registros em formato JSON são então gravados na tabela MHQ.

IMPORTANTE!

O parâmetro nParm5 devera estar configurado com o valor 2

O parâmetro nParm6 devera ser informado o código dos grupos separado por virgula, exemplo: 001,002. Se achar necessário, pode criar outra chave (RMIPUBLICA_2) e informar outros grupos, com isso o ambiente terá em execução 1 ou mais threads do RMIPublica executando simultaneamente sem que aja concorrência. 

RMIEnviaPdv

Abra o Appserver.ini e configure o JOB conforme o exemplo abaixo:

[OnStart]
Jobs=RMIENVIAPDV_1
RefreshRate=5  

[RMIENVIAPDV_1]
Main=RmiEnviaPdv
Environment=NOME DO AMBIENTE
nParms=4
Parm1=CODIGO DA EMPRESA
Parm2=CODIGO DA FILIAL
Parm3=10:00:00
Parm4=CÓDIGO DOS GRUPOS

O serviço RMIEnviaPdv tem como objetivo ler os registros da tabela MHQ onde o campo MHQ_STATUS é igual a 1 e endereçar cada registro para os respectivos Pontos de Integração. O endereçamento é feito com base nas regras de compartilhamento definidas em cada tabela, exemplo, se um determinado produto é da filial 01 portanto somente os Pontos de Integração que pertencem a filial 01 é que irão receber esses registros.

O RMIEnviaPdv grava os registros na tabela MIP com o campo MIP_STATUS igual a 1 e posteriormente esses registros são enviados aos ambientes da Central de PDV e o TOTVS PDV.

Status que são gravados na tabela MIP:

08. CONFIGURAÇÃO DA CENTRAL DE PDV E DO TOTVS PDV

No AppServer.ini da Central de PDV e do TOTVS PDV devemos agora configurar o JOB RMIIntePdv, esse é o serviço responsável de fazer as buscas dos dados na Retaguarda para serem gravados na base local da Central de PDV e no TOTVS PDV.

Esse JOB apenas busca os registros cujo o campo MIP_STATUS na Retaguarda seja igual a 1.

[OnStart]
Jobs=IntegracaoPdv_1
RefreshRate=5  

[IntegracaoPdv_1]
Main=RmiIntePdv
Environment=NOME DO AMBIENTE
nParms=6
Parm1=CODIGO DA EMPRESA
Parm2=CODIGO DA FILIAL
Parm3=CODIGO DO PONTO DE INTEGRAÇÃO
Parm4=CODIGO DO GRUPO
Parm5=CONFIGURE 1 PARA ATIVAR O LOG OU 0 PARA DESATIVAR
Parm6=10:00:00

Observações:

• • Parm3: Deverá ser informado o código do Ponto de Integração que foi cadastrado para essa filial, cada estação deverá ter o seu Ponto de Integração cadastrado não podendo ser o mesmo código para varias estações;
  • Parm4: Deverá ser informado um ou mais código de grupos separado por virgula. Para se ter uma melhor performance e exclusividade em determinado grupo, a recomendação é separar esse grupo em uma chave exclusiva do RmiIntePdv e informar essa nova chave no [OnStart];
  • Parm6: Deverá informar o tempo que a thread permanecera ativa na memória do server, quando não informado esse parâmetro o tempo default é de apenas 5 minutos.  

09. INTEGRAÇÃO MANUAL

No Wizard de Integração Manual é possível gerar Integrações de Grupos de Tabelas, Parâmetros e Tabelas da SX5.

Pela Retaguarda, módulo do Controle de Lojas acesse, Atualizações → Integração TOTVS PDV → Wizards → Integração Manual

A. Integração de Grupos de Tabelas

A Integração de Grupos de Tabelas gera os registros de integração das tabelas dos grupos selecionados, nela é possível selecionar a Filial o Ponto de Integração e os Grupos de Tabelas que deseja gerar os dados.

Para a geração, selecione a opção Grupos de Tabelas e avance. Na próxima tela, selecione as filiais, e na tela seguinte selecione os Pontos de Integração e os Grupos de Tabelas que deseja gerar a integração.

IMPORTANTE!

A geração de Integração de Grupos de Tabelas irá gerar a integração de todos os dados das tabelas dos grupos, se assemelhando a carga completa da antiga rotina de Carga.

B. Integração de Parâmetros

A Integração de Parâmetros serve para gerar a integração do conteúdo dos parâmetros informados da Retaguarda para os Pontos de Integração da Filial selecionada.

Selecione a opção Parâmetros e avance. Na próxima tela, selecione as filiais, e na tela seguinte informe os parâmetros que deseja gerar a integração.

C. Integração de Tabelas da SX5

A Integração de Tabelas da SX5 serve para gerar a integração do conteúdo das tabelas da SX5 selecionadas do ambiente Retaguarda para os Pontos de Integração da Filial selecionada.

Selecione a opção Tabelas SX5 e avance. Na próxima tela, selecione as filiais, e na tela seguinte selecione as tabelas que deseja gerar a integração.

10. ATUALIZAÇÃO DE SENHAS

DT Função para atualização de senhas de usuário

IMPORTANTE!

Programar a rotina de senhas para ser executada no período em que não tenha nenhum usuário logado no ambiente Central de PDV ou TOTVS PDV.

11. MONITOR DE INTEGRAÇÃO

Monitor da Integração de Dados do TOTVS PDV