Histórico da Página
Dica | ||||||
---|---|---|---|---|---|---|
| ||||||
Nesta documentação, vamos auxiliar você na resolução de algumas cenários já mapeados na integração entre TOTVS PROTHEUS x PDVOMNI
|
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Âncora | | Ocorrências na integração de Vendas | Ocorrências na integração de Vendas | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dica | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Expandir | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
Realizou as analises acima e mesmo assim a venda não foi integrada? Na tabela abaixo temos algumas falhas mapeadas e suas correções.
|
6- Ocorrrências na integração de Vendas Âncora Ocorrências na integração de Vendas Ocorrências na integração de Vendas
Ocorrências na integração de Vendas | |
Ocorrências na integração de Vendas |
Dica | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
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 monitor | Motivo | Solução |
---|---|---|---|
Venda | Administradora Financeira não localizada! Por favor, verifique as tabelas SAE e MDE do Protheus | ||
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. 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?
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 PDV | Motivo | Solução | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Troca/Devolução | Consultar 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 online | Erro ao adquirir estoque online | Um 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. | ||||||||||
Todos | HTTP StatusCode 401 Unauthorized | Quando exibido essa mensagem na tela do PDV, pode ser dois motivos: 1- Falha na autenticação do PDV OMNI com o TOTVS RAC. OU 2- Falha na autenticação do PDVSYNC com o serviço REST do Protheus | 1- No PDV OMNI, verifique se os parametros de autenticação com o TOTVS RAC estão devidamente preenchidos e corretos. 2- Verifique no PDVSYNC se o inquilino utilizado na integração esta preenchido com os dados de autenticação do serviço REST do Protheus. |
8- Status da Integração
Dica |
---|
Abaixo temos informações sobre o monitor de status da itnegração, onde você poderá, visualizar o status dos serviços do PDVSYNC e também Protheus, Status dos cadastros integrados e Status das vendas. |
8.1- Aba Resumo:
Na aba Resumo, podemos visualizar o status dos serviços do PDVSYNC e Protheus.
Para visualizar o Status dos serviços, clique no icone Atualizar, será listado os serviços e seus status.
Caso apresente o help PSHGETSTATUS, informando a mensagem: "Propriedade 'URL_STATUS' vazia ou inexistente no json de configuração do assinante", acesse a rotina RMICADASSI em Atualizações/ Smart Hub/ Cadastros/ Assinantes.
Posione sobre o assinante PDVSYNC e clique em alterar, adiocione após a tag urlPostStatus a seguinte linha: "url_status": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/v2/statusservico", ficando da seguinte forma:
Bloco de código | ||||
---|---|---|---|---|
| ||||
"url_lote": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/inquilinolotesexternos",
"inquilino": "XXXX",
"url_consultalote": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/v2/lojalotes",
"url_lojaloteretornos": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/v2/LojaLoteRetornos",
"urlPostStatus": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/v2/statusservico",
"url_status": "https://pdvsync.varejo.totvs.com.br/controleprocesso/api/retaguarda/v2/statusservico", |
9- Informações adicionais
Gravação da Venda
Dica |
---|
Abaixo segue documentação que demonstra a definição da gravação dos campos de orçamento (SIGALOJA) e Notas Fiscais (Faturamento): |
Incluir Página | ||||
---|---|---|---|---|
|