Histórico da Página

infotitleProcedimentos para Configuração

Section

O TOTVS Varejo PDV Omni Smart Hub (POSH) funciona como uma camada de comunicação entre o PDV OMNISHOP e as retaguardas TOTVS. é 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

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

Muitos dados no POSH são parametrizáveis. Esses parâmetros são criados pela equipe do POSH porém podem ser alterados posteriormente caso necessário.

Os parêmetros ditam, por exemplo, a quantidade de dados que serão baixadas no PDV Omnishop de determinando tipo.

Os parâmetros são cadastrados no microsserviço de Controle e nos microsserviços de cada tipo de dado, como por exemplo a venda.

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


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

Informações

title	1 - Procedimentos para Configuração

Informações

title	2 - Envio de dados com o POSH

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 de dados de compartilhamento para o POSH
Passo 3 - Envio dos dados de loja para o POSHFechamento do lote
Passo 4 - Fechamento Monitoramento 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	Fluxo inicial de cadastro	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

Nesta seção iremos fazer as configurações iniciais para uso do TOTVS Varejo PDV Omni Smart Hub (POSH), antes de iniciarmos essas configurações, devemos ter os requisitos iniciais.

Caso esse passo não esteja concluído, favor acessar a seção de Requisitos mínimos para uso do TOTVS Varejo PDV Omni Smart Hub (POSH) e finalizar os requisitos.

A partir desse ponto a retaguarda é responsável pelos dados que serão enviados e também responsáveis pela integridade dos dados.

Nos passos abaixo iremos mostrar como realizar a configuração de compartilhamento e loja, dois tipo de dados extremamente importante para a integração.

Neste fluxo mandaremos os dados de compartilhamento e loja no mesmo lote, porém também podem ser mandados em lotes separados caso necessário.

draw.io Diagram

border

true

diagramName

configurações iniciais

simpleViewer

false

width

links

auto

tbstyle

top

lbox

true

diagramWidth

741

revision

2

Informações

title	Envio de dados do ERP para o PDV Omni

Expandir

title	Detalhamento

O envio dos dados segue o seguinte fluxo

...

title	Fluxogramas POSH

...

title	Fluxo de envio de dados

...

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:

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

Informações

title	Documentação técnica

Exibir filhos

page	Microserviços

Informações Uteis

Informações

title	Informações Úteis

Exibir filhos

page

Árvore de páginas

Versões comparadas

Versão antiga 64

Nova versão 126

Chave