Diagnóstico inicial: Utilize a função "Onde está o XML"
O primeiro passo é utilizar a ferramenta de busca interna do Qive Conexões para entender em qual estágio de processamento a nota se encontra.
No seu Protheus, acesse a rotina do Qive Conexões.
Clique no botão "Onde está o XML".
Informe a Chave de Acesso do documento (ou o código de verificação, no caso de NFSe).
Ao realizar a busca, o sistema retornará o status atual e a localização exata do documento no fluxo de integração.
Entenda os status do XML no Qive Conexões
Dependendo do resultado da busca, a nota pode estar em diferentes estados. Confira o que cada um significa:
0 - Desconsiderado: O documento foi movido manualmente para a área de documentos desconsiderados. Você pode restaurá-lo em
Outras Ações > Docs. Desconsiderados.1 - Primeira Fila: A nota foi recebida e está aguardando a rotina de importação automática.
2 - Importado: O documento já foi lançado e processado. Verifique em
Outras Ações > Docs. Importados.3 - Segunda Fila: O sistema está tentando realizar uma nova tentativa de importação automática.
4 - IE em Branco: A nota está bloqueada porque a Inscrição Estadual do fornecedor ou da unidade está ausente ou incorreta no cadastro.
5 - Cancelado: O documento foi identificado como cancelado na SEFAZ ou prefeitura.
6 - Bloqueado: Houve um erro crítico no processamento. O motivo do erro precisa ser corrigido antes de uma nova tentativa.
7 - Pendente Importação: O documento está com status verde, pronto para ser selecionado e importado.
8 - Em Fila de Classificação: A nota é uma pré-nota e está aguardando classificação em
Docs. Importados.
Diagnóstico de mensagens de erro
Mensagem: "XML não processado"
Isso indica que a rotina CXNFARQ (Leitura de arquivos) já identificou a presença do arquivo, mas a rotina CXNFEMP (Gerenciamento de filas) ainda não foi executada para posicionar a nota na fila correta. Aguarde alguns minutos ou verifique o status dos Jobs (passo abaixo).
Mensagem: "XML não encontrado"
Se o documento não é localizado mesmo após a busca pela chave, pode haver uma falha na comunicação entre o SaaS Qive e o seu servidor. Prossiga para a validação dos serviços.
Verificação da situação dos serviços (Status Job)
Para que as notas saiam da nuvem e cheguem ao Protheus, os serviços de integração (Jobs) precisam estar ativos (verdes).
No menu do Qive Conexões, acesse:
Outras Ações > Suporte > Status Job.Verifique as legendas para Leitura de Arquivos e Gerenciamento de Filas.
Verde (Ativo): O serviço está operando normalmente.
Vermelho (Inativo): O serviço está parado.
Importante: Caso algum serviço esteja vermelho, é necessário solicitar que sua equipe interna de TI ou o administrador do Protheus reinicie os Jobs no AppServer. Para detalhes técnicos de configuração, consulte o Manual de Instalação do Qive Conexões.
Próximos Passos e Extração de Logs
Se os serviços estão ativos, mas a nota ainda não aparece ou apresenta erros constantes, será necessário analisar os registros técnicos da integração.
Acesse:
Outras Ações > Suporte > Extrair Logs.Gere o arquivo de log referente ao período da nota em questão.
Para um passo a passo detalhado de como realizar este procedimento, veja nosso artigo: Como extrair os logs no Qive Conexões.
