---
title: "Consultar"
method: GET
path: "/dce/{referencia}"
tags: ["DCe"]
---

# Consultar

`GET /dce/{referencia}`

Após enviar uma DCe, você poderá usar a operação de consulta para verificar se ela está em processamento ou se já foi processada.

Como retorno você receberá os campos descritos abaixo, de acordo com o status da declaração.

## Path parameters

- `referencia` string, required

## Response `200`

Requisição processada com sucesso

- union
  - DceResponseProcessando
    - `cnpj_emitente` string — CNPJ do emitente
    - `ref` string — Referência única da DCe.
    - `status` string — Status da DCe
  - DceResponseAutorizada
    - `cnpj_emitente` string — CNPJ do emitente
    - `ref` string — Referência única da DCe.
    - `status` string — Status da DCe
    - `status_sefaz` string — Código de status retornado pelo autorizador
    - `mensagem_sefaz` string — Mensagem retornada pelo autorizador
    - `chave` string — Chave de acesso da DCe (44 dígitos)
    - `numero` string — Número da DCe
    - `serie` string — Série da DCe
    - `modelo` string — Modelo da DCe (99)
    - `caminho_xml` string — URL para download do XML da DCe autorizada
    - `caminho_dace` string — URL para download da DACE (Declaração Auxiliar de Conteúdo Eletrônica)
    - `caminho_dace_resumido` string — URL para download da DACE (Declaração Auxiliar de Conteúdo Eletrônica) resumida
  - DceCanceladaResponse
    - `cnpj_emitente` string — CNPJ do emitente
    - `ref` string — Referência única da DCe.
    - `status` 'cancelado' — Status da DCe
    - `status_sefaz` string — Código de status retornado pelo autorizador
    - `mensagem_sefaz` string — Mensagem retornada pelo autorizador
    - `chave` string — Chave de acesso da DCe
    - `numero` string — Número da DCe
    - `serie` string — Série da DCe
    - `modelo` string — Modelo da DCe (99)
    - `caminho_xml` string — URL para download do XML da DCe
    - `caminho_dace` string — URL para download do DACE
    - `caminho_xml_cancelamento` string — URL para download do XML de cancelamento
  - DceErroAutorizacaoResponse
    - `cnpj_emitente` string — CNPJ do emitente
    - `ref` string — Referência única da DCe.
    - `status` 'erro_autorizacao' — Status da DCe
    - `status_sefaz` string — Código de status retornado pelo autorizador
    - `mensagem_sefaz` string — Mensagem retornada pelo autorizador
    - `erros` ErrorResponse[] — Lista de erros de validação ou rejeição
      - `codigo` string — Código do erro
      - `mensagem` string — Mensagem descritiva do erro
      - `correcao` string — Correção do erro

## Other responses

- `401` — Não autorizado
- `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)