> For the complete documentation index, see [llms.txt](https://integracao.gitbook.io/invoisys/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integracao.gitbook.io/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/fluxos-operacionais/fluxo-recebimento-nf-e.md).

# Fluxo - Recebimento NF-e

O fluxo demonstrado a seguir trata o recebimento de NF-e dentro da integração com a InvoiSys.

## APIs Essenciais 💡

* **Requisitar consulta por Chave de Acesso**: /api/nfeentrada/entradadanfe
* **Enviar manifesto do documento:** /api/nfeentrada/manifestar

## APIs Opcionais 🥈

* **Consulta do documento por ID: /**api/nfeentrada/{id}
* **Realizar download do documento**: /api/nfeentrada/download
* **Realizar envio por e-mail do documento**: /api/nfeentrada/enviaemail

## Etapas e suas APIs

Para detalharmos melhor a operação, a separamos em tópicos, [porém você consegue ver o fluxo completo aqui](https://drive.google.com/open?id=1hruHx_lrPDH66bC69pRNhYKHpg8OvSgt) 📝.

### 1) Requisições e consultas periódicas

Antes de iniciamos a emissão da nota, é 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.

A princípio, nossa solução irá fazer a consulta periódica por documentos que foram emitidos contra o seu estabelecimento direto na SEFAZ. Da mesma forma, você poderá pedir para que o sistema faça isto com um documento em específico, utilizando a [API de Consulta por Chave de Acesso](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-recebimento-nf-e-por-chave-de-acesso.md).

Aqui existem algumas informações que podem ser interessantes você guardar, como a própria `chaveDeAcesso` e o `id` do documento criado em nossa base. Estas informações são importante, já que elas são utilizados em outras APIs.

![](/files/-M3rFT9MNtXLRZm513NA)

### 2) Realização do Manifesto

Com as informações do documento emitido contra a empresa em nossa base, você poderá realizar o envio de um manifesto. Um manifesto que pode ser composto por 4 tipos de eventos:

* Ciência da Operação;
* Confirmação da Operação;
* Desconhecimento da Operação;
* Operação não Realizada.

![](/files/-M3vA8uxqncZOclg4hFv)

{% tabs %}
{% tab title="Retorno da Operação de Manifesto" %}

```javascript
{
  "data": "0001-01-01T00:00:00",
  "tipo": {
    "key": 19,
    "value": "Confirmação da Operação"
  },
  "statusSEFAZ": "135",
  "descricaoSEFAZ": "Evento registrado e vinculado a NF-e",
  "xml": null
}
```

{% endtab %}
{% endtabs %}

### 3) Download e envio por E-mail

Com o documento disponibilizado para você em nossa solução, possuímos duas funcionalidades que estão disponíveis para seu auxílio.

[a) Download da NF-e](/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/fluxos-operacionais/fluxo-recebimento-nf-e.md#a-download-da-nf-e);\
[b) Envio por E-mail da NF-e](/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/fluxos-operacionais/fluxo-recebimento-nf-e.md#b-envio-por-e-mail-da-nf-e). 

#### a) Download da NF-e

Como o nome já diz, nós [disponibilizaremos uma API](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-xml-recebimento-nf-e.md) onde será retornado para você o XML do documento para consulta. Como forma alternativa, também possuímos a [API de consulta da DANFE](/invoisys/endpoints/recebimento-notas/nf-e/api-consulta-danfe-recebimento-nf-e.md) caso deseja realizar a visualização e download da mesma.

#### b) Envio por E-mail da NF-e

Com esta API, será possível montar um simples modelo de E-mail, incluindo assunto, corpo, destinatários e qual a NF-e a ser disponibilizada. Abaixo temos um exemplo de como esta API é montada:

```javascript
{
  "idNFe": 999999,
  "assunto": "NF-e de Entrada",
  "corpoEmail": "Mensagem do E0mail",
  "destinatarios": [
    "email@email.com"
  ]
}
```