Linha Microsiga Protheus

Árvore de páginas

Bora resolver!

Nesta documentação, vamos auxiliar você na resolução de algumas cenários já mapeados na integração entre TOTVS PROTHEUS x PDVOMNI


  • Cadastrei um produto e ele ainda não foi integrado com o PDV OMNI, o que eu faço?
    • Deve seguir os passos abaixo para analise

    1- Serviços PSH

    Dica!

    Antes de qualquer ação é de extrema importancia 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.
    • Identifiquei 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.

      • 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 

    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

    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 

    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:

    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","helpUrl":"","details":[{"guid":"e4a2cc33-411c-4909-963c-b4218a15963d","code":"CQIFlap.Pber.Cebqhgb.Qbznva.Ragvgvrf.Cebqhgb.Cebqhgbf+Reebe.6","message":"IdRetaguarda: 18062024 | Produto precisa de um código alternativo e que não ultrapasse 40 caracteres.","detailedMessage":"ProdutoShouldHaveCodigoAlternativo"}]}

    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.
    Produto Produto sem informacoes de NCM

    A situação pode ter sido causada por dois motivos : 

    1 - O campo B1_POSIPI do cadastro de Produto não foi preenchido; 
        ou 
    2 - O campo B1_POSIPI 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 novamente ao PDV.
    Produto  Produto sem informacoes de imposto O motivo dessa falha é que possivelmente o produto foi enviado antes do IMPOSTO/ICMS ser integrado no PDV.

    1- 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 preço no PDV, foi apresentado essa falha, pois o Produto não esta integrado no 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 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
    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

    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


    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


    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 monitorMotivoSolução
    VendaAdministradora 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

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

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

    Verifique se houve alguma mudança no tributo do protheus, caso sim altere o seu produto para que seja realizado um novo cadastro dos impostos de para o produto na tabela MIH e um novo vinculo do Produto com o novo imposto na tabela MIL.

    Venda Cliente com cpf\cnpj [CPF_CLIENTE] não localizado na tabela de clientes(SA1). Verifique se a integração de clientes esta ativa e se o cliente já foi integrado corretamente.  De/Para(MHM) não encontrado para a busca realizada.Essa falha ocorre quando o cliente identificado na venda não foi encontrado no Protheus. É preciso analisar os seguintes pontos:

    1- Verifique se o processo Cliente esta ativo no assinante PDVSYNC

    2- Verifique através do Monitoramento do Status de Integração se o cliente apresentou alguma falha na integração.

    3- Caso apresente algum problema na integração do cliente realize a correção e em seguide reprocesse a venda.


    7- Consultas online

    Dica!

    O que é o fluxo online na integração?

    Fluxo online basicamente são consultas em tempo real realizadas entre o PDVOMNI e Protheus via API REST.

    Um exemplo de Fluxo online é da consulta de estoque, onde o PDVOMNI consulta o Protheus para saber o saldo em estoque em tempo real de determinado produto. Essa é a diferença, pois em um fluxo normal até que seja integrado um estoque atualizado ao PDVOMNI, pode levar alguns minutos, já com a consulta online esse detalhe não ocorre.


    O que podemos consultar online?

    • Consulta de Cupons na retaguarda
    • Troca/Devolução
    • Consulta de estoque
    • Consulta de Crédito de Cliente


    O que preciso para realizar consultas online no Protheus?

    O Protheus deve estar com o serviço REST configurado e em plena execução: Configurando REST no Protheus


    Ao realizar consultas online, podem ocorrer alguma inconsistência. Abaixo temos algumas ocorrências que já foram identificadas na integração.

    Fluxo Mensagem apresentada no PDVMotivoSolução
    Troca/DevoluçãoConsultar nota de saída:
    Não foi possivel consultrar a nota de saída - Retaguarda retornou o erro: Não foram encontrados registros com os dados informados, verifique.    		O Protheus retorna essa mensagem pois não encontrou nenhuma venda na tabela SF2 com os dados da venda informada no filtro do PDV.

    1- Verifique atráves do monitor do PDV se a venda que deseja realizar a troca foi integrada na retaguarda, para isso acesse a maquina onde esta seu PDV e em seguida no Browser acesse: http://localhost:9000


    2- Verifique no monitor do PSH 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


    3- A venda esta com falha? Neste caso será necessário realizar a correção da falha apresentada para que a venda seja integrada com sucesso no Protheus. Para que em seguida seja realizada a troca no PDV.


    4- Caso tenha alguma falha na integração da venda verifique na Ocorrências na integração de vendas se a falha apresentada consta na tabela de ocorrências e aplique a solução proposta.

    Estoque onlineErro ao adquirir estoque onlineUm dos pincipais motivos, é o serviço REST estar parado no Protheus.

    1- Verifique através do appserver.ini se o serviço responsável pelo REST esta ativo e em plena execução

    2- Caso não esteja, ative o serviço e reinicie o Appserver do Protheus.




    • Sem rótulos