DC-e

Consultar DC-e

Devuelve estado, protocolo, enlaces de descarga del XML / DACE y el eco de la solicitud de emisión.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Consulta el documento por el id enviado en la emisión. La sección de eco (remetente … observacoesMarketplace) proviene del snapshot normalizado de la solicitud tomado en la aceptación y sigue disponible después de que la tarea llega a un estado terminal. Los enlaces de descarga tienen el formato {base pública}/openapi/files/{kind}/{ref}?token=… (kind es xml o dace); el token lleva la credencial, así que no hacen falta cabeceras de firma, la validez viene de la configuración del inquilino (por defecto 7 días) y los enlaces se vuelven a firmar en cada consulta. Vea Descarga de archivos.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa emisora
`dceId*`	string	Identificador del documento

* Campo obligatorio

200

Documento encontrado. Los campos de hecho del documento (numero, chaveAcesso, protocolo, enlaces) se van rellenando conforme avanza el estado.

`id`	string	Identificador de la solicitud
`ambiente`	string	Ambiente
`status`	string	Estado del documento
`motivoStatus`	string	Motivo del estado
`dataCriacao`	string	Momento de la aceptación
`dataUltimaAlteracao`	string	Última modificación
`numero`	int	Número del documento
`serie`	string	Serie
`dataEmissao`	string	Fecha de emisión
`chaveAcesso`	string	Clave de acceso
`dataAutorizacao`	string	Fecha de autorización
`linkDace`	string	Enlace del DACE
`linkDownloadXml`	string	Enlace del XML
	object	Protocolo de autorización
`emitidaEmContingencia`	bool	Emitida en contingencia
`remetente`	object	Remitente
`destinatario`	object	Destinatario
`itens`	array	Ítems declarados
`transporte`	object	Transporte
`autorizacaoDownloadXml`	array	Autorizados a descargar el XML
`informacoesAdicionais`	string	Observación del marketplace
`informacoesAdicionaisFisco`	string	Observación al fisco
`informacoesAdicionaisEmitente`	string	Observación del emisor
`observacoesMarketplace`	array	Observaciones del marketplace

`ambiente`Ambiente de emisión

Valores	Significado
Homologacao	Ambiente de prueba de la SEFAZ; el documento no tiene validez
Producao	Ambiente oficial

`status`Estado del documento

El webhook tiene además CancelamentoNegado: la SEFAZ rechazó la cancelación y el documento volvió a Autorizada; la consulta devuelve Autorizada con el motivo en motivoStatus, y puede enviarse de nuevo una cancelación corregida.

Valores	Significado
Pendente	Aceptado, en cola o en envío; `numero` y `chaveAcesso` aparecen tras la numeración
Autorizada	Autorizado por la SEFAZ; `linkDownloadXml`, `linkDace` y `protocolo` disponibles; si la última cancelación fue rechazada, `motivoStatus` trae el motivo
Negada	Rechazado por la SEFAZ; `motivoStatus` es el código y la descripción del rechazo
CancelamentoPendente	Cancelación aceptada, esperando el veredicto de la SEFAZ
Cancelada	Cancelado; `linkDace` apunta a la versión con la marca de agua `CANCELADA`
Falha	Fallo terminal de la tarea (parámetros no interpretables, reintentos agotados); `motivoStatus` lo explica; el mismo `id` puede reenviarse

Código	HTTP
10019002	404	`dceId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10019003	404	`dceId` no encontrado o no pertenece a la empresa. Verifique el id y el `empresaId`.
10003000	404	`empresaId` no 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 ruta

Respuestas

Enumeraciones2 tablas

ambienteAmbiente de emisión

statusEstado del documento

Errores3 ítems

`ambiente`Ambiente de emisión

`status`Estado del documento