1. Inicio
  2. Documentos
  3. NS NFe (English)
  4. Utility Functions
  5. List of NSNRecs linked to an NFe

List of NSNRecs linked to an NFe

Through this endpoint it’s possible to consult a list of NSNRecs linked to an NF-e using its access key.


Production: POST https://nfe.ns.eti.br/util/list/nsnrecs

Input data

The input data of this method must be in the request body in JSON format or as a QueryString in the method URL.

FieldDescriptionData TypeOccurrenceNotes
X-AUTH-TOKENUser access tokenString1-1
chNFeNFe- access keyInt1-1
Request example

NSNRecs List Request

curl -X POST \
       -H "Content-Type: application/json" \-d '{"X-AUTH-TOKEN": "SEU_TOKEN", "chNFe":"43170120121850000156550010002037451076558734"}'\

Returned data
FieldDescriptionData TypeOccurrenceParentNotes
statusProcessing status codeInt1-1
motivoProcessing status literal descriptionString1-1
nsNRecsObject containing the requested person's dataArray1-1It will only contain items if nsNRecs linked to the provided NF-e key are found
nsNRecLinked nsNRecInt1-1nsNRecs
cStatnsNRec status codeInt1-1nsNRecs
xMotivonsNRec status literal descriptString1-1nsNRecs
Return example
   "status": 200,
   "motivo": "Consulta realizada com sucesso",
   "nsNRecs": [
         "nsNRec": 210584,
         "cStat": 100,
         "xMotivo": "Autorizado o uso da NF-e"
Return codes
200Consult carried out successfully
-2Invalid access key

Como podemos ajudar?