---
title: "Consulta uma NF-e"
method: GET
path: "/v1/nfe/{id}"
tags: ["Emissão de NF-e"]
---

# Consulta uma NF-e

`GET /v1/nfe/{id}`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/nfe/{id}`
- Auth: HTTP bearer

`{id}` aceita o id Sudrel, a sua `referencia` ou a chave de acesso.

## Path parameters

- `id` string, required

## Query parameters

- `empresa_id` string

## Response `200`

OK

- Nfe
  - `id` string
  - `referencia` string, nullable
  - `status` 'transmitindo' | 'aguardando_confirmacao' | 'autorizada' | 'rejeitada' | 'denegada' | 'cancelada' | 'descartada' | 'contingencia_epec'
  - `empresa_id` string
  - `ambiente` 'sandbox' | 'producao'
  - `simulacao` string, nullable
  - `modo` 'informado' | 'calcular' | 'conferir'
  - `modelo` 55
  - `serie` integer
  - `numero` integer
  - `chave_acesso` string
  - `chaves_anteriores` string[]: Chaves que a nota teve antes de uma correção num mês seguinte.
  - `chave_referenciada` string, nullable: Chave da NF-e de origem referenciada (devolução, complementar); null quando a nota não referencia nenhuma.
  - `protocolo` string, nullable
  - `emitida_em` string, date-time, nullable
  - `autorizada_em` string, date-time, nullable
  - `valor_total` string, nullable
  - `sefaz` object, nullable
    - `cstat` string
    - `motivo` string
  - `rejeicao` NfeRecusa, nullable
    - `codigo_oficial` string: cStat da SEFAZ.
    - `mensagem` string: xMotivo da SEFAZ.
    - `explicacao` object, nullable
      - `codigo` string
      - `campo` string, nullable
      - `correcao` string
  - `denegacao` NfeRecusa, nullable
    - `codigo_oficial` string: cStat da SEFAZ.
    - `mensagem` string: xMotivo da SEFAZ.
    - `explicacao` object, nullable
      - `codigo` string
      - `campo` string, nullable
      - `correcao` string
  - `falha_envio` object, nullable: Nota em `transmitindo` que ainda não chegou à SEFAZ por uma falha antes do envio. Com `certificado_recusado_pela_sefaz`, a SEFAZ recusou o certificado sem processar a nota (nenhuma NF-e foi criada lá): a Sudrel tenta de novo em `proxima_tentativa`, e a prontidão mostra o item `certificado_sefaz`. Com `envio_pausado`, a recusa se repetiu (3 vezes, por padrão) e a Sudrel parou de tentar (webhook `NFE_ENVIO_PAUSADO`): a nota volta sozinha quando o certificado passar no teste da prontidão (um certificado novo, ou o mesmo uma hora depois).
    - `motivo` 'certificado_recusado_pela_sefaz' | 'envio_pausado' | 'uf_indisponivel' | 'falha_antes_do_envio'
    - `mensagem` string
    - `desde` string, date-time, nullable
    - `proxima_tentativa` string, date-time, nullable
    - `pausado_em` string, date-time, nullable
  - `contingencia` object, nullable: A nota entrou em contingência (veja Contingência da NF-e). Nulo na emissão normal.
    - `modo` 'svc_an' | 'svc_rs' | 'epec'
    - `tp_emis` 4 | 6 | 7
    - `situacao` 'em_contingencia' | 'autorizada_em_contingencia' | 'epec_registrado' | 'epec_prazo_proximo' | 'epec_rejeitado' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
    - `motivo` string: A justificativa (xJust) impressa no DANFE.
    - `desde` string, date-time
    - `chave_original` string: A chave tpEmis 1, que nunca foi transmitida.
    - `chave_original_transmitida` false
    - `epec` object, nullable
      - `protocolo` string
      - `registrado_em` string, date-time
      - `prazo_transmissao` string, date-time: 168 horas depois do EPEC.
      - `correcao` string, nullable
    - `reconciliacao` object, nullable
      - `em` string, date-time
      - `resultado` 'original_inexistente' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
  - `confirmacao` object, nullable
    - `motivo` string
    - `desde` string, date-time, nullable
    - `mensagem` string
    - `correcao` string
  - `descarte` object, nullable
    - `em` string, date-time
    - `automatico` boolean
    - `motivo` string, nullable
  - `cancelamento` object, nullable
    - `em` string, date-time
    - `protocolo` string
    - `justificativa` string
  - `cartas_correcao` object[]
    - `sequencia` integer
    - `texto` string
    - `status` 'transmitindo' | 'registrada' | 'rejeitada'
    - `protocolo` string, nullable
    - `sefaz` object, nullable
      - `cstat` string
      - `motivo` string
    - `em` string, date-time
  - `ajustes` object[]
    - `campo` string
    - `acao` 'preenchido' | 'derivado' | 'exigido' | 'omitido' | 'calculado' | 'divergente'
    - `motivo` string
    - `regra` string
    - `valor` unknown
    - `versao` string: Versão da regra, tabela ou calculadora.
    - `fonte` string: Fonte legal do valor.
  - `eventos` object[]
    - `tipo` string
    - `em` string, date-time
    - `detalhe` object
  - `regras_versao` string
  - `criada_em` string, date-time
  - `atualizada_em` string, date-time
  - `links` object
    - `self` string
    - `xml` string
    - `danfe` string

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `404`: `nfe_nao_encontrada`: nenhuma NF-e com esse id, referência ou chave de acesso nesta conta e neste ambiente.
- `409`: `referencia_ambigua`: informe `empresa_id`.
- `429`: `limite_de_requisicoes` (`retentavel: true`): 120 requisições por minuto por chave, janela fixa de 60 s. Sem `Retry-After`: espere a virada do minuto e repita a MESMA requisição (com a mesma `Idempotency-Key`).

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)