DC-e

Consultar DC-e

Devolve status, protocolo, links de download do XML / DACE e o eco da requisição de emissão.

GET/openapi/v2/empresas/{empresaId}/dc-e/{dceId}

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Consulta o documento pelo id enviado na emissão. A seção de eco (remetente … observacoesMarketplace) vem do snapshot normalizado da requisição tirado na aceitação e continua disponível depois que a tarefa chega a um estado terminal. Os links de download têm o formato {base pública}/openapi/files/{kind}/{ref}?token=… (kind é xml ou dace); o token carrega a credencial, então não há cabeçalhos de assinatura, a validade vem da configuração do inquilino (padrão 7 dias) e os links são reassinados a cada consulta. Veja Download de arquivos.

Parâmetros de caminho

`empresaId*`	string	Identificador da empresa emitente
`dceId*`	string	Identificador do documento

* Campo obrigatório

200

Documento encontrado. Os campos de fato do documento (numero, chaveAcesso, protocolo, links) vão sendo preenchidos conforme o status avança.

`id`	string	Identificador da requisição
`ambiente`	string	Ambiente
`status`	string	Status do documento
`motivoStatus`	string	Motivo do status
`dataCriacao`	string	Momento da aceitação
`dataUltimaAlteracao`	string	Última alteração
`numero`	int	Número do documento
`serie`	string	Série
`dataEmissao`	string	Data de emissão
`chaveAcesso`	string	Chave de acesso
`dataAutorizacao`	string	Data de autorização
`linkDace`	string	Link do DACE
`linkDownloadXml`	string	Link do XML
	object	Protocolo de autorização
`emitidaEmContingencia`	bool	Emitida em contingência
`remetente`	object	Remetente
`destinatario`	object	Destinatário
`itens`	array	Itens declarados
`transporte`	object	Transporte
`autorizacaoDownloadXml`	array	Autorizados a baixar o XML
`informacoesAdicionais`	string	Observação do marketplace
`informacoesAdicionaisFisco`	string	Observação ao fisco
`informacoesAdicionaisEmitente`	string	Observação do emitente
`observacoesMarketplace`	array	Observações do marketplace

`ambiente`Ambiente de emissão

Valores	Significado
Homologacao	Ambiente de teste da SEFAZ; o documento não tem validade
Producao	Ambiente oficial

`status`Status do documento

O webhook tem ainda CancelamentoNegado: a SEFAZ rejeitou o cancelamento e o documento voltou a Autorizada; a consulta devolve Autorizada com o motivo em motivoStatus, e um cancelamento corrigido pode ser enviado de novo.

Valores	Significado
Pendente	Aceito, na fila ou em envio; `numero` e `chaveAcesso` aparecem depois da numeração
Autorizada	Autorizado pela SEFAZ; `linkDownloadXml`, `linkDace` e `protocolo` disponíveis; se o último cancelamento foi rejeitado, `motivoStatus` traz o motivo
Negada	Rejeitado pela SEFAZ; `motivoStatus` é o código e a descrição da rejeição
CancelamentoPendente	Cancelamento aceito, aguardando o veredito da SEFAZ
Cancelada	Cancelado; `linkDace` aponta para a versão com a marca d'água `CANCELADA`
Falha	Falha terminal da tarefa (parâmetros não interpretáveis, retentativas esgotadas); `motivoStatus` explica; o mesmo `id` pode ser reenviado

Código	HTTP
10019002	404	`dceId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10019003	404	`dceId` não encontrado ou não pertence à empresa. Verifique o id e o `empresaId`.
10003000	404	`empresaId` não encontrado.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/dc-e/{dceId}'

TIMESTAMP=$(date +%s)

SIGN=$(printf '%s%s%s' "$APP_SECRET" "$API_PATH" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X GET "https://api.v2.tffiscal.com${API_PATH}" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN"

{

"id": "DCe-000012333",

"ambiente": "Homologacao",

"status": "Autorizada",

"motivoStatus": null,

"dataCriacao": "2026-09-06T12:00:00Z",

"dataUltimaAlteracao": "2026-09-06T12:00:03Z",

"numero": 1,

"serie": "1",

"dataEmissao": "2026-09-06T12:00:00Z",

"chaveAcesso": "41260940673061000134990010000000011101234565",

"dataAutorizacao": "2026-09-06T12:00:03Z",

"linkDace": "https://api.v2.tffiscal.com/openapi/files/dace/35260940673061000134990010000000011100000016?token=...",

"linkDownloadXml": "https://api.v2.tffiscal.com/openapi/files/xml/7?token=...",

"protocolo": { "numero": "141260000000001", "digestValue": "tasG40Ic6Zh7PIBiLEEH7Hb940Y=" },

"emitidaEmContingencia": false,

"remetente": {

"tipoPessoa": "F", "nome": "JOAO DA SILVA", "email": "joao@exemplo.com", "cpfCnpj": "12345678909", "telefone": "41999990000",

"endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "RUA XV DE NOVEMBRO", "numero": "100", "complemento": null, "bairro": "CENTRO", "cep": "80020310" }

"destinatario": {

"tipoPessoa": "F", "nome": "MARIA OLIVEIRA", "email": null, "cpfCnpj": "11144477735", "telefone": null,

"endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "complemento": "AP 12", "bairro": "BELA VISTA", "cep": "01310100" }

"itens": [

{ "descricao": "BOLSA DE COURO", "ncm": "42021220", "quantidade": 1, "valorUnitario": 80.00, "informacoesAdicionais": null },

{ "descricao": "CARTEIRA", "ncm": "42023100", "quantidade": 2, "valorUnitario": 40.00, "informacoesAdicionais": null }

"transporte": { "modalidade": "PelosCorreios", "cnpjTransportadora": null },

"autorizacaoDownloadXml": [ { "cpfCnpj": "14422279000106" } ],

"informacoesAdicionais": null,

"informacoesAdicionaisFisco": null,

"informacoesAdicionaisEmitente": null,

"observacoesMarketplace": [ { "nome": "PURCHASE_ID", "valor": "OC000332322SR-1" } ]

}

Consultar DC-e

Parâmetros

Parâmetros de caminho

Respostas

Enumerações2 tabelas

ambienteAmbiente de emissão

statusStatus do documento

Erros3 itens

`ambiente`Ambiente de emissão

`status`Status do documento