1. Inicio
  2. Documentos
  3. NS CTe (English)
  4. CTe Events
  5. CT-e Disable Numeration

CT-e Disable Numeration

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

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


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

Input data
X-AUTH-TOKENUser access token
cUFFU code of the issuer
tpAmbCT-e authorization environment type: 1 - Production, 2 - Homologation
anoYear of the numbering disablement
CNPJCNPJ of the issuer
modCT-e model
serieCT-e serie
nCTIniInitial CT-e number to be disabled
nCTFinFinal CT-e number to be disabled
xJustInform the reason for the disablement request
Request example

Disablement request

curl -X POST 
    \-H "Content-Type: application/json"
    \-d '{
          "X-AUTH-TOKEN": "YOUR_TOKEN", 
          "cUF": "43", 
          "ano": "16", 
          "CNPJ": "99999999999999", 
          "mod": "57", "serie": "0", 
          "nCTIni": "1", 
          "nCTFin": "1", 
          "xJust": "Inutilizacao realizada para teste de integracao", 
          "tpAmb": "2"
          }' \
Returned data
statusProcessing status code
motivoProcessing status literal description
retornoInutCTeObject containing the return data of the disablement processingOnly when status = 200
retornoInutCTe.cStatReturned status code by Sefaz
retornoInutCTe.xMotivoReturned status literal description by Sefaz
retornoInutCTe.tpAmbProcess environment
retornoInutCTe.nProtDisablement protocol number
retornoInutCTe.dhRecbtoDate and time of the disablement receipt by Sefaz
Return example

Successful return

    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "retornoInutCTe": {
        "cstat": 102,
        "xMotivo": "Inutilizacao de numero homologado",
        "tpAmb": 2,
        "nProt": "143160000525998",
        "dhRecbto": "2016-11-14T08:36:38"
Return codes
200Disablement carried out successfully
-3Error when carrying out the disablement. Check the return to identify the reason
400Mandatory fields not informed

Como podemos ajudar?