TF Fiscal
开发文档

CT-e

开具 CT-e

受理一张模型 57、公路模态的 CT-e，异步向 SEFAZ 授权。

POST/openapi/v2/empresas/{empresaId}/cte
需要 token、timestamp、sign 三个签名头，参见认证与签名。

CT-e 是为一次货运服务开具的电子税务单据。受理成功返回 HTTP 200 无内容。同一 id 重复提交：报文指纹相同复用原任务（幂等），指纹不同返回 10017030，上一次以失败告终则按新报文重开。结果经查询或 Webhook 获知。枚举字符串大小写不敏感。

路径参数

empresaId*
string主体标识

* 必填字段

请求体

id*
string请求标识
ambienteEmissao*
string开票环境
natureza*
string业务性质描述
cfop*
stringCFOP 代码
tipo*
string单据类型
tipoServico*
string服务类型
modal*
string运输模态
tomador*
string运费承担方
indicadorIeTomador*
string承担方纳税身份
retiraMercadoria
bool是否自提
detalheRetira
string自提说明
object开单市政
*
object起运市政
*
object目的市政
*
`remetente` 与 `destinatario` 至少一方
object发货人
*
`remetente` 与 `destinatario` 至少一方
object收货人
object发运方
object接收方
*
`tomador=Outros` 时必填
object其他承担方
*
object货物信息
*
除 `tipo=Complementar` 外必填
object随货单据
*
分包 / 转运 / 中转转运时必填
array前序运输单据
*
object公路模态信息
*
object运费
*
object税参
object账单分期
*
`tipo=Substituto` 时必填
object被替代 CT-e
ctesComplementados*
`tipo=Complementar` 时必填
array被补充单据密钥
object附加特征
object计划路线
object交付期限
observacoes
string备注
array开票方备注
array给税务机关的备注
autorizadosXml
arrayXML 下载授权方

* 必填字段

200
已受理。无响应体；授权异步进行。

无响应体

最常见的情形：承运人在同一州内运送随 NF-e 的货物，卖方付运费。下面的字段树只列要填的字段，没列出来的都不用传。

完整请求

json
{
  "id": "CTE-ORD-1",
  "ambienteEmissao": "Homologacao",
  "natureza": "PRESTACAO DE SERVICO DE TRANSPORTE",
  "cfop": "5353",
  "tipo": "Normal",
  "tipoServico": "Normal",
  "modal": "Rodoviario",
  "tomador": "Remetente",
  "indicadorIeTomador": "Contribuinte",
  "origem": { "codigoIbge": 3550308 },
  "destino": { "codigoIbge": 3550308 },
  "remetente": {
    "cpfCnpj": "66500544000120", "inscricaoEstadual": "123456789012", "nome": "REMETENTE TESTE LTDA",
    "endereco": { "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA", "codigoIbge": 3550308, "cep": "01310100" }
  },
  "destinatario": {
    "cpfCnpj": "12345678909", "nome": "DESTINATARIO TESTE",
    "endereco": { "logradouro": "RUA AUGUSTA", "numero": "10", "bairro": "CONSOLACAO", "codigoIbge": 3550308, "cep": "01305000" }
  },
  "carga": { "valor": 500.00, "produtoPredominante": "MERCADORIA DIVERSA",
             "quantidades": [{ "unidade": "Kg", "tipoMedida": "PESO BRUTO", "quantidade": 10 }] },
  "documentos": { "nfe": [{ "chave": "35260966500544000120550010000001231000000002" }] },
  "rodoviario": { "rntrc": "12345678" },
  "valorPrestacao": { "total": 100.00, "aReceber": 100.00, "componentes": [{ "nome": "FRETE PESO", "valor": 100.00 }] },
  "impostos": { "icms": { "situacaoTributaria": "00" } }
}
id*
string请求标识
ambienteEmissao*
string开票环境
natureza*
string业务性质描述
cfop*
stringCFOP 代码
tipo*
string单据类型
tipoServico*
string服务类型
modal*
string运输模态
tomador*
string运费承担方
indicadorIeTomador*
string承担方纳税身份
*
object起运市政
*
object目的市政
*
object发货人
*
object收货人
*
object货物信息
*
object随货单据
*
object公路模态信息
*
object运费
*
object税参

* 必填字段

上一页CT-e下一页查询 CT-e