FAQ - Problemas com integração de movimentos

1. Como funciona o fluxo de integração de vendas?
R: O fluxo de integração de vendas ocorre em duas etapas consecutivas:

• Importação de Vendas (PDV > Monitor): os cupons e documentos fiscais emitidos nos caixas são enviados do PDV para a base de dados do Servidor de PDVs (Monitor).
• Exportação de Vendas (Monitor > ERP): as movimentações recebidas pelo Monitor são enviadas para a retaguarda/ERP da loja.

2. Como identificar em qual etapa o movimento está parado?
R: A validação deve seguir o fluxo da integração:

1. Verifique o movimento no PDV: confirme se o cupom foi emitido normalmente no caixa.
2. Consulte o Monitor: acesse Início > Movimentações > Documentos de PDV's e pesquise pela loja, PDV e período correspondente. Essa tela permite consultar os movimentos dos documentos de PDV registrados no Monitor.
3. Movimento não localizado no Monitor: caso o documento esteja disponível no PDV, mas não seja localizado na tela Documentos de PDV's, a falha está relacionada à etapa PDV > Monitor. Nesse cenário, realize as validações de comunicação e recuperação do movimento.
4. Movimento localizado no Monitor: caso o documento esteja disponível no Monitor, mas não tenha sido integrado ao ERP, a falha está relacionada à etapa Monitor > ERP. Nesse cenário, verifique principalmente a tela de Falhas de Exportações.

Importante: na tela Documentos de PDV's, a consulta deve ser realizada informando a loja e um período, sendo que o intervalo máximo permitido é de 7 dias.


3. As vendas não estão subindo dos caixas para o Monitor. Qual o primeiro procedimento a realizar?
R: Uma das primeiras tentativas para restabelecer a comunicação é reiniciar o serviço do Monitor, principalmente quando há indícios de que o serviço deixou de processar as movimentações.

O procedimento varia de acordo com o sistema operacional do Servidor de PDVs:

• Windows: acesse o servidor e reinicie o serviço TOTVS Varejo Supermercados PDV - Monitor. O serviço pode ser localizado por meio do services.msc ou pelo painel de controle do servidor.
• Linux: na área de trabalho do servidor, utilize o botão Reiniciar serviço disponível para realizar a reinicialização do serviço do Monitor.

4. O serviço foi reiniciado, mas as vendas continuam presas no caixa. O que verificar?
R: Realize as seguintes validações:

1. Licenciamento do Caixa: verifique no PDV se a licença do caixa está ativa. Caixas sem licença válida não integram vendas e não recebem cargas.
2. Compatibilidade de versões: confirme se a versão do PDV é compatível com a versão do Monitor. O PDV não deve estar em uma versão superior à versão do Monitor.

5. Como validar se há bloqueio na rede impedindo a subida das vendas?
R: A comunicação entre o PDV e o Monitor depende das portas utilizadas pela aplicação. Os principais testes de conectividade são:

1. Ping (ping IP): realiza um teste básico para verificar se o equipamento está respondendo na rede.
2. Telnet (telnet IP PORTA): permite validar a comunicação com a porta da aplicação:
   • Porta 7011: comunicação do PDV com o Monitor.
   • Porta 8011: comunicação do Monitor com o PDV.
3. TCPing (tcping IP PORTA): pode ser utilizado para testar continuamente a comunicação com uma porta específica.

Caso seja necessário aprofundar a análise da infraestrutura, podem ser realizados testes complementares, como MTU, Netstat e Pathping/MTR, para identificar possíveis problemas de rota, perda de pacotes ou acúmulo de conexões.


6. Como consultar e tratar erros de integração no Monitor?
R: O Monitor possui telas específicas para acompanhar falhas nas diferentes etapas da integração:

• Falhas do PDV para o Monitor: acesse Cadastros > Movimentações > Falhas de Importações para consultar movimentos que apresentaram erro durante a importação para o banco de dados do servidor.
• Falhas do Monitor para o ERP: acesse Cadastros > Movimentações > Falhas de Exportações para consultar movimentos que apresentaram erro durante o envio para a retaguarda.

Após identificar e corrigir a causa da falha de exportação, selecione os registros e utilize a opção Exportar para realizar uma nova tentativa de integração.


7. Como recuperar vendas que não subiram para o Monitor?
R: Caso um caixa tenha ficado desconectado ou as vendas não tenham sido integradas automaticamente, siga preferencialmente esta sequência:

1. Recuperar Movimentações no PDV: utilize a função Recuperar Movimentações diretamente na tela do PDV. Esse recurso deve ser utilizado como primeira tentativa para recuperar os movimentos disponíveis nos backups dos caixas da mesma loja em rede.
2. Receber Movimento pelo Monitor: caso o movimento não seja recuperado pelo procedimento anterior, acesse Monitor > Comunicações > Comandos para PDV's e gere um comando Receber movimento, informando a loja, o PDV e o período desejado.
   Após o envio, consulte o status do comando na própria tela. Os comandos podem apresentar os status Pendente de envio, Enviado com sucesso ou Falha no envio.
   Importante: para receber comandos enviados pelo Monitor, o PDV precisa estar ativo.
3. Importação do XML: caso o movimento não possa ser recuperado pelos recursos anteriores, pode ser realizada a importação manual do arquivo XML da venda.
   Importante: ao importar o XML, independentemente da forma de pagamento original do cupom, a venda será registrada como Dinheiro e com a espécie de documento CI (Cupom Importado).
   Para NFC-e, caso os arquivos XML não estejam disponíveis localmente, consulte a SEFAZ do estado para realizar a obtenção dos documentos fiscais.

8. O que fazer se a venda não puder ser recuperada por nenhum meio técnico?
R: Se a venda não existir mais na aplicação nem estiver disponível nos backups locais dos caixas, não é possível reemitir o cupom com itens aleatórios no PDV, pois isso pode gerar inconsistências fiscais e de estoque.

Nessa situação:

• Realize o acerto manual dos valores diretamente na Tesouraria.
• Avalie com o responsável fiscal/contábil da empresa a tratativa adequada para os valores recebidos e os respectivos registros fiscais e de auditoria.

9. O que informar ao suporte técnico caso a integração de vendas continue com falha?
R: Caso os procedimentos anteriores não restabeleçam a integração, informe:

• Identificação: sistema operacional do Servidor de PDVs (Windows ou Linux), número da loja, número do(s) PDV(s) afetado(s) e período/data dos cupons que não foram integrados.
• Evidências: anexe o log do serviço (appAcruxMonitorService_*.log) e prints das telas Falhas de Importações, Falhas de Exportações ou Documentos de PDV's, conforme o cenário.
• Testes de conectividade: anexe os resultados dos testes de comunicação realizados, principalmente das portas 7011 e 8011.
• Licenciamento: anexe a evidência da situação do licenciamento do(s) PDV(s) afetado(s).

Essas informações permitem identificar com maior precisão se a falha está na comunicação PDV > Monitor, no processamento do Monitor ou na exportação Monitor > ERP.

Saiba Mais
Clique na documentação abaixo para navegar para os principais temas do PDV:

FAQ Principal - Resolução de Incidentes e Erros Frequentes PDV