CT-e
查询 CT-e
返回状态、票面、XML / DACTE 下载链接与事件列表。
GET
/openapi/v2/empresas/{empresaId}/cte/{cteId}需要 token、timestamp、sign 三个签名头，参见认证与签名。
按发行时传入的 id 查询。下载链接为 10 分钟短时令牌，每次查询重新签发。未知 cteId 返回 HTTP 404，codigo 为 CTe0001。
参数
路径参数
empresaIdstring必填注册时返回的主体（承运人）标识。
示例:1934811222334455cteIdstring必填发行 CT-e 时传入的
id。示例:CTE-ORD-1
响应
200
单据存在。
idstring集成商单据 id。
statusstring单据状态；见下方状态表。
取值:PendenteAutorizadaNegadaCanceladaContingenciaFalhamotivoStatusstring状态说明：
Negada时为cStat - xMotivo，Falha时为本地原因；其余为null。numerointegerCT-e 号码。
serieintegerCT-e 系列。
chaveAcessostring44 位访问密钥。
numeroProtocolostringSEFAZ 授权协议号。
dataEmissaostring开具时间，ISO-8601 UTC。
dataAutorizacaostring授权时间，ISO-8601 UTC。
tipoEmissaostring发行类型；平台切换应急（SVC / EPEC）时在此体现。
取值:NormalEpecFsdaSvcRsSvcSpprotocoloEpecstringEPEC 应急发行时的 EPEC 协议号；否则为
null。linkXmlstring授权 XML（cteProc），法律原件。参见 文件下载。
linkDactestringDACTE PDF，首次下载触发渲染；渲染繁忙回 503，稍后重试。
cteobject任务未终态时原样回显发行请求体；任务终态（
Autorizada/Negada/Falha）后受理参数已清空，此字段为null。eventosarray单据已登记事件（形状同事件列表，不含
chaveAcesso）。
错误
| 错误码 | HTTP | |
|---|---|---|
| CTe0001 | 404 |
|
| 10003000 | 404 |
|
状态表
status | 含义 |
|---|---|
Pendente | 已受理、排队或发送中 |
Autorizada | SEFAZ 授权（cStat 100）；linkXml 为 cteProc 法律原件，linkDacte 为 DACTE PDF |
Negada | SEFAZ 驳回；motivoStatus 为 cStat - xMotivo |
Cancelada | 已取消（110111） |
Contingencia | SEFAZ 瘫痪，单据待补送 |
Falha | 任务终态失败（参数无法解析、重投超限等），motivoStatus 给原因；可用同 id 重新提交 |