TF Fiscal
开发文档

NF-e

登记更正函

对已授权票登记更正函（CC-e），同步返回协议号。

POST/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcao

需要 token、timestamp、sign 三个签名头，参见认证与签名。

对已授权票登记更正函（事件 110110）。登记是同步的：SEFAZ 登记成功才返回 HTTP 200，响应即结果，不依赖回调。鉴权错误（10009xxx）见认证。

参数

路径参数

  • empresaIdstring必填

    注册主体返回的主体标识。

    示例: 1934811222334455
  • nfeIdstring必填

    开票时传入的 id。

    示例: NFe-000014553

请求体

  • correcaostring必填

    更正内容，净化后 15–1000 字符（去重音，保留可打印 ASCII；冒号、括号、百分号等标点保留）。只能更正不影响税额的信息（备注、操作性质文字、运输信息等）；金额 / 数量 / 单价 / 税基 / 税额、收发方证件、发票日期等一律走作废重开或退货票，SEFAZ 不做语义校验，责任在发行方。

    示例: Correcao do transportador: item (2) sem alteracao de valor

响应

200

事件已在 SEFAZ 登记。

  • chaveAcessostring

    被更正 NF-e 的访问密钥。

  • tipostring

    固定 CartaCorrecao。

  • codigostring

    固定 110110。

  • sequenciainteger

    本封序号 nSeq。

  • statusstring

    固定 Registrada。

  • motivostring

    SEFAZ 返回码与说明。

  • protocolostring

    事件协议号。

  • datastring

    SEFAZ 登记时刻，ISO-8601 UTC。

  • correcaostring

    净化后实际送 SEFAZ 的更正内容。

  • linkXmlstring

    事件回执 procEventoNFe XML 下载地址，见文件下载。

  • linkDaccestring

    DACCE 更正函凭证 PDF 下载地址（见文件下载）；渲染服务不可用时为空，可经列表接口重试。

错误

错误码HTTP
NFe0001404

nfeId 不存在。核对开票时传入的 id 与 empresaId。

10003000404

empresaId 不存在或非本应用名下。

10004012400

票不在已授权状态。查询确认状态。

10004015400

同票已达 20 封。不能再登记，需作废重开或退货票。

10004016400

SEFAZ 拒绝（附返回码与原因）。按 SEFAZ 原因处理。

10004017400

内容净化后不足 15 字符。用葡语 / ASCII 文本重写。

10004019400

超出授权后 720 小时窗口。只能作废重开或退货票。

10001001400

请求字段校验失败（每字段一条）。按 mensagem 修正。

规则

  • 仅 Autorizada 可登记（否则 10004012）。
  • 授权后 720 小时内（超窗 10004019）。
  • 同票最多 20 封（10004015），序号由平台分配，每封覆盖 SEFAZ 侧上一封的内容，历史全部保留。
  • 净化后不足 15 字符：10004017。
  • SEFAZ 拒绝：10004016，附返回码与原因。
  • 仍不推送 invoice.cce.registered 回调；以同步响应或更正函列表为准。
上一页作废 NF-e下一页更正函列表