NFe / NFCe

Consultar Inutilizações

Consulta as faixas de numeração já inutilizadas junto à SEFAZ.

GET/v1/nfe/inutilizacoes

Consulta as faixas de numeração já inutilizadas (via Inutilizar Numeração). Diferente da maioria dos endpoints de consulta, esta é uma consulta 100% local — os dados vêm do que já foi registrado pelo motor fiscal, sem uma nova chamada à SEFAZ.

Query Params

cnpjstring

CNPJ do emitente. Um dos dois — cnpj ou cpf — é obrigatório.

cpfstring

CPF do emitente. Um dos dois — cnpj ou cpf — é obrigatório.

data_recebimento_inicialstring

Filtra pela data de recebimento inicial (formato AAAA-MM-DD).

data_recebimento_finalstring

Filtra pela data de recebimento final (formato AAAA-MM-DD).

numero_inicialstring | number

Filtra por número inicial da faixa inutilizada.

numero_finalstring | number

Filtra por número final da faixa inutilizada.

Resposta

200 OK — array de faixas inutilizadas

statusstring

Status da inutilização.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

seriestring

Série do documento fiscal.

numero_inicialstring

Número inicial da faixa inutilizada.

numero_finalstring

Número final da faixa inutilizada.

modelostring

Modelo do documento fiscal.

cnpjstring

CNPJ do emitente.

caminho_xmlstring

URL pública do XML de inutilização, quando disponível.

protocolo_sefazstring

Número de protocolo da inutilização, quando disponível.

curl "https://app.nfe.tenzanlabs.com/v1/nfe/inutilizacoes?cnpj=12345678000199" \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI"

const faixas = await client.listVoidedRanges('55', {
  cnpj: '12345678000199',
});
console.log(faixas[0].status); // 'inutilizado'

faixas = client.list_voided_ranges("55", {
    "cnpj": "12345678000199",
})
print(faixas[0]["status"])  # 'inutilizado'

ListVoidedRangesQuery query = new ListVoidedRangesQuery();
query.cnpj = "12345678000199";

List<VoidedRange> faixas = client.listVoidedRanges("55", query);
System.out.println(faixas.get(0).status); // "inutilizado"

Exemplo de resposta

[
  {
    "status": "inutilizado",
    "status_sefaz": "102",
    "mensagem_sefaz": "Inutilização de número homologado",
    "serie": "1",
    "numero_inicial": "101",
    "numero_final": "105",
    "modelo": "55",
    "cnpj": "12345678000199",
    "caminho_xml": "https://storage.../inutilizacao.xml",
    "protocolo_sefaz": "135260000123456"
  }
]