# Fluxo - Recebimento Fatura

O fluxo demonstrado a seguir trata do recebimento de Fatura dentro da integração com a InvoiSys.

## APIs Essenciais 💡

* **Realizar consulta Fatura por NSUi**: [/v1/fatura-entrada/eventos-nsui/{cnpj}/{nsui}](https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-xml-resumido-obtido)
* **Realizar Envio XML de Fatura:** [v1/fatura-entrada/enviar-xml](https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-por-xml)
* **Indicar Cancelamento de Fatura:** [v1/fatura-entrada/indicar-cancelamento/{ambiente}/{id}](https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/indicar-cancelamento-de-fatura)

## APIs Opcionais 🥈

* **Realizar consulta de XML de Fatura:** v1/fatura-entrada/obter-xml/{ambiente}/{id}
* **Realizar envio de Anexo:** [v1/fatura-entrada/anexar](https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-por-xml-2)
* **Realizar consulta de anexo de Fatura:** [/v1/fatura-entrada/obter-anexo/{ambiente}/{id}](https://app.gitbook.com/o/-Lmo0TUHOztVF3fNCAm-/s/-Lmo0dH8REcSzSboskDA/~/changes/641/endpoints/recebimento-notas/ct-e-2/api-entrada-de-nf-e-xml-resumido-obtido-1)

## Etapas e suas APIs

Antes de iniciamos a consulta das notas, é necessário estar com um token de acesso válido, pois este será utilizado no cabeçalho da chamada das APIs. Tendo ele em mãos, podemos partir para as devidas operações do fluxo. 

### 1) Consultar Fatura por NSUI

Com as Faturas disponibilizadas em nossa solução, temos duas funcionalidades disponiveis para a obtenção das informações capturadas das Faturas:

<sup>a) Consulta de Fatura através do NSUI</sup>\ <sup>b) Consulta de Fatura por ID</sup>

**a) Consulta da Fatura por NSUI**

Este e o processo de consulta dos documentos utilizando o Número Sequencial Único Invoisys (NSUi),  que são vinculados aos Documentos e o CNPJ do Contratante.&#x20;

Cada Consulta Retorna até 50 documentos de acordo com o Numero Sequencial, informando também o ultimo numero consultado e o numero sequencial máximo disponível para consulta.

**b) Consulta de Fatura por ID**

Está API é utilizada para efetuar a consulta do XML no formato base64 de uma Fatura de Entrada, pelo ID do documento, retornado no momento da carga do documento ou nos detalhes da Fatura.

### 2) Indicar cancelamento de Fatura&#x20;

Usado para atribuir o status de cancelamento para uma Fatura por um ID de Documento.

### 3) Enviar Anexo

Através desse endpoint é possível enviar um arquivo (imagem, pdf, texto, etc) e vincula-lo a um documento através de seu ID informado no momento de sua carga ou de sua consulta via NSUI.

<figure><img src="/files/nqLBZFepVLNWKmGk5niY" alt="" width="563"><figcaption><p>Enviar e vincular Anexo</p></figcaption></figure>

### 4) Consultar Anexo

Através desse endpoint é possível obter o arquivo (imagem, pdf, texto, etc) enviado através do enpoint de Envio de Anexo em base64, utilizando o ID do Arquivo devolvido no momento da carga do anexo.

<figure><img src="/files/Z6d1lGnvXi4bNsDC9Wpt" alt="" width="563"><figcaption><p>Obter anexo via Id do Arquivo</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/recebimento/ct-e-3/fluxos-operacionais/fluxo-recebimento-ct-e.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.