CT-e
查询 CT-e
返回状态、票面、XML / DACTE 下载链接与事件列表。
GET
/openapi/v2/empresas/{empresaId}/cte/{cteId}需要
token、timestamp、sign 三个签名头，参见认证与签名。提交之后单据怎么样了，就靠这个接口跟踪。按开具时传入的 id 查询。下载链接是短时令牌，有效期 10 分钟，每次查询重新签发。
路径参数
empresaId* | string | 主体标识 |
cteId* | string | 单据标识 |
* 必填字段
200
单据存在。
id | string | 单据标识 |
status | string | 单据状态 |
motivoStatus | string | 状态原因 |
numero | int | 单据号 |
serie | int | 号段系列 |
chaveAcesso | string | 访问密钥 |
numeroProtocolo | string | 授权回执号 |
dataEmissao | string | 开具时刻 |
dataAutorizacao | string | 授权时刻 |
tipoEmissao | string | 授权通道 |
protocoloEpec | string | EPEC 回执号 |
linkXml | string | 授权 XML 链接 |
linkDacte | string | DACTE 链接 |
cte | object | 原请求回显 |
| array | 事件列表 |
status单据状态
| 取值 | 含义 |
|---|---|
| Pendente | 已受理，排队或发送中 |
| Autorizada | 税务局已授权；linkXml 为法律原件，linkDacte 为 DACTE PDF |
| Negada | 税务局驳回；motivoStatus 给出状态码与原因 |
| Cancelada | 已通过事件 110111 取消 |
| Contingencia | 税务局不可用，单据待补送 |
| Falha | 任务终态失败；motivoStatus 给出原因，可用同 id 重新提交 |
tipoEmissao授权通道
本州授权方瘫痪时由平台自动切换通道。
| 取值 | 含义 |
|---|---|
| Normal | 本州正常授权方 |
| Epec | EPEC 应急事前授权 |
| Fsda | FS-DA 安全纸应急 |
| SvcRs | SVC-RS 应急，南里奥格兰德州虚拟授权方 |
| SvcSp | SVC-SP 应急，圣保罗州虚拟授权方 |
eventos[].tipo事件类型
| 取值 | 含义 |
|---|---|
| Cancelamento | 取消 CT-e，代码 110111 |
| CartaCorrecao | 信函更正，代码 110110 |
| Epec | EPEC 应急事前授权，由平台登记，代码 110113 |
| ComprovanteEntrega | 交付凭证，代码 110180 |
| CancelamentoComprovanteEntrega | 撤销交付凭证，代码 110181 |
| InsucessoEntrega | 交付失败，代码 110190 |
| CancelamentoInsucessoEntrega | 撤销交付失败，代码 110191 |
| PrestacaoDesacordo | 服务不符，代码 610110 |
| CancelamentoPrestacaoDesacordo | 撤销服务不符，代码 610111 |
eventos[].codigo事件代码
| 取值 | 含义 |
|---|---|
| 110111 | 取消 CT-e，即 Cancelamento |
| 110110 | 信函更正，即 CartaCorrecao |
| 110113 | EPEC 应急事前授权，由平台登记，即 Epec |
| 110180 | 交付凭证，即 ComprovanteEntrega |
| 110181 | 撤销交付凭证，即 CancelamentoComprovanteEntrega |
| 110190 | 交付失败，即 InsucessoEntrega |
| 110191 | 撤销交付失败，即 CancelamentoInsucessoEntrega |
| 610110 | 服务不符，即 PrestacaoDesacordo |
| 610111 | 撤销服务不符，即 CancelamentoPrestacaoDesacordo |
eventos[].status登记状态码
平台只在这些状态码下返回 200；税务局其他返回一律转为 10017043。
| 取值 | 含义 |
|---|---|
| 134 | 已登记，税务局视为成功 |
| 135 | 已登记并挂到单据 |
| 136 | 已登记但未挂到单据 |
| 错误码 | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId 不存在或非本主体。核对 id 与 empresaId。 |
| 10003000 | 404 | empresaId 不存在。 |