v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFe

Inutilizar Numeração

Inutiliza uma faixa de numeração de NFe.

Em uma situação normal você não precisará informar ao SEFAZ a inutilização de um número da NFe, pois a API controla automaticamente a numeração das notas. Porém, se por alguma situação específica for necessário a inutilização de alguma faixa de números você poderá usar este endpoint.

Este método é síncrono.

post/nfe/inutilizacao

Request body

cnpjstring required

CNPJ da empresa emitente

seriestring required

Série da numeração da NFe

numero_inicialstring required

Número inicial a ser inutilizado

numero_finalstring required

Número final a ser inutilizado

justificativastring required

Justificativa da inutilização (mínimo 15 caracteres)

Example request

{
  "cnpj": "12345678000123",
  "serie": "1",
  "numero_inicial": "7",
  "numero_final": "9",
  "justificativa": "Teste de inutilização de nota"
}

Response

Inutilização realizada

status'autorizado' | 'erro_autorizacao'

Status da inutilização

status_sefazstring

Status na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ

seriestring

Série da numeração

numero_inicialstring

Número inicial inutilizado

numero_finalstring

Número final inutilizado

modelostring

Modelo do documento (55 para NFe)

cnpjstring

CNPJ da empresa

caminho_xmlstring

Caminho do XML para download

protocolo_sefazstring

Número de protocolo da inutilização

Example response

{
  "status": "autorizado",
  "status_sefaz": "102",
  "mensagem_sefaz": "Inutilizacao de numero homologado",
  "serie": "1",
  "numero_inicial": "999",
  "numero_final": "1000",
  "modelo": "55",
  "cnpj": "12345678000123",
  "protocolo_sefaz": "135210002233889"
}