Consulta status e eventos de documentos fiscais

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

  1. Selecione o(s) documento(s) que precisam da consulta.
  2. Abra a ação de Consulta completa (evento de consulta completa).
  3. Confirme o custo em créditos, se solicitado, e execute.
  4. 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.