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.
URL
Production: POST https://nfe.ns.eti.br/nfe/inut
Input data
| Field | Description | Occurrence | Notes |
|---|---|---|---|
| X-AUTH-TOKEN | User access token | 1-1 | |
| cUF | FU code of the issuer | 0-1 | |
| tpAmb | Type of NF-e disablement enviroment: 1 - Production 2 - Homologation | 0-1 | |
| ano | Numbering disablement year | 1-1 | |
| CNPJ | Issuer CNPJ | 0-1 | |
| serie | NF-e series | 1-1 | |
| nNFIni | Initial NF-e number to be disabled | 1-1 | |
| nNFFin | Final NF-e number to be disabled | 1-1 | |
| xJust | Inform the reason for the disablement request | 1-1 | Min. 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"
}'\
https://nfe.ns.eti.br/nfe/inut
Returned data
| Field | Description | Notes |
|---|---|---|
| status | Processing status code | |
| motivo | Processing status literal description | |
| retornoInutNFe | Object containing the return data from the disablement processing | Only when status = 200 |
| retornoInutNFe.cStat | Returned status code by Sefaz | |
| retornoInutNFe.xMotivo | Sefaz returned status literal description | |
| retornoInutNFe.chave | Disablement access key | |
| retornoInut.tpAmb | Processing environment | |
| retornoInutNFe.nProt | Disablement homologation protocol number | |
| retornoInutNFe.dhRecbto | Date and time of receipt of the disablement by Sefaz | Sefaz Standard: YYYY-MM-DDTHH:MM:SS+UTC. E.g.: 2016-06-13T15:04:10-02:00 |
| retornoInutNFe.xmlInut | Disablement 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
| Code | Description |
|---|---|
| 200 | Disablement carried out successfully |
| -3 | Error carrying out the disablement. Check the return to identify the reason |
| -400 | Mandatory fields not informed |