TF Fiscal
开发文档

NF-e

作废 NF-e

在授权后 24 小时内作废已授权的发票。

DELETE/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}

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

对已授权票发起作废,成功 HTTP 200 无响应体查询接口随后返回 Cancelada。鉴权错误(10009xxx)见认证

参数

路径参数

  • empresaIdstring必填

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

    示例: 1934811222334455
  • nfeIdstring必填

    开票时传入的 id

    示例: NFe-000014553

响应

200

作废已在 SEFAZ 登记,无响应体。

无响应体

错误

错误码HTTP
NFe0001404

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

10003000404

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

10004012400

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

10004013400

超出 24 小时窗口。改开退货票。

10004014400

SEFAZ 拒绝作废(附返回码与原因)。按 SEFAZ 原因处理。

规则

  • Autorizada 状态可作废,其他状态返回 10004012
  • 授权后 24 小时内(个别州更宽,以平台配置为准),超窗返回 10004013,超窗只能改开退货票
  • SEFAZ 拒绝作废返回 10004014 并附 SEFAZ 返回码与原因。
  • 不存在的 nfeId 返回 HTTP 404 + NFe0001
  • 已登记的更正函在作废后仍可查询,见更正函列表