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.

URL

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

Input data
FieldDescription
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"
          }' \
    https://cte.ns.eti.br/cte/inut
Returned data
FieldDescriptionNotes
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
CodeDescription
200Disablement carried out successfully
-3Error when carrying out the disablement. Check the return to identify the reason
400Mandatory fields not informed

Como podemos ajudar?