Histórico da Página

Nesta seção, realizaremos as configurações iniciais para utilizar o TOTVS Varejo PDV Omni Smart Hub (POSH). Antes de prosseguirmos, é crucial garantir que os requisitos iniciais estejam atendidos.

Caso este passo não tenha sido concluído, pedimos que acesse a seção de Requisitos Mínimos para o uso do TOTVS Varejo PDV Omni Smart Hub (POSH) e finalize esses requisitos.

A partir deste ponto, a equipe de retaguarda assume a responsabilidade pelos dados a serem enviados e também pela integridade dos mesmos.

Nos passos a seguir, demonstraremos como configurar o compartilhamento e a loja, dois tipos de dados de extrema importância para a integração.

Neste fluxo, enviaremos os dados de compartilhamento e loja no mesmo lote. No entanto, também é possível enviá-los em lotes separados, caso seja necessário.

Section

O TOTVS Varejo PDV Omni Smart Hub (POSH) é a camada responsável por orquestrar as operações de sincronização de dados entre o TOTVS Varejo PDV Omni e as suas respectivas retaguardas/ERPs.

Toda comunicação entre a retaguarda/ERP e o PDV Omni será executada e orquestrada pelo POSH.

As informações são disponibilizadas através de serviços web tendo como lógica o trafego por lote.

Informações

title	1 - Procedimentos para Configuração

Expandir

title	Requisitos mínimos para uso do TOTVS Varejo PDV Omni Smart Hub (POSH)

Expandir

title	Inquilino ativo

A criação do inquilino é realizada pelo time de Integração Varejo da TOTVS,

Caso queira saber mais sobre inquilinos clique aqui.

Para solicitar a criação de um inquilino clique aqui.

Expandir

title	Parâmetros cadastrados

No POSH, uma ampla gama de dados é parametrizável. Esses parâmetros são inicialmente definidos pela equipe responsável pelo POSH, mas podem ser ajustados posteriormente conforme necessário.

Esses parâmetros determinam, por exemplo, a quantidade de dados que serão baixados para o PDV Omnishop de um tipo específico.

Eles são cadastrados no microsserviço de Controle e nos microsserviços associados a cada tipo de dado, como, por exemplo, as vendas.

Para saber mais sobre parâmetros clique aqui

Expandir

title	Ativação do RAC

A criação do usuário no RAC é feita pelo time de Integração Varejo da TOTVS no momento em que o inquilino é criado.

Expandir

title	Autenticação

Para realizar requisições no TOTVS VAREJO PDV OMNI SMART HUB (POSH) é necessário ter uma chave de acesso (Token).

Para se obter este token é necessário ter um usuário ativo no RAC e realizar a requisição com as informações corretas.

O usuário do RAC deverá ter a permissão de RETAGUARDA para se conectar com o POSH

Expandir

title	Utilização do Fluxo Online PDV Omnishop -> Retaguarda

Para realizar requisições nos processos de fluxo online, realizados diretamente pelo TOTVS Varejo PDV Omnishop é necessário configurar as APIs necessárias na configuração do MetaData (Json responsável pelos parâmetros utilizados no fluxo online, onde estão armazenados os endpoints, usuário, senha, porta e demais parâmetros necessários para a comunicação com as APIs do RETAGUARDA)

Para saber mais sobre a configuração do campo METADATA, só clicar aqui.

Expandir

title	TOTVS Varejo PDV Omni Smart Hub Client

Expandir

title	Hardware

O POSH, sendo um cliente que será instalado nas máquinas onde está o TOTVS Varejo PDV Omni, segue os mesmo requisitos de hardware do Pdv Omni.

Para saber mais sobre esses requisitos mínimos acesse a documentação do PDV Omni sobre Requisitos Minimos de Software e Hardware

Expandir

title	Software

Os requisitos mínimos de software para executar o POSH podem ser consultados clicando aqui

Expandir

title	Configurações

As configurações necessária para executar o POSH podem ser consultados clicando aqui

Expandir

title	Fluxo inicial de cadastro

draw.io Diagram

diagramName
border	true

configurações iniciais

diagramWidth
fluxo_sync_minimalista
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true

741

541
revision	2

