TF Fiscal
开发文档

CT-e

交付凭证

对已授权 CT-e 登记事件 110180(交付凭证)。

POST/openapi/v2/empresas/{empresaId}/cte/{cteId}/comprovante-entrega

需要 tokentimestampsign 三个签名头,参见认证与签名

同步出站,成功返回事件对象。请保存响应中的 protocolo:它就是撤销交付凭证使用的 protocoloEvento

参数

路径参数

  • empresaIdstring必填

    注册时返回的主体(承运人)标识。

    示例: 1934811222334455
  • cteIdstring必填

    发行 CT-e 时传入的 id

    示例: CTE-ORD-1

请求体

  • dataEntregastring必填

    交付时刻,ISO-8601 带偏移,如 2026-09-06T10:00:00-03:00

    示例: 2026-09-06T10:00:00-03:00
  • documentoRecebedorstring必填

    签收人证件号(nDoc),2 到 20 位数字。

    示例: 12345678909
  • nomeRecebedorstring必填

    签收人姓名(xNome),2 到 60 字符。

    示例: JOSE DA SILVA
  • latitudenumber可选

    交付地纬度(可选),按六位小数登记。

  • longitudenumber可选

    交付地经度(可选),按六位小数登记。

  • hashEntregastring必填

    交付凭证影像 SHA-1 的 base64(hashEntrega)。

    示例: 2jmj7l5rSw0yVb/vlWAYkK/YBwk=
  • dataHashEntregastring必填

    影像生成时刻,ISO-8601 带偏移。

    示例: 2026-09-06T10:01:00-03:00
  • chavesNfearray可选

    已交付的 NF-e chave(44 位字符串),可选。

响应

200

事件已在 SEFAZ 登记,同步返回事件对象。

  • chaveAcessostring

    事件所关联 CT-e 的 44 位访问密钥。

  • tipostring

    事件类型。

    取值:CancelamentoCartaCorrecaoComprovanteEntregaCancelamentoComprovanteEntregaInsucessoEntregaCancelamentoInsucessoEntregaPrestacaoDesacordoCancelamentoPrestacaoDesacordoEpec
  • codigostring

    SEFAZ 事件码(tpEvento):110111110110110113110180110181110190110191610110610111

  • sequenciainteger

    同类事件内的序号(信函更正自动递增)。

  • statusstring

    SEFAZ 返回的 cStat;135 表示事件已登记并关联。

  • motivostring

    SEFAZ 返回的 xMotivo。

  • protocolostring

    事件协议号;撤销事件时作为 protocoloEvento 传入。

  • datastring

    事件登记时间,ISO-8601 UTC。

  • linkXmlstring

    事件 XML(procEvento)下载链接。参见 文件下载

错误

错误码HTTP
CTe0001404

cteId 不存在或非本主体。核对 id 与 empresaId

10003000404

empresaId 不存在。

10017040400

单据状态不允许该事件;CT-e 须为 Autorizada

10017042400

事件文本非法(净化后长度超出范围)。

10017043400

SEFAZ 拒绝了该事件;mensagem 带 cStat 与原因。

10001001400

请求字段校验失败(每字段一条);按 mensagem 修正。

文本净化与坐标

文本字段会先被净化(去变音、折叠空白),校验长度;净化后长度超出范围返回 10017042。坐标按六位小数登记。