1. Inicio
  2. Documentos
  3. NS NFe (English)
  4. Events
  5. NFe Disablement Download

NFe Disablement Download

Through this service it’s possible to obtain the distribution XML e an graphical representation in PDF of a disablement previously authorized thorugh the Disable Numeration method.


POST or GET https://nfe.ns.eti.br/nfe/get/inut

Consuming the service via GET, the input data must be sent via QueryString. E.g.: https://nfe.ns.eti.br/nfe/get/inut?X-AUTH-TOKEN=YOUR_TOKEN&chave=99999999999999999999999999999999999999999&tpDown=x

Input data
FieldDescriptionOccurrenceData TypeNotes
X-AUTH-TOKENUser access token0-1String
chaveDisablement key1-1IntInformation from the Id attribute of the infInut tag without the literal ID at the beginning.
tpAmbNF-e authorization environment type0-1Int1 - Production
2 - Homologation
Standard value: 2
tpDownDownload type:
0-1StringStartard value: X
Request example

Download event request

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN": "YOUR_TOKEN", 
         "chave": "99999999999999999999999999999999999999999", 
         "tpDown": "p"
Returned data
FieldDescriptionOccurrenceData TypeParentNotes
statusProcessing status code1-1Int
motivoProcessing status literal description1-1String
retInutObject containing the disablement processing data at Sefaz0-1ObjectOnly when status = 200
cStatDisablement situation code at Sefaz1-1IntretInut
xMotivoEvent situation code literal description at Sefaz1-1StringretInut
chaveDisablement key1-1IntretInut
tpAmbEnvironment typeretInut1 = Production
2 = Homologation
dhRecebtoDate and time of receipt registration of the disablement at Sefaz1-1DateretInutSefaz Standard: YYYY-MM-DDTHH:MM:SS+UTC. E.g.: 2016-06-13T15:04:10-02:00
nProtSefaz disablement authorization protocol number1-1IntretInut
xmlEvent XML0-1StringretInutOnly when tpDown = X or XP. Only when status = 200
pdfEvent graphical representation in PDF0-1StringretInutBase64 PDF. Only when tpDown = P or XP. Only when status = 200
erroObject containing error information in case the donwload could not be carried out successfully0-1ObjectOnly when status is different from 200
erro.cStatError status code1-1Interro
erro.xMotivoError literal description1-1Stringerro
Return example

Successful return

  "status": 200,
  "motivo": "Evento localizado com sucesso",
  "retInut": {
    "cStat": "102",
    "xMotivo": "Inutilizacao de numero homologado",
    "chave": "99999999999999999999999999999999999999999",
    "tpAmb": 2,
    "dhRecbto": "2016-11-29T19:15:42-02:00",
    "nProt": "143160001512981",
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><ProcInutNFe versao=\"3.10\" xmlns=\"http://www.portalfiscal.inf.br/nfe\">...</ProcInutNFe>"
Return codes
200Disablement located successfully
-2Invalid download type
-3Not possible to carry out the disablement. Check the "erro" object for more information

Como podemos ajudar?