Aqui iremos mostar o passo a passo para seguir este fluxo. Salientamos que as informações mais completas sobre fluxos ou tipo de dados estão em suas respectivas páginas e podem ser acessadas através dos links nessa página.

Passo 1 - Abertura de lote
- Deve ser aberto um lote com os tipo 1 (Loja) e 6 (Compartilhamento)
Passo 2 - Envio dos dados de compartilhamento para o POSH
Passo 3 - Envio dos dados de loja para o POSH
Passo 4 - Fechamento do lote

Após o envio dessas informações, os dados já estão esperando para serem baixados pelo POSH no PDV Omnishop

Esse passo precisam ser refeito sempre que precisar realizar o cadastro de uma loja, toda loja tem um compartilhamento para que a inteligência do POSH identifique para qual loja mandar os dados

Expandir

title	Monitoramento e log

Os logs no POSH são exclusivamente para o time de produto e o time de suporte.
Todos os microsserviços e aplicações do POSH fazem uso dos logs para sabermos informações mais detalhada de como tudo está funcionando, estes logs são gravados no Grafana que centraliza todos os logs..
Para acessar a parte de logs clique aqui.

...

Informações

title	1 - Procedimentos para Configuração

...

Informações

title	2 - Envio de dados com o POSH

Expandir

title	Envio de dados do ERP para o PDV Omni

Aqui temos os passos para que seja feito o envio de dados do ERP para o PDV Omni.

Caso queira saber o fluxo completo que o dado enviado pela retaguarda percorre visualize a seção fluxomagramas POSH logo abaixo

Expandir

title	Envio de dados do PDV Omni para o ERP

Os dados gerado ou alterados no PDV Omni podem ser enviados para a retaguarda por dois fluxos

Fluxo Síncrono (Online)
- Os dados são enviados diretamente do PDV para o ERP.
Fluxo Assíncrono (Offline)
- Os dados são enviados para o POSH e a retaguarda busca esses dados posteriormente.

Mais informações sobre os dois fluxos podem ser encontradas na seção 3 - Fluxogramas POSH

border

Informações

title	3 - Fluxogramas POSH

Inclusão de trecho

nopanel
	Fluxos de dados POSH
	Fluxos de dados POSH

Expandir

title	Fluxo de envio de dados

draw.io Diagram

	true

diagramNameFluxo envio de dados simpleViewerfalsewidthlinksautotbstyletoplboxtruediagramWidth1321revision8

Expandir

title	Fluxo de envio de dados da retaguarda para o PDV Omni

A retaguarda (1) faz a abertura do lote no controle (2)
A retaguarda (1) faz o envio de dados para os microsserviços (3)
Os microsserviços (3) salvam os dados em seus respectivos bancos de dados (4)
A retaguarda (1) faz o fechamento do lote no controle (2)
O microsserviço de Controle (2) salva um dado no banco de dados de tempo real (5)
O banco de dados em tempo real (5) sinaliza o POSH Client Controle (6) que há dados para baixar
O POSH Client Controle (6) sinaliza o POSH Client Down (7) que há dados para baixar
O POSH Client Down (7) solicita ao microsserviço Controle (2) os lotes para baixar
O microsserviço Controle (2) devolve os lotes que tem que ser baixados para o POSH Client Down (7)
O POSH Client Down (7) busca os dados nos microsserviços(3)
Os microsserviços (3) devolve os dados para o POSH Client Down (7)
O POSH Client Down (7) salva os dados no banco do PDV Omni (9)
O POSH Client Down (7) atualiza as informações do lote no microsserviço Controle

Expandir

title	Fluxo de envio de dados do PDV Omni para a Retaguarda no fluxo offline

O PDV Omni (9) gera o dado que irá subir
O POSH Client Up (8) recupera esse dado e envia ao microsserviço (3)
O microsserviço (3) atualiza o banco de dados (4)
O POSH Client Up (8) sinaliza para o PDV Omni (9) que os dados foram integrados
A retaguarda (1) faz uma requisição para o microsserviço (3) e recupera os dados

Expandir

title	Fluxo de envio de dados do PDV Omni para a Retaguarda no fluxo online

