1. Inicio
  2. Documentos
  3. NS NF3e (English)
  4. NF3-e Issue Process
  5. Download


The NF3-e download method is responsible for returning the JSON, XML and the DANF3E (Auxiliary document of the Electric Energy Eletronic Invoice) from providing the access key of an authorized NF3-e.


Production: POST https://nf3e.ns.eti.br/v1/nf3e/get

Input Data
X-AUTH-TOKEN1-1User access token
chNF3e1-1NF3-e access key
tpAmb1-1Environment type: 1 - Production, 2 - Homologation
tpDown1-1Download files type: X - XML, J - JSON, P - PDF, XP - XML and PDF, JP - JSON and PDF
Request Example

NF3-e download request

curl -X POST \
-H "Content-Type: application/json" \
-d '{"X-AUTH-TOKEN":"YOUR_TOKEN","chNF3e":"44444444444444444444444444444444444444444444","tpAmb":"2","tpDown":"XP"}' \
Returned Data
FieldDescriptionOccurrenceData TypeParentNotes
statusProcessing status codes1-1Int
motivoLiteral description of the processing status1-1String
chNF3eNF3-e access key0-1IntOnly when tpDown = X or XP. Only when status = 200
xmlAuthorized NF3-e distribution xml0-1StringOnly when tpDown = X or XP. Only when status = 200
pdfDANF3E pdf0-1StringNF3-e PDF Base 64. Only when tpDown = P or JP or XP. Only when status = 200
erroObject containing error informations when loading an NF3-e0-1Only when status is different from 200
cStatError status codeInt
xMotivoLiteral description of the errorString
Response Example

Successful response

    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chNF3e": "43191207364617000135660000000000101834241950",
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><nf3eProc versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/nf3e\"><NF3e><infNF3e versao=\"1.00\" Id=\"NF3e43191207364617000135660000000000101834241950\">...</nf3eProc>"
Return Codes
200Download successfully done
-2Invalid dowload type. Obs.: when the type is different from X, P, XP, or PX (case-insensitive)
-3Invalid access key
-4NF3-e not found with the given access key

Como podemos ajudar?