Histórico da Página

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

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

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

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

Informações

title	Envio de dados do ERP para o PDV Omni

Expandir

title	Detalhamento

O envio dos dados segue o seguinte fluxo

Informações

title	Fluxogramas POSH

Expandir

title	Fluxo Assíncrono (Offline)

Image Removed

Expandir

title	Fluxo Síncrono (Online)

Image Removed

Informações

title	Documentação técnica

Exibir filhos

page	Microserviços

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 Uteis

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	Informações Úteis

Exibir filhos

page

Árvore de páginas

Versões comparadas

Versão antiga 58

Nova versão 126

Chave