O PDV Omni (9) gera o dado que irá subir
O PDV Omni (9) envia esse dado para o microsserviço Controle (2)
O microsserviço Controle (2) envia para a Retaguarda (1) através de url preveamente cadastradas

Informações

title	4 - Documentação técnica

Expandir

title	POSH Server

Exibir filhos

page	Microserviços

Expandir

title	POSH Client

Exibir filhos

page	Cliente TOTVS Varejo PDV Omni Smart Hub

Informações

title	5 - Informações Úteis

Exibir filhos

page	Informações Uteis

Informações

title	4 - Documentação técnica

Expandir

title	POSH Server

Exibir filhos

page	Microserviços

Expandir

title	POSH Client

Exibir filhos

page	Cliente TOTVS Varejo PDV Omni Smart Hub

Informações

title	5 - Informações Úteis

Exibir filhos

page	Informações Uteis

Informações

title	6 - Troubleshooting

Lote criado, populado com dados e fechado. Não consigo encontrar se o loja lote está disponibilizado ?
- 1 - Verificar status do Loja Lote

Dado enviado pela retaguarda não integrado no PDV ?
- 2 - Como identificar se dado foi enviado corretamente.
- 3 - Verificar se o dado, via lote, foi baixado no PDV.

Venda enviada pelo PDV para a retaguarda está disponível para ser integrada ?
- 4 - Verificar se há venda disponível para baixa.

Verificação se serviços estão ativos na loja
- http://grafana-rocprime.eastus.cloudapp.azure.com:3000/d/de14702d-f3d5-4a1e-b775-8414ad32be8a/indicadores-pdv-sync?orgId=3&refresh=15m

Problemas de subida e descidas de dados ? Os dados não descem da retaguarda para o PDV e nem sobem do PDV para a Retaguarda ?
- Verifique se a máquina do PDV, que possui os serviços client do PDVSync, estão com acesso liberado para se comunicar com o PDVSync Server.
  - Basta acessar essa URL no PDV:
    - https://pdvsync.varejo.totvs.com.br/controleprocesso/api/monitoramento/validations
      - Retorno esperado para haver comunicação:
        Image Added

Problemas na descida de dados? Olhou no lojaloteRetorno e teve este retorno:

Bloco de código

title	LojaloteRetorno

{
                    "tipoLote": 0,
                    "idRetaguarda": "00000000-0000-0000-0000-000000000000",
                    "erro": "Erro no Client ao integrar Produto Erro: 42P01: relation \"public.sync_carga_produto_validacao\" does not exist\r\n\r\nPOSITION: 15 20240814113448914 ",
                    "tipoLojaLote": 12,
                    "pagina": 0,
                    "hasnext": false
                }

Verifique a permissão de leitura e gravação da pasta TOTVSPDV

Informações

title	7

Informações

title	6 - Solicitação de apoio

O time de produto do POSH atua no projeto DVARINT1, qualquer acionamento ao time de produto por outras equipes deverá ser feito através da abertura de apoios no jira.

Para que o apoio seja realizado, algumas informações devem ser enviadas previamente para que o time de produto possa dar início ao apoio. Segue abaixo o que deve ser enviado na abertura do apoio.

Segue os projetos existentes para abertura: PDVSYNC - DVARINT / PSH - DVARLOJ / WSH - DDWMISSI / PDV - DVARLIVEPDV

Expandir

title	Template

1 - Qual a Jornada/processo?
R:

2 - Qual o Ambiente?
R:

3 - Qual é o Inquilino?
R:

4 - Descrição do Erro
R:

5 - Foi feito os Troubleshooting básicos?
R:

6 - Quais as datas / Versão Qual versão dos serviços? (Api, Client, Down)
R:

7 - Incluir os logs se houver
R:

8 - Existe(m) lote(s) relacionado(s) a esta caso? Qual o número(s) do(s) lote(s)?
R:

9 - Disponibilizar backup do banco do PDV.

10 - ApiRest do cliente se houver (online):
URL:
Usuário:
Senha:

10 11 - Qual a requisição esta sendo feita para o PDVSync (online) ?

R:

1112- Quais são os dados de autenticação (tenant/usuário) utilizados utilizados (online) ?

R:

Árvore de páginas

Versões comparadas

Versão antiga 88

Nova versão 126

Chave