Realizar Download de NF-e na SEFAZ

API para efetuar a requisição do download do XML na SEFAZ, após a manifestação da NF-e.

Download da NF-e Recebida

POST 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	Ambiente da requisição TAM: 1
chaveDeAcesso	string	Chave de acesso da NF-e recebida TAM: 44

Response

200

{
  "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
}

400

{
  "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
}

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 📝

// 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"
}

Swagger

Você poderá acessar a nossa API e o seu respectivo modelo de envio em nossa plataforma Swagger!

APIs Relacionadas 🎈

• Tipo de Ambiente

Referências à API 📌

• Passo-a-Passo do Recebimento NF-e

• Fluxograma - Recebimento NF-e