Consulta status e eventos de documentos fiscais
Quando um documento aparece no Fiscal.io Monitor, o status dele (autorizado, cancelado, com carta de correção, etc.) depende dos eventos que a SEFAZ registrou. O Monitor tem duas formas de consultar isso: a consulta simples e a consulta completa.
A diferença prática é o alcance da consulta e o que fica gravado na sua base.
Consulta simples
É a consulta do dia a dia. O Monitor pergunta à SEFAZ o protocolo do documento e os eventos que o serviço de ConsultaProtocolo devolve — em geral dos últimos 6 meses.
Ela já roda sozinha em várias situações (busca periódica, importação de XML) e você também pode disparar manualmente pelos botões de consulta de status no Monitor.
Quando ela não resolve: documentos mais antigos (pode voltar a rejeição 526, chave com mais de 6 meses) e alguns tipos de evento que esse serviço simplesmente não retorna — por exemplo certos eventos de manifestação ou desacordo.
Consulta completa
Use a consulta completa quando a simples não trouxe o que você precisa: nota antiga, evento que não apareceu, ou quando a empresa registrou o evento em outro sistema e o Monitor ainda não “viu”.
Na prática, o Monitor consulta o portal da SEFAZ (Ambiente Nacional) na opção Consulta Completa, lê a tabela de eventos do documento e grava esses eventos no banco do Monitor (tipo, protocolo, data, situação). Com isso o status do documento e os relatórios passam a refletir o que está na SEFAZ.
Importante: a consulta completa alimenta o banco com as informações dos eventos, mas não traz o XML de cada evento. Ela não baixa o arquivo XML individual de cada evento. Se você precisar do XML da nota (documento principal), use o download de XML — é outro recurso.
Essa consulta costuma ser feita manualmente e consome créditos de download/consulta especial (a mesma família do Download Especial).
Como fazer no Monitor
- Selecione o(s) documento(s) que precisam da consulta.
- Abra a ação de Consulta completa (evento de consulta completa).
- Confirme o custo em créditos, se solicitado, e execute.
- Depois da execução, confira o status do documento e a lista de eventos na ficha dele.
Qual usar?
- Consulta simples — rotina, documentos recentes, atualizar cancelamento/CCe.
- Consulta completa — histórico longo, evento que faltou, auditoria, averbação/exportação, evento lançado em outro sistema.
Se depois da consulta completa o status ainda estiver estranho, confira se a chave está correta no Monitor e se a consulta terminou sem erro. Em dúvida, chame o suporte pelo chat do Monitor.
Related Articles
Como consultar o status dos documentos na SEFAZ através de seus eventos
Manter o status dos documentos atualizado na SEFAZ é o que faz os relatórios do Fiscal.io Monitor ficarem confiáveis. Esse status vem dos eventos ligados a cada nota ou CT-e. O Monitor consulta esses eventos de duas formas. Abaixo está o que cada uma ...Fiscal.io API Eventos de DFe
O objetivo deste procedimento é descrever o passo a passo para utilização da API responsável pela captura dos eventos registrados contra documentos fiscais. Compra de crédito Acessar a página de compra e adquirir créditos conforme volume de ...Eventos de documentos fiscais
O Fiscal.io Monitor é um sistema que monitora de hora em hora todos os documentos que foram emitidos contra as empresas que nele estão cadastradas e também os documentos emitidos por estas empresas. Isso inclui os documentos que chamamos de eventos. ...Como monitorar os cancelamentos sobre documentos de entrada
O Fiscal.io Monitor está preparado para ajudar o setor logístico, fiscal e contábil reduzir o risco de contabilização de documentos cancelados através de uma automação simples. Como você fica sabendo quando um fornecedor cancela uma nota emitida ...Controle automatizado de mercadorias relacionadas à SUFRAMA no Fiscal.io Monitor
O Fiscal.io Monitor está preparado para automatizar completamente o gerenciamento das notas fiscais relacionadas à SUFRAMA. Ele é o único sistema do mercado que possibilita o usuário fiscal, tributário, contábil ou logístico, controlar de maneira ...