---
title: "Consultar"
method: GET
path: "/nfce/{referencia}"
tags: ["NFCe"]
---

# Consultar

`GET /nfce/{referencia}`

Consulta o status de uma NFC-e emitida.
Retorna informações sobre o processamento da nota, incluindo status de autorização, caminhos para download do XML e DANFCe, QR Code e dados de eventos.

## Path parameters

- `referencia` string, required

## Query parameters

- `completa` 0 | 1

## Response `200`

Requisição processada com sucesso

- union
  - NFCeConsultaResponse — Mesmos campos da autorizada; status pode ser autorizado, erro_autorizacao ou denegado. Quando cancelada, veja o schema CanceladaResponse. Com completa=1 inclui requisicao_nota_fiscal, protocolo_nota_fiscal, etc.
    - `cnpj_emitente` string
    - `ref` string
    - `status` 'autorizado' | 'erro_autorizacao' | 'denegado'
    - `status_sefaz` string
    - `mensagem_sefaz` string
    - `chave_nfe` string
    - `numero` string
    - `serie` string
    - `caminho_xml_nota_fiscal` string
    - `caminho_danfe` string
    - `qrcode_url` string
    - `url_consulta_nf` string
    - `caminho_xml_cancelamento` string
    - `numero_protocolo` string
  - CanceladaResponse
    - `status` 'cancelado' — Status atual da NFSe.
    - `cnpj_prestador` string — O CNPJ emitente da nota fiscal .
    - `ref` string — Referência da NFSe Nacional.
    - `numero_rps` string — Número do RPS de controle do Ambiente Nacional.
    - `serie_rps` string — A série do RPS de controle do Ambiente Nacional.
    - `tipo_rps` string — O tipo do RPS.
    - `numero` string — Número da NFSe Nacional.
    - `codigo_verificacao` string — Código de verificação para consulta da NFSe Nacional, pode ser usado no portal do Ambiente Nacional para consulta.
    - `data_emissao` string — Data da emissão da nota fiscal.
    - `url` string, uri — URL para a consulta da nota fiscal no portal do Ambiente Nacional.
    - `url_danfse` string, uri — URL para acesso e download do DANFSe (versão PDF).
    - `caminho_xml_nota_fiscal` string — Caminho para acesso e download do XML da nota fiscal.
  - ErroAutorizacaoResponse
    - `status` 'erro_autorizacao' — Status atual da NFSe.
    - `cnpj_prestador` string — O CNPJ emitente da nota fiscal .
    - `ref` string — Referência da NFSe Nacional.
    - `numero_rps` string — Número do RPS de controle do Ambiente Nacional.
    - `serie_rps` string — A série do RPS de controle do Ambiente Nacional.
    - `tipo_rps` string — O tipo do RPS.
    - `erros` ArrayErrorResponse[]
      - `codigo` string — Código do erro
      - `mensagem` string — Mensagem do erro
      - `correcao` string — Correção do erro

## Other responses

- `401` — Não autorizado
- `403` — Permissão negada
- `404` — Recurso não encontrado

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/revisions/a32e528fc383/schema)