NS CTe

  1. Inicio
  2. Documentos
  3. NS CTe
  4. Eventos de CTe
  5. Inutilização de numeração do CT-e

Inutilização de numeração do CT-e

Através do serviço de Inutilização de Numeração é possível inutilizar uma sequência de números de CT-e.

Este processo é utilizado em casos onde os CT-es autorizados de um contribuinte não seguiram a sequência correta de emissão criando assim brechas de numeração. Por exemplo, se o contribuinte tiver autorizado os CT-es de numeração 1, 2 e 4, e por algum motivo não autorizar o CT-e de número 3, o número 3 deverá ser inutilizado.

 URL

Produção: POST https://cte.ns.eti.br/cte/inut

Dados de entrada
CamposDescriçãoObservação
X-AUTH-TOKENToken de acesso do usuário
cUFCódigo da UF do emitente
tpAmbTipo do ambiente de autorização do CT-e: 1 – Produção, 2 – Homologação
anoAno de inutilização da numeração
CNPJCNPJ do emitente
modModelo do CT-e
serieSérie do CT-e
nCTIniNúmero do CT-e inicial a ser inutilizado
nCTFinNúmero do CT-e final a ser inutilizado
xJustInformar a justificativa do pedido de inutilização
Exemplo de requisição

Requisição de inutilização de CT-e

curl -X POST 
    \-H "Content-Type: application/json" 
    \-d '{
     "X-AUTH-TOKEN": "SEU_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
Dados retornados
CampoDescriçãoObservação
statusCódigo de status do processamento
motivoDescrição literal do status de processamento
retornoInutCTeObjeto contendo as dados de retorno do processamento da inutilizaçãoSomente em status = 200
retornoInutCTe.cstatCódigo do status retornado pela Sefaz
retornoInutCTe.xMotivoDescrição literal do status retornado pela Sefaz
retornoInutCTe.tpAmbAmbiente de processamento
retornoInutCTe.nProtNúmero do protocolo da inutilização
retornoInutCTe.dhRecbtoData e hora do recebimento da inutilização pela Sefaz
Exemplos de retorno

Retorno com sucesso

{
    "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"
    }
}
Códigos de retorno
CódigoDescrição
200 Consulta realizada com sucesso
-3Erro ao realizar a inutilização. Verifique o retorno para identificar o motivo.
-400Campo obrigatórios não informados

Como podemos ajudar?