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. |
Informações |
---|
title | 1 - Procedimentos para Configuração |
---|
|
Expandir |
---|
|
title | Requisitos mínimos para uso do TOTVS Varejo PDV Omni Smart Hub (POSH) |
---|
|
Expandir |
---|
|
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 |
---|
|
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 |
---|
|
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 |
---|
|
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 | Tabelas criadas na base de dados do Totvs Varejo PDV Omni |
---|
|
Para realizar as operações de descida de dados no TOTVS VAREJO PDV OMNI SMART HUB (POSH) é necessário ter as seguintes tabelas criadas abaixo na base de dados do Totvs Varejo PDV Omni:
- associacao_produto_classificacao
- canal_venda
- classificacao_produto
- cliente
- cliente_endereco
- codigo_identificacao_produto
- compartilhamento
- controle_realtime_db
- estoque
- imposto
- loja
- loja_lote
- loja_lote_compartilhamento
- loja_lote_tipo_lote
- motivo
- ncm
- pagamento_condicao
- pagamento_condicao_operadora
- pagamento_dado_complementar
- pagamento_forma
- pagamento_forma_condicao
- pagamento_forma_dado_complementar
- pagamento_forma_mestre
- pagamento_forma_modelo_fiscal
- pagamento_forma_operadora
- pagamento_operadora
- parametro
- parametro_valor
- perfil
- pis_cofins
- pre_venda
- preco
- produto
- produto_embalagem
- produto_kit
- produto_similar
- produto_sugestao
- tributo_ncm
- usuario
O serviço irá checar na primeira execução se essas tabelas existem. Caso contrário, uma mensagem será notificada, informando que para o correto funcionamento do serviço, é necessário que todas as tabelas acima estejam criadas na base de dados do Totvs Varejo PDV Omni.
Expandir |
---|
title | TOTVS Varejo PDV Omni Smart Hub Client |
---|
|
Expandir |
---|
| 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 |
---|
| Os requisitos mínimos de software para executar o POSH podem ser consultados clicando aqui |
Expandir |
---|
| As configurações necessária para executar o POSH podem ser consultados clicando aqui |
|
Expandir |
---|
title | Fluxo inicial de cadastro |
---|
|
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.
configurações iniciaisfluxo_sync_minimalista | simpleViewer | false |
---|
width | |
---|
links | auto |
---|
tbstyle | top |
---|
lbox | true |
---|
diagramWidth |
---|
|
741Aqui 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.
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 |
---|
|
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 | 1 - Procedimentos para Configuração |
---|
|
|
...
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 |
---|
|
- 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 ? os Compartilhamentos
- 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 - Quais as datas / Versão 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: 10 11 - Qual a requisição esta sendo feita para o PDVSync (online) ? R: 1112- Quais são os dados de autenticação (tenant/usuário) utilizados utilizados (online) ? R: |
|