O endpoint /api/NFeInutilizacoes permite consultar as inutilizações de NF-e registradas para um CNPJ em determinado ano, retornando as faixas de numeração inutilizadas, protocolo e datas oficiais do pedido junto à SEFAZ.
NFe - Nota Fiscal Eletrônica - Inutilizações
API de consulta de inutilizações de Nota Fiscal Eletrônica (NF-e), permitindo identificar faixas de numeração inutilizadas por CNPJ, modelo e série. Retorna número inicial e final, protocolo, data/hora do pedido e status. Ideal para auditoria, compliance fiscal e controle de sequência de documentos.
Casos de Uso
- Auditoria fiscal da sequência numérica de NF-es emitidas.
- Identificação de faixas de numeração inutilizadas por CNPJ, modelo e série.
- Processos de compliance fiscal e governança tributária.
- Validação da integridade da numeração de documentos fiscais.
- Suporte a auditorias internas, externas e cruzamentos com SEFAZ.
Aplicações
- Onboarding de Clientes e Fornecedores
- Compliance/ESG
Benefícios
- Acesso estruturado às inutilizações registradas oficialmente na SEFAZ.
- Reduz riscos fiscais relacionados a quebras de sequência de notas.
- Permite validação automatizada da integridade documental.
- Integração simples com sistemas fiscais, ERPs e rotinas de auditoria.
- Possibilidade de geração de comprovante em PDF da consulta.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/NotaFiscalEletronicaInutilizacaoEndpoint
GET https://apiv3.directd.com.br/api/NotaFiscalEletronicaInutilizacao?CNPJ={0}&Ano={1}&Token=Seu_TokenDescrição: Endpoint para realizar consultas NFe - Nota Fiscal Eletrônica - Inutilizações.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Ano de Competência: Ano de competência da parcela
- CNPJ: CNPJ da empresa
- Data da Autorização: Informa a data de autorização da inutilização.
- Data de Recebimento AN: Informa a data de recebimento do registro.
- Lista de Inutilizações: Lista as inutilizações presentes no registro.
- Modelo: Informa o modelo do veículo.
- Número Final: Informa o número final da inutilização.
- Número Inicial: Informa o número inicial da inutilização.
- Observação: Observação relacionada ao registro retornado
- Protocolo: Protocolo de identificação da consulta
- Razão Social: Razão social da empresa
- Série: Informa a série do registro.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ANO | string | Sim | |
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cnpj": "string",
"razaoSocial": "string",
"inutilizacoes": [
{
"ano": 0,
"modelo": 0,
"serie": 0,
"numeroInicial": 0,
"numeroFinal": 0,
"protocolo": "string",
"dataAutorizacao": "string",
"dataRecebimentoAN": "string"
}
],
"observacao": "string"
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Informe apenas um único documento por requisição
- Para obter o comprovante desta consulta, utiliza-se: '&GerarComprovante=habilitar' na URL
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228