> For the complete documentation index, see [llms.txt](https://docs.fomenti.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fomenti.com.br/movimentos/monitor-de-nf.md).

# Monitor de NF

O monitoramento de NF (Nota Fiscal) serve para que o sistema acompanhe de forma automática e contínua o status e integridade das notas fiscais que foram emitidas por terceiros.

#### **Objetivo principal:**

> Garantir que as notas fiscais **continuem válidas**, **não sejam canceladas**, **não sofram alterações** e que o sistema esteja **alinhado com o que está registrado na SEFAZ ou prefeitura**.

#### **Tipo data**

* **Função:** Escolhe qual data será usada como critério para o filtro de período.
* **Opções:**
  * **Importação**: Filtra as notas pela data em que **foram importadas para o sistema** (ou seja, quando o sistema "registrou" a nota, independentemente da data em que ela foi emitida).
  * **Emissão**: Filtra as notas pela data em que **foram emitidas pelo fornecedor**, ou seja, a data legal da nota fiscal.

#### **Data inicial/ Data Final**

* **Função:** Define o **início do intervalo de busca**, conforme a data selecionada.

{% hint style="warning" %}
**O serviço para NFSe ainda não está disponível.**
{% endhint %}

**Tipo NF (Tipo de Nota Fiscal)**

Necessário selecionar o tipo de consulta de acordo com a **NF,** tendo como opções **Nota Fiscal** e **Nota Fiscal de Serviço.** Ao selecionar **NFSe (Serviços)**, o campo **Prefeitura** é habilitado para que o sistema saiba qual plataforma municipal consultar. 

#### **Buscar por**

Permite localizar rapidamente uma nota fiscal usando:

*  **Chave da NF**
* **Número da nota**
* **Nome do emitente**
*  **Nome do destinatário**
* **Número da operação (interna)**

#### **Apenas NF monitoradas (checkbox)**

* **Função:** Quando marcado, **exibe apenas as notas que estão com monitoramento ativo** no sistema.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FsgxFjp4JiCPD1C30Z88B%2Fimage.png?alt=media&amp;token=74b67313-87f3-4f2a-9541-40f62fcb99b7" alt=""><figcaption></figcaption></figure>

| **Coluna**       | **Descrição**                                                                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo**         | Indica o tipo de nota fiscal, como NFe (produtos) ou NFSe (serviços).                                                                               |
| **Prefeitura**   | Mostra a origem da nota no caso de NFSe, ou informa "Nacional" no caso de NFe (que é estadual).                                                     |
| **Emissão**      | Data em que a nota fiscal foi emitida pelo fornecedor ou prestador.                                                                                 |
| **Número**       | Número sequencial da nota fiscal, definido pelo emissor.                                                                                            |
| **Chave**        | Exibe a chave de acesso da NF (com parte oculta por segurança). Ao lado tem o botão para copiar a chave completa.                                   |
| **Emitente**     | Nome da empresa que emitiu a NF.                                                                                                                    |
| **Destinatário** | Nome da empresa que recebeu a nota  com o CNPJ.                                                                                                     |
| **Importação**   | Data em que a nota foi importada ou registrada no sistema.                                                                                          |
| **Operação**     | Número da operação gerada no sistema através da NF. Se não houver vínculo, irá aparecer como “não gerado”.                                          |
| **Monitorado**   | Indica se a nota está sendo monitorada pelo sistema (Sim ou Não). Monitoradas são verificadas automaticamente quanto a alterações ou cancelamentos. |

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2F0R91g4p1wIB3BqWTjN2a%2Fimage.png?alt=media&amp;token=d383ead5-2e02-4cb7-9a3a-edbaef15fe13" alt=""><figcaption></figcaption></figure>

O botão **“Opções”** disponibiliza as seguintes ações para cada nota fiscal monitorada:

* **Histórico**\
  Exibe o histórico de eventos relacionados à NFe, como importações, consultas de status e atualizações realizadas pelo sistema.
* **Ir para operação**\
  Abre a tela da operação vinculada à NFe.
* **Baixar XML**\
  Faz o download do arquivo XML da NFe diretamente do sistema, facilitando o armazenamento ou conferência manual.
* **Consultar status nota**\
  Realiza uma nova consulta na SEFAZ (Secretaria da Fazenda) para verificar o status atualizado da NFe (por exemplo: autorizada, cancelada, denegada etc.).
* **Iniciar ou Parar monitoramento**\
  Inicia ou interrompe o monitoramento automático dessa NFe.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FeAhjmWRIuVSC0foHMUKv%2Fimage.png?alt=media&amp;token=b25a8904-c048-4f8f-9480-60118947aa42" alt=""><figcaption></figcaption></figure>

O monitoramento da NFe será **encerrado automaticamente** quando todos os títulos relacionados à nota forem **baixados**. Esse registro ficará gravado na opção **histórico**.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FsAB3Gy7Qs0hSkBaWdAzS%2Fimage.png?alt=media&amp;token=e7af724e-d315-497e-9edb-eb9f3fc3b2a4" alt=""><figcaption></figcaption></figure>

## Consultar Status da Nota

Permite ao usuário buscar e verificar o status ou detalhes de uma nota fiscal específica, informando diretamente sua Chave.

Clicando em **Opções do Monitor** > **Consultar status da nota.**

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2F2fhgDPr47GAUi8nvds2E%2Fimage.png?alt=media&amp;token=8ad3305d-30dc-4473-9e94-bbb63ad22229" alt=""><figcaption></figcaption></figure>

Irá abrir a tela para digitar no campo a **Chave da NF** com **44 caracteres**.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FOqSo4cKF1vTWVsFasGHC%2Fimage.png?alt=media&amp;token=d7aa0c04-04c1-4bcf-a1e6-ed4899279996" alt=""><figcaption></figcaption></figure>

Ao clicar em **Consultar** , irá retornar o Status atual da NFe.&#x20;

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FJklV6cxJeLYIQejgUZSn%2Fimage.png?alt=media&amp;token=2b6060e6-461a-471a-8001-ce42d8774980" alt=""><figcaption></figcaption></figure>

Para Sair ou Fechar a tela basta clicar em **Cancelar**.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2Fcj3PLdzllnjXAyuQV0Tn%2Fimage.png?alt=media&amp;token=e68819fd-d497-4bcf-b3ba-01b89a8e9d88" alt=""><figcaption></figcaption></figure>

### Tipos de Eventos monitorados <a href="#tipos-de-eventos-monitorados-pelo-push-da-nota-fiscal-eletronica" id="tipos-de-eventos-monitorados-pelo-push-da-nota-fiscal-eletronica"></a>

| Código do Evento | Descrição do Evento                                                     |
| ---------------- | ----------------------------------------------------------------------- |
| 790700           | Eventos de Averbação                                                    |
| 110111           | Evento de Cancelamento                                                  |
| 110140           | EPEC                                                                    |
| 110110           | Evento de Carta de Correção                                             |
| 210200           | Eventos de Confirmação de Operação                                      |
| 210210           | Eventos de Ciência da Operação                                          |
| 210220           | Eventos de Desconhecimento da Operação                                  |
| 210240           | Eventos de Operação não realizada                                       |
| 990910           | Eventos de Internalização SUFRAMA                                       |
| 990900           | Eventos de Vistoria SUFRAMA                                             |
| 630690           | Eventos de Vistoria SUFRAMA SEFAZ                                       |
| 111500           | Eventos de Pedido de Prorrogação de Prazo 1                             |
| 111501           | Eventos de Pedido de Prorrogação de Prazo 2                             |
| 111502           | Eventos de Cancelamento de Pedido de Prorrogação de Prazo 1             |
| 111503           | Eventos de Cancelamento de Pedido de Prorrogação de Prazo 2             |
| 411500           | Eventos do Fisco em Resposta ao Pedido de Prorrogação 1                 |
| 411501           | Eventos do Fisco em Resposta ao Pedido de Prorrogação 2                 |
| 411502           | Eventos do Fisco em Resposta de Cancelamento ao Pedido de Prorrogação 1 |
| 411503           | Eventos do Fisco em Resposta de Cancelamento ao Pedido de Prorrogação 2 |

## Histórico de Consultas de NF

Clicando em **Opções do Monitor.**

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2F2fhgDPr47GAUi8nvds2E%2Fimage.png?alt=media&amp;token=8ad3305d-30dc-4473-9e94-bbb63ad22229" alt=""><figcaption></figcaption></figure>

Irá abrir a tela de histórico das NF consultadas.

* **Data inicial/Data final:** Período para filtrar os eventos no histórico.
* **Tipo de Histórico:** Permite escolher os tipos de eventos que deseja visualizar (ex: Consulta Status, Inclusão Monitor, Exclusão Monitor, Notificação Evento, Erro). Sendo obrigatório preencher ao menos um tipo de histórico.
* **Buscar por:** Campo para buscar por chave ou número da nota fiscal.
* **Botões "Limpar filtro" e "Buscar":** Apaga os filtros aplicados ou executa a busca com os filtros.

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FcT8CEAs5J91GbAHEdm2L%2Fimage.png?alt=media&amp;token=4721dfbe-991a-4878-a3a4-3dff9509fbab" alt=""><figcaption></figcaption></figure>

| **Coluna**      | **Descrição**                                                                                                                                 |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data evento** | Data e horas em que o evento relacionado à nota fiscal foi registrado no sistema.                                                             |
| **Número NF**   | Número sequencial da nota fiscal associada ao evento, quando disponível.                                                                      |
| **Chave**       | Chave de acesso da nota fiscal relacionada ao evento, parcialmente ocultada por segurança.  Ao lado tem o botão para copiar a chave completa. |
| **Tipo**        | Tipo do evento registrado, como consulta de status, inclusão no monitor, exclusão do monitor, notificações, etc.                              |
| **Observação**  | Informações adicionais sobre o evento, como status autorizado, monitoramento ativado ou mensagens de erro.                                    |

<figure><img src="https://3151482664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEAovDXy8vcdx057MYX%2Fuploads%2FbxPoM5K0RU0PpWGShUX5%2Fimage.png?alt=media&amp;token=1968eee7-c2e5-4d0d-92c7-c9788fb66f5d" alt=""><figcaption></figcaption></figure>