| Card |
|---|
| id | 1.1 |
|---|
| label | Envio de CadastrosIntegração |
|---|
| title | Envio de Cadastros |
|---|
| 1- Serviços PSH| Âncora |
|---|
| 1- Serviços da Integração |
|---|
| 1- Serviços da Integração |
|---|
|
| Dica |
|---|
| Antes de qualquer coisa ação é de extrema importancia realizar as seguintes analises: Exemplo: Cadastrei um Produto, e o mesmo não foi integrado com o PDVOMNI. - Verifique se todos os serviços do PSH estão ativos e em plena execução
- RMIPUBLICA
- RMIDISTRIB
- RMIENVIA
- RMIBUSCA
- RMICONTROL
- Verifique se o dado cadastrado atende os filtros estabelecidos no cadastro de Processos.
- Verifique no cadastro do assinantes se o processo está ativo.
Após realizar as análises acima, provavelmente no seu monitor de status de integração está apresentando uma falha na integração do registro. Na tabela abaixo temos algumas falhas mapeadas e suas correções. verificar se os Serviços da integração estão ativos e em plena execução, sendo eles - RMIPUBLICA
- RMIDISTRIB
- RMIENVIA
- RMIBUSCA
- RMICONTROL
- GRAVABATCH
- Onde posso verificar se os serviços estão ativos?
- Primeiro lugar para verificar é no AppServer.ini, veja se os serviços acima estão configurados corretamente de acordo com o Serviços da integração.
- Após a analise acima, o segundo lugar onde devemos verificar é no console.log ou no console em tempo de execução, para identificar se os serviços estão executando normalmente.
- Migrei meu ambiente e dentifiquei que os serviços não estão sendo executados e esta apresentando a mensagem:
- O serviço não pode ser iniciado devido a uma mudança em seu ambiente. Na imagem abaixo mostra como é apresentado no console.
| Expandir |
|---|
|  Image Added
|
- Para solucionar o bloqueio acesse: Configuração Smart Hub
- Serviços do PDV OMNI
Corrigiu os serviços e mesmo assim ainda não integrou os cadastros com o PDV OMNI? Verifique o item Serviços do PDVSYNC |
2- Serviços do PDVSYNC | Âncora |
|---|
| Serviços PDVSYNC |
|---|
| Serviços PDVSYNC |
|---|
|
| Dica |
|---|
| Todos os Serviços do PSH estão ativos? Vamos verificar agora se os serviços do PDVSYNC estão ativos. - No servidor onde esta o seu PDV acesse o Serviços do Windows e verifique se os serviços abaixo estão em execução
- PDVSync Client API
- PDVSync Client Down
- PDVSync Client Servico.Controle
- PDVSync Client Up
Os serviços estão ativos? Então vamos para o proximo passo Processos ativos |
3- Verificando os processos ativos| Âncora |
|---|
| Processos ativos |
|---|
| Processos ativos |
|---|
|
| Dica |
|---|
| Após analisar os itens acima, é de extrema importância verificar se os processos estão ativos no assinante. Antes disso é bom saber o que é um Processo e Assinante: - O que é um Processo?
- O processo, é o tipo de dado que vamos integrar. Quando nos referimos a processo na nossa integração, basicamente estamos falando das tabelas do Protheus. Conforme o exemplo abaixo:
- Processo Cliente = tabela SA1;
- Processo Produto = tabela SB1
- O que é um Assinante?
- O assinante é o sistema que o Protheus vai integrar os processos/dados.
- Agora que você já sabe o que é um processo e assinante, precisamos verificar se no assinante PDVSYNC o processo esta ativo.
- Acesse o modulo Controle de Lojas/ Atualizações/ Smart Hub/ Cadastros/ Assinantes.
- Verifique no Assinate PDVSYNC se o processo que esta tentando integrar esta ativo.
Todos os processos estão ativos? vamos analisar os Filtros para integração |
4- Filtros para integração | Âncora |
|---|
| Filtros para integração |
|---|
| Filtros para integração |
|---|
|
| Dica |
|---|
| - Para que serve o filtro na integração?
O filtro na integração serve para definir regras específicas para os cadastros que serão integrados. Por exemplo, se você quer integrar apenas produtos que têm o campo B1_XYZ preenchido com "A", o filtro permitirá que apenas esses produtos sejam integrados. Assim, você pode determinar apenas os dados que atendem a determinados critérios, evitando que informações irrelevantes ou desnecessárias sejam incluídas na integração. - Aonde fica os filtros?
- Os filtros para integração fica em: Modulo Controle de Lojas/ Smart Hub/ Cadastros/ Processos.
- Verfique se em seu processo tem algum filtro, caso tenha verifque se em seu cadastro de produto atende o filtro em questão.
- Posso criar um Filtro?
- Pode sim, selecione o Processo de deseja incluir o filtro e clique em Alterar.
- No campo filtro preencha com uma instrução SQL, como mostra o GIF abaixo:
| Expandir |
|---|
|  Image Added
|
|
5- Ocorrrências no envio de cadastros| Dica |
|---|
| Se no seu PDV apresentar alguma das mensagens abaixo: - Produto não encontrado
- Produto sem preço
- Produto não possui saldo disponível em estoque
Você já realizou os procedimentos 1- Serviços da integração, 2- Serviços PDVSYNC, 3- Processos ativos, 4- Filtros para integração ? Se sim, esses são alguns cenários que vamos te ajudar a resolver. Abaixo temos algumas ocorrências que são apresentadas no monitor de integração e a solução para corrigi-los. Para acessa-lo siga o caminho: modulo Controle de Lojas/ Atualizações/ Smart Hub/ Monitoramento/ Status Integração. Obs: No campo Palavra Chave você pode informar o código do produto que deseja realizar a analise. |
| Integração de: | Mensagem apresentada no Monitor PSH | Motivo | Solução |
|---|
| Todos | Erro ao gerar layout de envio - Processo [NOME_PROCESSO], Assinante PDVSYNC | Essa falha pode ocorrer por inconsistências no Layout de envio do cadastro em questão, por exemplo, quebra no json, customização incorreta, função de usuário, entre outros. | 1- Visualize o Layout do processo que foi apresentado o erro e em seguida realize a comparação do mesmo com a ultima versão do Layout no Github. 2- Em caso de incompatibilidade, atualize o Layout de acordo com o Layout do Github. 3- Reenvie o dado e se caso aprensentar a mesma falha, realize a abertura de uma issue para o time de Integrações Magazines, seguindo as orientaçãoes. | | Todos | Motivo: 400 BadRequest | Caso seja na integração de Produto, Preço, Saldo Estoque ou Cliente, seja apresentado essa falha, significa que alguma informação importante para o Produto não foi preenchida/enviada. | Geralmente a mensagem completa será apresentada da seguinte forma: Motivo: 400 BadRequest - [Endpoint_da_AP]
{"code":"Zvpebfbsg.NfcArgPber.Zip.GasPbagebyyre+Reebe.2","message":"Erro ao salvar 'Produto'","detailedMessage":"AspNetCoreOnPostError |
| Processo | Falha/Problema
Mensagem | Solução |
|---|
| Preço | Preço sem Produto Cadastrado | Na tentativa de integrar o preço no PDV, foi apresentado essa falha, pois o Produto não esta integrado na base do PDV. 1- Verifique o status da integração do produto vinculado ao preço no monitor de Status de Integração. 2- Caso seja apresentado falha na integração do Produto, identifique o motivo e reenvie novamente. | Cliente | 400 BadRequest - [https://pdvsync-core-cliente-qa-ywc7q7nxya-uc.a.run.app/api/retaguarda/clientes] {"code":"","message":"","detailedMessage":"","helpUrl":"","details":[{"guid":" |
eb3ca2a8290d4440aebf97c76aaaefd7b4218a15963d","code":"CQIFlap.Pber. |
PyvragrPyvragrPyvragrf17O campo cliente IdRetaguarda: 18062024 | Produto precisa de um |
CPF/CNPJ não 14 40 caracteres.","detailedMessage":" |
ClienteShouldHaveCpfCnpjProdutoShouldHaveCodigoAlternativo"}]} |
No PdvSync o campo CPF/CNPJ é obrigatório, e o cliente que foi cadastrado e enviado não tem preenchido essa informação no campo A1_CGC Observe que na tag message foi informado com o motivo da falha na integração, para analise deve ser verificado no Layout de envio de produto qual o campo que esta preenchendo a tag codigoAlternativo. Para isso acesse: Layouts, em seguida clique em Envio e selecione o arquivo envia_produto. Através do Layout conseguimos identificar que a codigoAlternativo esta pegando o conteudo do compo B1_CODBAR. Altere o adastro do produto em questão se preencha o campo Código de Barras. Após isso o seu produto será integrado corretamente. | | Todos | 401 Unauthorized - [ENDPOINT_DA_API] | Foi retornado essa mensagem ao realizar o envio de Produto ou algum outro dado? Essa mensagem ocorre devido à falha na autenticação da API do PDVSYNC no momento em que o Protheus realizou o envio do dado. | Vamos precisar abrir apoio ao time de Integrações Redes e Franquias. Mas antes disso, é necessário acessar o cadastro de assinante para pegar os dados de autenticação, para o time responsável analisar, para isso siga o passo a passo abaixo: 1- Acesse o modulo Controle de Lojas Atualizações/ Smart Hub/ Cadastros/ Assinantes. Selecione o assinante PDVSYNC e copie os dados do campo Configuração. Realize a abertura de apoio para o time de Integrações Redes e Franquias. Informando a falha e os dados de autenticação. | | Todos | Ops! Nao foi possivel efetuar a autenticacao, verifique as configuracoes do assinante: [ LJRAC - Called -> GETTOKEN] -> Erro ao tentar autenticar: invalid_grant http code: 400 BadRequest | Essa falha pode ocorre quando os dados para autenticação do RAC estiverem errado. Estes dados são apresentados no cadastro do assinante na tabela MHO no campo MHO_CONFIG | Deve ser alterada as informações nas TAGs "user" e "password" no campo MHO_CONFIG no cadastro do assinante. Caso seja necessário acesse o RAC para redefinir a senha e faça o processo de "esqueci senha" no endereço: https://{seu tenant}.rac.totvs.app |
1- Realize a alteração no cadastro do cliente e aguarde a execução de todos os serviços do PSH até que o cliente seja integrado ao PDV. | | Produto | Produto sem informacoes de NCM |
Existe dois motivos que podem apresentar essa falha. O primeiro é que o produto que foi enviado pode estar sem o A situação pode ter sido causada por dois motivos : 1 - O campo B1_POSIPI |
preenchido.1- Verifique se o Produto esta vinculado à um NCM, do cadastro de Produto não foi preenchido;
ou
2 - O campo B1_POSIPI |
. Caso não esteja realize o preenchimento desse campo.O segundo motivo é que possivelmente o Produto foi enviado antes do NCM ser integrado no PDV. 1- Verifique se foi realizado o envio do NCM para o PDVSYNC e se o mesmo se encontra integrado. Caso sim, reenvie o Produto realizando alguma alteração no mesmo. Caso o NCM não esteja integrado no PDV realize uma alteração no mesmo e aguarda a integração do mesmo. está preenchido, porém o cadastro de NCM não foi enviado para o PDV OMNI | verifique se o produto possui NCM válido e se o NCM foi enviado corretamente para o PDV. Realize a atualização de NCM através da rotina FISA092. Veja mais em: Cadastro IBPT |
Após isso altere o Produto para que o mesmo seja enviado |
novamento novamente ao PDV. | | Produto | Produto sem informacoes de imposto | O motivo dessa falha é que possivelmente o |
Produto | produto foi enviado antes do IMPOSTO/ICMS ser integrado no PDV. | 1- |
Para corrigir esse problema Verifique na tabela MIL se o Produto em questão esta vinculado à algum código de imposto. Tendo o vinculo, para corrigir essa falha realize uma alteração no Produto para que o mesmo seja enviado novamente ao PDV. | | Saldo Estoque | Estoque sem id produto | O motivo dessa falha é que possivelmente o Saldo Estoque do produto foi enviado antes do próprio produto ser integrado no PDV. Isso ocorre por que ainda não temos controle de precedencia na integração. | 1- Verifique atráves do monitor de status da integração se o produto referente ao saldo apresenta alguma falha ou esta pendente de integração. 2- Caso seja apresentado falha na integração do produto identifique o motivo e envie novamente. 3- O reenvio de saldo estoque sera realizado de acordo com a configuração determinada no processo saldo estoque no cadastro do assinante, campo Configuração tag qtdereenvio, para mais detalhes: Configuração reenvio automático | | Saldo Estoque | Não possui saldo disponível em estoque | Esse cenário pode ocorrer devido a falta de saldo do Produto no PDV ou o Protheus não consguiu integrar o saldo atualizado | 1- Verifique no Protheus o saldo em estoque do Produto. 2- Caso no Protheus tenha saldo em estoque para ao produto, verifique no monitor de integrações se o saldo em estoque do produto apresentou algum erro. Acesse Controle de Lojas/ Atualizações/ Smart Hub/ Monitoramento/ Status Integração.
| | Preço | Preço sem Produto Cadastrado | Na tentativa de integrar o |
Saldo Estoque | preço no PDV, foi apresentado essa falha, pois o Produto não esta integrado |
na base do | no PDV. | 1- Verifique o status da integração do produto vinculado ao |
estoquepreço no monitor de Status de Integração. 2- Caso seja apresentado falha na integração do |
Produto produto identifique o motivo e |
reenvie Todos | Erro ao gerar layout de envio - Processo PRECO, Assinante PDVSYNC | Esse erro pode ocorrer para qualquer processo, e geralmente ocorre por algum erro contido no Layout de envio do processo. 1- Visualize o Layout do processo que foi apresentado o erro e em seguida realize a comparação do mesmo com a ultima versão do Layout no GIT. 2- Em caso de incompatibilidade, atualize o Layout de acordo com o Layout do GIT. Reenvie o dado e se caso aprensentar a mesma falha, realize a abertura de uma 3- O reenvio de saldo estoque sera realizado de acordo com a configuração determinada no processo saldo estoque no cadastro do assinante, campo Configuração tag qtdereenvio, para mais detalhes: Configuração reenvio automático | | Preço | Preço não foi integrado no PDV | Existem alguns motivos para que o preço não seja integrado no PDV. Algumas analises precisam ser realizadas. | 1- Seu preço é via tabela de Preços (DA0, DA1) ou pelo próprio cadastro de produto na tabela (SB0)? Para isso verifique MV_LJCNVDA. Com isso verifique se o preço esta cadastrado corretamente na tabela utilizada para o cenário de venda.
2- Verifique atráves do monitor de status de integração: Controle de Lojas/ Atualizações/ Smart Hub/ Monitoramento/ Status Integração se o preço em questão foi enviado para o PDVOMNI. Caso o mesmo foi enviado e esta pendente de integração, verifique os Serviços PDVSYNC, estão ativos? Caso estejam ativos e o Preço ainda não integrou, será necessário realizar a abertura do ticket para o time de Integrações Franquias e Redes. |
|
6- Ocorrrências na integração de Vendas| Âncora |
|---|
| Ocorrências na integração de Vendas |
|---|
| Ocorrências na integração de Vendas |
|---|
|
| Dica |
|---|
| - Meus cupons não integraram na retaguarda
- Vendas não subiram para o Protheus
- Minha venda não consta na retagarda
São esses acionamentos que temos quando por algum motivo a venda realizada no PDV OMNI não foi integrada ao Protheus. Quando for identificado a falta de integração de uma venda, devemos realizar a analise de Serviços da integração. Todos os serviços estão certos e em plena execução? Verifique atráves do monitor do PDV se sua venda foi integrada na retaguarda, para isso acesse a maquina onde esta seu PDV e em seguida no Browser acesse: http://localhost:9000 | Expandir |
|---|
|  Image Added
|
A segunda analise possivel acessando o monitor de status de integrações em: Controle de Lojas/ Atualizações/ Smart Hub/ Monitoramento/ Status Integração. Abaixo um GIF explicativo onde mostra a pesquina de um cupom, informando no campo Venda o código do cupom | Expandir |
|---|
|  Image Added
|
Realizou as analises acima e mesmo assim a venda não foi integrada? Na tabela abaixo temos algumas falhas mapeadas e suas correções. |
| Integração de: | Mensagem apresentada no monitor | Motivo | Solução |
|---|
| Venda | Administradora Financeira não localizada! Por favor, verifique as tabelas SAE e MDE do Protheus e certifique-se que na mensagem da venda, ao menos uma das seguintes tags estão preenchidas : 'VendaPagamentoTefs','PagamentoOperadora' ou 'PagamentoCondicao' | Essa falha ocorre, pois, a integração não conseguiu localizar a Administradora Financeira (SAE) adequada para o pagamento TEF | Para resolver esse item acesse: Localizando Administradora Financeira | | Venda | O campo L1_OPERADO esta vazio, esse campo devera ser preenchido para o correto processamento da venda! | Essa falha na integração da venda ocorre quando a venda foi realizada no PDV por um usuário administrador sem qualquer vinculo com operador de loja ou vendedor. | Para correção dessa falha deve ser aberto um ticket/issue de apoio ao time do PDV OMNI, solicitando a correção dessa venda. | | Venda | Encontrada diferença nos dados enviados do XML-SEFAZ e o Livro Protheus: | Essa falha na integração da venda ocorre quando tem divergencia nos valores de tributo entre o XML enviado para a Sefaz e os valores que seriam gravados no Protheus. Para evitar problemas nos livros fiscais do Protheus existe uma trava que impede que essa venda seja prcessada com sucesso, para evitar maiores transtornos. |
No momento em que for identificado essa falha deve ser realizado uma abertura de ticket/issue para o time de Integrações Magazines, seguindo as orientaçãoes. | | Venda | Houve uma diferença entre os tributos que seriam calculados pelo Protheus(MATXFIS) e o transmitido pelo PDV OMNI, porém a venda foi gravada/escriturada com sucesso no Protheus | Apesar de não se tratar de uma falha, essa mensagem é um alerta para evitar possiveis problemas posteriores. Basicamente houve divergencias entre os valores de impostos simulados pela MATXFIS e os valores de impostos do XML da venda enviado para Sefaz. Porém gravamos exatamente os valores do XML nos livros fiscais do Protheus e assim a venda integrada com sucesso. | Uma dica para evitar esse tipo de alerta é, verificar o cadastro/configuração fiscal do Produto no Protheus e os tributos que o PDV OMNI calculou na venda. |
|
, será listado os serviços e seus status.