1. Inicio
  2. Documentos
  3. NS NFe (English)
  4. Events
  5. NFe Disable Numeration

NFe Disable Numeration

Through the Disable Numeration service, it’s possible to disable a sequence of NF-e numbers.

This process is used in cases where the contributer’s authorized NF-es did not follow the correct issuance sequence, thus creating numbering gaps. For example, if the contributor has authorized the NF-es numbered 1, 2 and 4, and for some reason not authorize the NF-e number 3, the number 3 must be disabled.


Production: POST https://nfe.ns.eti.br/nfe/inut

Input data
X-AUTH-TOKENUser access token1-1
cUFFU code of the issuer0-1
tpAmbType of NF-e disablement enviroment:
1 - Production
2 - Homologation
anoNumbering disablement year1-1
CNPJIssuer CNPJ0-1
serieNF-e series1-1
nNFIniInitial NF-e number to be disabled1-1
nNFFinFinal NF-e number to be disabled1-1
xJustInform the reason for the disablement request1-1Min. of 15 characters
Request example

NF-e disablement request

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN": "YOUR_TOKEN", 
         "cUF": "43", 
         "tpAmb": "2", 
         "ano": "16", 
         "CNPJ": "07364617000135", 
         "serie": "0", 
         "nNFIni": "9996", 
         "nNFFin": "9996", 
         "xJust": "Inutilizacao realizada para teste de integracao"
Returned data
statusProcessing status code
motivoProcessing status literal description
retornoInutNFeObject containing the return data from the disablement processingOnly when status = 200
retornoInutNFe.cStatReturned status code by Sefaz
retornoInutNFe.xMotivoSefaz returned status literal description
retornoInutNFe.chaveDisablement access key
retornoInut.tpAmbProcessing environment
retornoInutNFe.nProtDisablement homologation protocol number
retornoInutNFe.dhRecbtoDate and time of receipt of the disablement by SefazSefaz Standard: YYYY-MM-DDTHH:MM:SS+UTC. E.g.: 2016-06-13T15:04:10-02:00
retornoInutNFe.xmlInutDisablement distribution XML
Return example
  "status": 200,
  "motivo": "Consulta realizada com sucesso",
  "retornoInutNFe": {
    "cStat": "102",
    "xMotivo": "Inutilizacao de numero homologado",
    "chave": "43111111111111111111111111111111111111111",
    "tpAmb": 2,
    "dhRecbto": "2016-12-07T17:10:52-02:00",
    "nProt": "143160001541466",
    "xmlInut": "<?xml version=\"1.0\" encoding=\"utf-8\"?><ProcInutNFe versao=\"3.10\" xmlns=\"http://www.portalfiscal.inf.br/nfe\">...</ProcInutNFe>"
Return codes
200Disablement carried out successfully
-3Error carrying out the disablement. Check the return to identify the reason
-400Mandatory fields not informed

Como podemos ajudar?