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.
|
info | title | Procedimentos para Configuração | | |
---|
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 |
---|
|
|
Expandir |
---|
| - Inquilino ativo na base do POSH
- Usuário e senha do RAC
- Acesso validado com token
|
Expandir |
---|
title | Configurações iniciais |
---|
| |
|
Informações |
---|
icon | false |
---|
title | Envio de dados do ERP para o PDV Omni |
---|
|
Expandir |
---|
|
|
Todo a arquitetura do funciona através do envio de lotes.Podemos imaginar um lote como um container em um navío, esse container contêm os dados que serão enviados para a(s) loja(s).
O envio dos dados segue o seguinte fluxo
- Abertura de lote
- Envio dos dados
- Fechamento do lote
- Monitoramento do lote
Abaixo está listado cada passo e as informações para o envio.
Expandir |
---|
title | Passo 1 - Abertura de lote |
---|
|
Expandir |
---|
|
Para se abrir um lote é necessário fazer uma requisição para o micro serviço do PDVSync,Core.Controle.
- Endpoint: /api/retaguarda/inquilinolotesexternos
- Método: Post
- Autenticação: Bearer token
- Permissão: Retaguarda
O retorno dessa requisição gerará um código chamado loteOrigem, ele é de suma importância, pois, esse código identifica qual o lote que pertence o(s) dado(s) e deverá ser passado no envio dos dados para que a integração funcione corretamente.
Expandir |
---|
|
{
"status":0,
"tipoLote":[
17
],
"idInquilino":"{{IdInquilino}}"
} Expandir |
---|
title | Definição dos campos de requisição |
---|
|
Campo | Tipo | Descrição | Observações |
---|
idInquilino | string | idInquilino gerado na criação do inquilino | Não Nulo |
tipoLote | Lista de string | Lista dos tipos de dados a serem enviados. São aceitos vários tipos. (Tipos na seção Tipos Lote) | Não nulo |
status | string | Status do lote, na abertura sempre enviar 0 - Inicio Envio | Não nulo |
Expandir |
---|
|
Os tipos de dados passados na requisição são os seguintes: Cliente = 0 Loja = 1 Motivo = 2 Perfil = 3 Usuario = 4 FcpProduto = 5 Compartilhamento = 6 Imposto = 7 Ncm = 8 PisCofins = 9 TributoNcm = 10 ClassificacaoProduto = 11 Produto = 12 Preco = 13 Estoque = 14 Operadora = 15 DadoComplementarPagto = 16 CondicaoPagto = 17 FormaPagto = 18 CanalVenda = 24 AlteracaoCliente = 40 AlteracaoImposto = 47 AlteracaoNcm = 48 AlteracaoPisCofins = 49 AlteracaoTributoNcm = 50 AlteracaoClassificacaoProduto = 51 AlteracaoProduto = 52 AlteracaoPreco = 53 AlteracaoEstoque = 54 PreVenda = 55 ClienteEndereco = 56 |
Expandir |
---|
title | Retorno da requisição |
---|
|
{
"success":true,
"message":"",
"data":{
"loteOrigem":"{LoteOrigem}",
"mensagem":null,
"status":0,
"tipoLote":[
"17"
],
"idInquilino":"{IdInquilino)",
"dataAtualizacao":"{DataAtualizacao}",
"dataCadastro":"{DataCadastro}",
"id":"{Identificador}",
"_expandables":[]
}
} Expandir |
---|
title | Definição dos campos de retorno |
---|
|
Campo | Tipo | Descrição |
---|
Success | bool | Indica se a criação do lote foi feita com sucesso |
Message | string | Caso ocorra erros durante a criação do lote eles serão enviados nesse campo |
Data | objeto | Objeto lote criado |
Data.LoteOrigem | string | Número de identificação do lote |
Data.Mensagem | string | Data.Status | int | Status do lote |
Data.TipoLote | List String | Lista de tipos de dados que serão enviados no lote |
Data.IdInquilino | string | idInquilino vinculado ao lote |
Data.DataAtualização | datetime | Data da ultima atualização do registo |
Data.DataCadastro | datetime | Data de criação do lote |
Data.Id | string | Identificador do lote no banco |
Expandir |
---|
title | Passo 2 - Envio dos dados |
---|
|
Informações |
---|
|
Expandir |
---|
title | Fluxo Assíncrono (Offline) |
---|
| Image Removed |
Expandir |
---|
title | Fluxo Síncrono (Online) |
---|
| Image Removed |
|
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
|
|
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 |
---|
| Exibir filhos |
---|
page | Cliente TOTVS Varejo PDV Omni Smart Hub |
---|
|
|
|
Informações |
---|
title | 5 - Informações Úteis |
---|
|
|
Informações |
---|
|
- Lote criado, populado com dados e fechado. Não consigo encontrar se o loja lote está disponibilizado ?
- Dado enviado pela retaguarda não integrado no PDV ?
- Venda enviada pelo PDV para a retaguarda está disponível para ser integrada ?
- Verificação se serviços estão ativos na loja
- 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:
|
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 / WSH - DDWMISSI / PDV - DVARLIVEPDV Expandir |
---|
| 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 | Procedimentos para Utilização |
---|
|
|