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 应急,圣保罗州虚拟授权方 |
cte.ambienteEmissao开票环境
| 取值 | 含义 |
|---|---|
| Homologacao | 税务局测试环境,单据无法律效力 |
| Producao | 正式环境 |
cte.tipo单据类型
| 取值 | 含义 |
|---|---|
| Normal | 普通开具 |
| Complementar | 补充票,给已授权 CT-e 补金额;须传 ctesComplementados,不传 documentos |
| Substituto | 替代票,顶替并订正此前的 CT-e;须传 cteSubstituido |
cte.tipoServico服务类型
| 取值 | 含义 |
|---|---|
| Normal | 直接承接的运输 |
| Subcontratacao | 被另一家承运人整段分包;须传 documentosAnteriores |
| Redespacho | 从另一家承运人接货跑完后半程;须传 documentosAnteriores |
| RedespachoIntermediario | 只跑中间一段;须传 documentosAnteriores |
| VinculadoMultimodal | 挂靠多式联运经营人 |
cte.modal运输模态
一期只受理 Rodoviario;其余取值可识别但返回 10017018。
| 取值 | 含义 |
|---|---|
| Rodoviario | 公路运输 |
| Aereo | 航空运输,暂不支持 |
| Aquaviario | 水路运输,暂不支持 |
| Ferroviario | 铁路运输,暂不支持 |
| Dutoviario | 管道运输,暂不支持 |
| Multimodal | 多式联运,暂不支持 |
cte.tomador运费承担方
| 取值 | 含义 |
|---|---|
| Remetente | 发货人,须传 remetente |
| Expedidor | 发运方,转运时把货交给本承运人的一方,须传 expedidor |
| Recebedor | 接收方,从本承运人接货继续运的一方,须传 recebedor |
| Destinatario | 收货人,须传 destinatario |
| Outros | 四方之外的其他人,须传 tomadorOutros |
cte.indicadorIeTomador承担方纳税身份
| 取值 | 含义 |
|---|---|
| Contribuinte | ICMS 纳税人,承担方须带数字 inscricaoEstadual |
| Isento | 免登记 |
| NaoContribuinte | 非纳税人,如最终消费者;跨州时须传 impostos.icmsUfFim |
cte.carga.quantidades[].unidade货物计量单位
| 取值 | 含义 |
|---|---|
| M3 | 立方米 |
| Kg | 千克 |
| Ton | 吨 |
| Unidade | 件 |
| Litros | 升 |
| MMBTU | 百万英热,燃气计量用的能量单位 |
cte.documentos.nf[].modelo纸质发票模型
平台只校验 2 位数字;其他取值过不了发往 SEFAZ 前的报文格式校验。
| 取值 | 含义 |
|---|---|
| 01 | 模型 1 或 1A 发票,含税务机关代开的 |
| 04 | 农户发票 |
cte.documentos.outros[].tipo其他单据类型
| 取值 | 含义 |
|---|---|
| Declaracao | 内容声明 |
| Dutoviario | 管道运输单据 |
| CfeSat | SAT 设备开具的电子税务小票 |
| Nfce | 消费者电子发票 |
| Outros | 其他单据,须传 descricao |
cte.documentosAnteriores[].uf前序承运人所在州
同样适用于 cte.rodoviario.ordensColeta[].emitente.uf。平台只校验 2 位字母;不在表内的代码过不了报文格式校验。
| 取值 | 含义 |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
| EX | 境外,用于涉外运输 |
cte.documentosAnteriores[].papeis[].tipo前序纸质单据类型
平台只校验 2 位数字;不在表内的代码过不了发往 SEFAZ 前的报文格式校验。
| 取值 | 含义 |
|---|---|
| 07 | ATRE |
| 08 | DTA 海关转运申报 |
| 09 | 国际航空运单 |
| 10 | 国际公路托运单 |
| 11 | 零散运单 |
| 12 | TIF 国际铁路运单 |
| 13 | BL 海运提单 |
cte.impostos.icms.situacaoTributariaICMS 税务处理代码
Simples Nacional 主体只能传 SN;一般税制不得传 SN(10017022)。
| 取值 | 含义 |
|---|---|
| 00 | 全额计税 |
| 20 | 减计税基后计税,须传 percentualReducaoBase |
| 40 | 免税 |
| 41 | 不计税 |
| 51 | 递延到后续环节 |
| 60 | 税款此前已代扣,须传 stRetido |
| 90 | 其他情形 |
| 90-OutraUF | 税款归属另一个州,可传 outraUf |
| SN | Simples Nacional 主体,不传 baseCalculo 与 valor |
cte.entrega.tipoData交付日期约定方式
不传即 SemData。
| 取值 | 含义 |
|---|---|
| SemData | 未约定日期 |
| NaData | 指定某一天,须传 data |
| AteData | 不晚于某天,须传 data |
| APartirDe | 从某天起,须传 data |
| NoPeriodo | 在某段区间内,须传 dataInicial 与 dataFinal |
cte.entrega.tipoHora交付时刻约定方式
不传即 SemHora。
| 取值 | 含义 |
|---|---|
| SemHora | 未约定时刻 |
| NaHora | 指定某时刻,须传 hora |
| AteHora | 不晚于某时刻,须传 hora |
| APartirDe | 从某时刻起,须传 hora |
| NoIntervalo | 在某时间段内,须传 horaInicial 与 horaFinal |
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 不存在。 |
