Histórico da Página

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.

draw.io Diagram

border	true

diagramName	fluxo_sync_minimalista
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true
diagramWidth	541
revision	2

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

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.

Informações

title	1 - Procedimentos para Configuração

Expandir

title

Expandir

title	Inquilino ativo

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.

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

Informações

title	2 - Envio de dados com o POSH

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

border

true

diagramName

configurações iniciais

simpleViewer

false

width

links

auto

tbstyle

top

lbox

true

diagramWidth

741

revision

2

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	2 - Envio de dados do ERP para o PDV Omni

Expandir

title	Detalhamento

O envio dos dados segue o seguinte fluxo

...

title	3 - Fluxogramas POSH

...

title	Fluxo de envio de dados

...

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) fas 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

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

Informações

title	3 - Fluxogramas POSH

Inclusão de trecho

	Fluxos de dados POSH
	Fluxos de dados POSH
nopanel	true

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 - 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 - 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:

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

R:

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

R:

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 Uteis

Informações

title	5 - Informações Úteis

Exibir filhos

page

Árvore de páginas

Versões comparadas

Versão antiga 81

Nova versão 126

Chave