O método de download do MDF-e é responsável por retornar o JSON, XML e o DAMDFE (Documento Auxiliar de Manifesto de Documentos Fiscais Eletrônicos) a partir do fornecimento da chave de acesso de um MDF-e autorizado.
URL
Produção: POST https://mdfe.ns.eti.br/mdfe/get
Dados de entrada
| Campo | Ocorrência | Pai | Descrição |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso do usuário | |
| chMDFe | 1-1 | Chave de acesso do MDF-e | |
| tpAmb | 1-1 | Tipo de Ambiente: 1 - Produção 2 - Homologação | |
| tpDown | 1-1 | Tipo do download: X - XML J - JSON P - PDF XP - XML e PDFJP - JSON e PDF | |
| customizar | 0-1 | Objeto para customização da impressão | |
| seguradoras | 0-1 | customizar | Número de grupos de seguro a serem impressos. Pode ser informado um número ou o literal "TODAS" Valor padrão: 7 |
| averbacoes | 0-1 | customizar | Número de averbações a serem impressas. Pode ser informado um número ou o literal "TODAS" Valor padrão: 3 |
Exemplo de requisição
Requisição de download de MDF-e
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN":"SEU_TOKEN",
"chMDFe":"44444444444444444444444444444444444444444444",
"tpAmb":"2",
"tpDown":"XP"
}' \
https://mdfe.ns.eti.br/mdfe/get
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| chNFe | Chave da NF-e | |
| xml | XML de distribuição da NF-e autorizada | Somente em quando tipo = X ou XP Apenas com status = 200 |
| nfeProc | Objeto JSON com os dados de distribuição da NF-e autorizada | Somente em quando tipo = J ou JP Apenas com status = 200 |
| PDF da DANFE | Base64 do PDF do DANTE Somente em quando tipo = P, JP ou XP Apenas com status = 200 | |
| erro | Objeto contendo informações de erro ao carregar o CT-e | Apenas com status diferente de 200 |
| erro.cStat | Código do status de erro | |
| erro.xMotivo | Descrição literal do erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"chNFe": "44444444444444444444444444444444444444444444",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><nfeProc versao=\"3.10\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><NFe>...</NFe><protNFe versao=\"3.10\">...</protNFe></nfeProc>",
"pdf: "JVBERi0xLjQKJeLjz..."}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Download realizado com sucesso |
| -2 | Tipo de download inválido Obs.: Quando o tipo for diferente X, P, XP ou PX (case-insensitive). |
| -3 | Chave de acesso inválida |
| -4 | NF-e não encontrada com a chave de acesso informada |