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 |
---|
|
|
Informações |
---|
title | 1 - Procedimentos para Configuração |
---|
| Expandir |
title |
Mínimos |
- Inquilino ativo na base do POSH
- Usuário e senha do RAC
- Acesso validado com token
|
Expandir |
---|
title | Configurações iniciais |
---|
|
|
Informações |
---|
|
Informações |
---|
title | 2 - Envio de dados com o POSH |
---|
|
|
icon | false |
---|
| title | Envio de dados do ERP para o PDV Omni |
---|
|
Expandir |
---|
| Todo a arquitetura do TOTVS Varejo PDV Omni Smart Hub (POSH) 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 |
|
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
|
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 |
---|
| 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 |
---|
|
|