DC-e

Query DC-e

Returns status, protocol, XML / DACE download links and the echo of the issuance request.

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

Requires the token, timestamp and sign signature headers, see Authentication.

Queries the document by the id sent at issuance. The echo section (remetente … observacoesMarketplace) comes from the normalized request snapshot taken at acceptance and stays available after the task reaches a terminal state. Download links look like {public base}/openapi/files/{kind}/{ref}?token=… (kind is xml or dace); the token carries the credential so no signature headers are needed, the lifetime comes from the tenant-level setting (default 7 days), and links are re-signed on every query. See File download.

Path parameters

`empresaId*`	string	Issuing company identifier
`dceId*`	string	Document identifier

* Required field

200

Document found. Document fact fields (numero, chaveAcesso, protocolo, links) are filled in as the status advances.

`id`	string	Request identifier
`ambiente`	string	Environment
`status`	string	Document status
`motivoStatus`	string	Status reason
`dataCriacao`	string	Acceptance time
`dataUltimaAlteracao`	string	Last change
`numero`	int	Document number
`serie`	string	Series
`dataEmissao`	string	Issue time
`chaveAcesso`	string	Access key
`dataAutorizacao`	string	Authorization time
`linkDace`	string	DACE link
`linkDownloadXml`	string	XML link
	object	Authorization protocol
`emitidaEmContingencia`	bool	Issued in contingency
`remetente`	object	Sender
`destinatario`	object	Recipient
`itens`	array	Declared items
`transporte`	object	Transport
`autorizacaoDownloadXml`	array	XML download authorizations
`informacoesAdicionais`	string	Marketplace remark
`informacoesAdicionaisFisco`	string	Tax authority remark
`informacoesAdicionaisEmitente`	string	Issuer remark
`observacoesMarketplace`	array	Marketplace custom entries

`ambiente`Issue environment

Values	Meaning
Homologacao	SEFAZ test environment; the document has no legal effect
Producao	Official environment

`status`Document status

The webhook also has CancelamentoNegado: SEFAZ rejected the cancellation and the document went back to Autorizada; the query returns Autorizada with the reason in motivoStatus, and a corrected cancellation may be sent again.

Values	Meaning
Pendente	Accepted, queued or being sent; `numero` and `chaveAcesso` appear once numbered
Autorizada	Authorized by SEFAZ; `linkDownloadXml`, `linkDace` and `protocolo` available; if the last cancellation was rejected, `motivoStatus` carries the reason
Negada	Rejected by SEFAZ; `motivoStatus` is the rejection code and description
CancelamentoPendente	Cancellation accepted, waiting for the SEFAZ verdict
Cancelada	Cancelled; `linkDace` points to the version with the `CANCELADA` watermark
Falha	Terminal task failure (unparseable parameters, retries exhausted); `motivoStatus` explains; the same `id` may be resubmitted

Code	HTTP
10019002	404	`dceId` not found or not owned by the company. Check the id and `empresaId`.
10019003	404	`dceId` not found or not owned by the company. Check the id and `empresaId`.
10003000	404	`empresaId` not found.

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" } ]

}

Query DC-e

Parameters

Path parameters

Responses

Enumerations2 tables

ambienteIssue environment

statusDocument status

Errors3 items

`ambiente`Issue environment

`status`Document status