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
| Field | Description |
|---|---|
| X-AUTH-TOKEN | User access token |
| cUF | FU code of the issuer |
| tpAmb | CT-e authorization environment type: 1 - Production, 2 - Homologation |
| ano | Year of the numbering disablement |
| CNPJ | CNPJ of the issuer |
| mod | CT-e model |
| serie | CT-e serie |
| nCTIni | Initial CT-e number to be disabled |
| nCTFin | Final CT-e number to be disabled |
| xJust | Inform 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
| Field | Description | Notes |
|---|---|---|
| status | Processing status code | |
| motivo | Processing status literal description | |
| retornoInutCTe | Object containing the return data of the disablement processing | Only when status = 200 |
| retornoInutCTe.cStat | Returned status code by Sefaz | |
| retornoInutCTe.xMotivo | Returned status literal description by Sefaz | |
| retornoInutCTe.tpAmb | Process environment | |
| retornoInutCTe.nProt | Disablement protocol number | |
| retornoInutCTe.dhRecbto | Date 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
| Code | Description |
|---|---|
| 200 | Disablement carried out successfully |
| -3 | Error when carrying out the disablement. Check the return to identify the reason |
| 400 | Mandatory fields not informed |