Consultar rejeição

Detalha uma rejeição SEFAZ específica: motivo, causas, passos de resolução e verificações analíticas.

GET /api/v1/rejeicoes/{codigo}

Retorna o detalhe completo de uma rejeição SEFAZ pelo código numérico: motivo oficial, causas comuns, passos para resolver e verificações analíticas que ajudam a diagnosticar o XML da NF-e.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de caminho

Name	Type	Required	Description
`codigo`	integer	Sim	Código numérico da rejeição SEFAZ (ex: `204`).

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/v1/rejeicoes/204" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/v1/rejeicoes/204",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.motivo, data.solucao_passos);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/v1/rejeicoes/204",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
)
data = response.json()
print(data["motivo"], data["solucao_passos"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/v1/rejeicoes/204');
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/v1/rejeicoes/204"
);
var json = await response.Content.ReadAsStringAsync();

Resposta

Campos

Campo	Tipo	Descrição
`codigo`	integer	Código numérico da rejeição SEFAZ.
`titulo`	string	Título legível da rejeição.
`slug`	string	Identificador usado na URL do blog.
`motivo`	string	Motivo oficial retornado pela SEFAZ.
`categoria`	string \| null	Categoria da rejeição. `null` quando não classificada.
`url_blog`	string	Caminho da página pública no blog (`/blog/rejeicoes/{slug}/`).
`causas`	array	Lista de causas comuns que disparam a rejeição.
`solucao_passos`	array	Passos ordenados para resolver a rejeição.
`verificacoes_analiticas`	array	Verificações multi-campo para diagnosticar o XML. Pode vir vazio.

Exemplo de resposta

{
  "codigo": 204,
  "titulo": "Rejeição 204 — Duplicidade de NF-e",
  "slug": "rejeicao-204-duplicidade-de-nf-e",
  "motivo": "Duplicidade de NF-e",
  "categoria": "Duplicidade",
  "url_blog": "/blog/rejeicoes/rejeicao-204-duplicidade-de-nf-e/",
  "causas": [
    "A NF-e já foi enviada e autorizada, mas o sistema tenta reenviá-la.",
    "Falha de comunicação: o sistema não recebeu a resposta de autorização e reenvia.",
    "A numeração da nota foi reaproveitada indevidamente."
  ],
  "solucao_passos": [
    "Consulte a situação da NF-e na SEFAZ pela chave de acesso ou pelo protocolo.",
    "Se já autorizada, utilize o XML retornado e não reenvie a nota.",
    "Se não autorizada, gere uma nova NF-e com numeração diferente.",
    "Ajuste o sistema emissor para tratar timeout consultando o recibo do lote."
  ],
  "verificacoes_analiticas": []
}

Códigos de erro

Código	HTTP Status	Descrição
`REJEICAO_NAO_ENCONTRADA`	404	Rejeição não encontrada no catálogo.
`REJEICOES_INDISPONIVEL`	502	Não foi possível consultar a rejeição no momento.

Esta pagina foi util?