> 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/endpoints/recebimento-notas/nf-e/api-realizar-download-de-nf-e-na-sefaz.md).

# Realizar Download de NF-e na SEFAZ

## Download da NF-e Recebida

<mark style="color:green;">`POST`</mark> `https://sandbox-api.invoisys.com.br/api/nfeentrada/download`

O método aplicará a tentativa de download na NF-e pelo idNFeEntrada ou chaveDeAcesso.

#### Headers

| Name          | Type   | Description                           |
| ------------- | ------ | ------------------------------------- |
| Content-Type  | string | `application/x-www-form-urlencoded​​` |
| Accept        | string | `application/jso​n​`                  |
| Authorization | string | `bearer <valor>`                      |

#### Request Body

| Name          | Type    | Description                                                     |
| ------------- | ------- | --------------------------------------------------------------- |
| idNFeEntrada  | string  | ID da NF-e recebida                                             |
| ambiente      | integer | <p>Ambiente da requisição<br><code>TAM: 1</code></p>            |
| chaveDeAcesso | string  | <p>Chave de acesso da NF-e recebida<br><code>TAM: 44</code></p> |

#### Response

{% tabs %}
{% tab title="200 " %}

```csharp
{
  "idNFeEntrada": 647092,
  "numero": 502693,
  "serie": 2,
  // Mensagem da SEFAZ
  "mensagem": "Download realizado",
  // Response code da requisição. 200 = Sucesso, 400 = Erro
  "statusCode": 200,
  "statusSEFAZ": "138",
  // Flag indicando se é necessário efetuar primeiramente o manifesto da NF-e
  "manifestarParaDownload": false,
  // Flag que indica quando o download é impedido é impedido, devido ao fato da NF-e ter recebido o manifesto de 
  // Desconhecimento ou Operação não Realizada
  "downloadImpedidoPeloUltimoManifesto": false,
  // Indica que não deve atualizar a grid automaticamente
  "ignorarSignalR": false,
  // Data de agendamento da próxima tentativa de download, caso a SEFAZ não tenha localizado o documento
  "dataAgendamentoDownload": null,
  // 0 = Desconhecida, 1 = Consulta Destinatario Via Sefaz, 3 = Download Via Sefaz,
  // 4 = ChaveDeAcesso, 5 = Arquivo Via API, 6 = Arquivo Via Recebimento Email
  "origemXML": 2
}
```

{% endtab %}

{% tab title="400 " %}

```csharp
{
  "idNFeEntrada": 1752,
  "numero": 91558,
  "serie": 1,
  // Mensagem da SEFAZ
  "mensagem": "Documento sem manifestação de ciência ou confirmação da operação.",
  // Response code da requisição. 200 = Sucesso, 400 = Erro
  "statusCode": 400,
  "statusSEFAZ": "",
  // Flag indicando se é necessário efetuar primeiramente o manifesto da NF-e para poder prosseguir com o download
  "manifestarParaDownload": true,
  "downloadImpedidoPeloUltimoManifesto": false,
  "ignorarSignalR": false,
  // Data de agendamento da próxima tentativa de download em casos de timedout ou em que a SEFAZ retorna que o documento não foi localizado
  "dataAgendamentoDownload": null,
  "origemXML": 0
}
```

{% endtab %}
{% endtabs %}

| Name          | Type   | Description  |
| ------------- | ------ | ------------ |
| Content-Type  | string | fsOEsNgtKA85 |
| Accept        | string | 5LFepW77VtAD |
| Authorization | string | cctFaIsT8LHj |

| Name          | Type    | Description  |
| ------------- | ------- | ------------ |
| idNFeEntrada  | string  | 0X7MlODHtKuP |
| ambiente      | integer | 4wSLt2BBvpHj |
| chaveDeAcesso | string  | RMyYY9kb73IP |

### Modelo de Envio 📝

```csharp
// Requisição por ID
{
  "idNFeEntrada": 140621,
  // Ambiente da requisição. Prod = 1, Hom = 2
  "ambiente": 1
}

// Requisição por chave de acesso
{
  // Ambiente da requisição. Prod = 1, Hom = 2
  "ambiente": 1,
  "chaveDeAcesso": "35210817921427000125558840000001101224707152"
}

```

{% hint style="info" %}

#### Swagger

[Você poderá acessar a nossa API e o seu respectivo modelo de envio em nossa plataforma Swagger!](http://api.invoisys.com.br/swagger/ui/index#!/NFeEntrada/NFeEntrada_Download)
{% endhint %}

## APIs Relacionadas 🎈

* [Tipo de Ambiente](/invoisys/endpoints/outras-consultas/enumeradores/api-tipo-de-ambiente.md)

## Referências à API 📌

* [Passo-a-Passo do Recebimento NF-e](/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/passo-a-passo.md)
* [Fluxograma - Recebimento NF-e](/invoisys/getting-started/documentos-fiscais/recebimento/nf-e/fluxos-operacionais/fluxo-recebimento-nf-e.md)