# Consultar rejeição

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

URL: https://docs.fiscalapi.com.br/docs/rejeicoes/consultar-rejeicao


`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](/docs/getting-started/authentication) 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

<Tabs items="[&#x22;curl&#x22;, &#x22;JavaScript&#x22;, &#x22;Python&#x22;, &#x22;PHP&#x22;, &#x22;C#&#x22;]">
  <Tab value="curl">
    ```bash
    curl -X GET "https://api.fiscalapi.com.br/api/v1/rejeicoes/204" \
      -H "X-API-Key: fapi_sua_chave_aqui"
    ```
  </Tab>

  <Tab value="JavaScript">
    ```javascript
    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);
    ```
  </Tab>

  <Tab value="Python">
    ```python
    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"])
    ```
  </Tab>

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

  <Tab value="C#">
    ```csharp
    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();
    ```
  </Tab>
</Tabs>

## ## 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

```json
{
  "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. |