Identificando a origem pelo rastreio de log
A forma mais rápida de validar a origem de um documento é pela interface do próprio Qive Conexões, dentro do Protheus.
Acesse a rotina do Qive Conexões | TOTVS Protheus.
Clique em Outras Ações e selecione o caminho Suporte → Rastreio.
No campo de busca, insira a chave de acesso da nota fiscal.
Selecione a opção Ações do usuário.
Clique duas vezes na linha do log exibido para ver os detalhes.
O detalhamento mostra todo o histórico de importação do XML feito pelo Qive Conexões.
Importante: se a consulta pela chave de acesso não retornar nenhum log, o documento não passou pelo importador da Qive. Isso significa que ele foi lançado manualmente pela rotina padrão de Documento de Entrada (MATA103) do Protheus.
Validação técnica via parâmetro de tabela (MV_XGTTABB)
Usuários com perfil de administrador, ou que precisem validar no nível do banco de dados, podem consultar a tabela de logs configurada para a integração.
Como identificar a tabela de logs configurada
No Qive Conexões, acesse Outras Ações → Parâmetros.
Abra a aba Geral.
Localize o campo do parâmetro MV_XGTTABB.
Verifique qual tabela está informada. O padrão costuma ser a tabela ZBB, mas ela pode variar conforme a instalação.
Verificação na tabela
Se a nota fiscal estiver registrada na tabela indicada pelo parâmetro, ela foi processada pelo Qive Conexões.
Se não houver registro nessa tabela, o lançamento foi feito por fora da integração.
Nota lançada fora do importador continua em Pendentes de Importação
Uma nota lançada diretamente no Documento de Entrada (MATA103) não passa pelo importador. Por isso, o status dela no Qive Conexões precisa ser sincronizado para que ela saia de Pendentes de Importação.
Sincronização manual (atualização imediata)
No Qive Conexões, acesse Outras Ações → Manutenções → Sincronizar XML.
O sistema verifica o lançamento do documento na tabela SF1 e move a nota para a aba Docs. Importados.
Sincronização automática (lançamentos futuros)
A atualização automática é feita pela rotina CXNFJOB3. Para que ela funcione:
Confirme com a equipe de TI que o parâmetro MV_CXNFHJ3 está ativado. É ele que habilita a execução do CXNFJOB3.
Acesse Outras Ações → Suporte → Status Job e confirme se os serviços estão ativos, com a legenda verde.
Importante: a quantidade de vezes que essa verificação roda por dia não é fixa. Ela depende da frequência configurada no Schedule do Protheus ou no serviço do arquivo de configuração (appserver.ini). Peça à equipe de TI para conferir essa configuração.
Para saber mais sobre o CXNFJOB3 e os demais serviços, acesse O que são os JOBs do Importador e onde verificar e analisar os Logs.
Como localizar em qual filial o XML foi gravado
Às vezes o documento aparece no tomador correto na plataforma Qive, mas o Qive Conexões mostra outra filial. Você pode confirmar a filial de gravação de quatro formas:
Visualização via F12: na tela inicial do Qive Conexões, pressione F12 e altere o parâmetro Visualização Filial de "Atual" para "Todas". A tela passa a exibir os documentos de todas as filiais do grupo.
Coluna Filial no painel: na grade principal, localize a coluna Filial. Se ela não estiver visível, clique no ícone de engrenagem no canto da tela para exibi-la.
Rotina Onde está o XML?: acesse Outras Ações → Onde está o XML? e informe a chave de acesso. O resultado mostra a informação Filial: XX, que indica onde o arquivo foi gravado no banco de dados do Protheus.
Relatórios do importador: acesse Outras Ações → Relatórios → Relatório de Lançamento Diário ou Relatório de Entrada para listar os XMLs com a filial de destino de cada um.
Como consultar o motivo de uma nota pendente
Para ver por que um documento está travado em Pendentes de Importação:
Selecione a nota pendente na tela.
Acesse Outras Ações → Ações → Erro do XML para ver a mensagem com a causa.
Outras situações relacionadas
Desconsiderar um XML
Ao desconsiderar um XML, a nota não vai para Docs. Importados. Ela é enviada para a listagem Docs. Desconsiderados, e por essa listagem é possível reconsiderá-la a qualquer momento. Veja o passo a passo em TOTVS Protheus: Como desconsiderar um XML.
NFS-e com numeração repetida (prefeituras que reiniciam a contagem)
Algumas prefeituras reiniciam a numeração das NFS-e na virada do ano. Quando o ERP bloqueia documentos com o mesmo número, fornecedor e filial, sua equipe técnica pode usar o ponto de entrada CXMANDOC. Ele funciona assim:
É executado no momento da leitura e preparação do arquivo pelo importador.
Permite formatar ou alterar o número final do documento antes que ele seja gravado.
Permite escolher a quais tipos de documento o ajuste se aplica.
Não altera documentos que já foram lançados.
Os parâmetros e um exemplo de código estão em TOTVs Protheus: Pontos de entrada disponíveis.
Seguindo esses procedimentos, você tem visibilidade completa sobre a origem e o status dos documentos fiscais no seu ERP e mantém a fila de Pendentes de Importação fiel ao que foi de fato escriturado.