NF-e
登记更正函
对已授权票登记更正函(CC-e),同步返回协议号。
POST
/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcao需要
token、timestamp、sign 三个签名头,参见认证与签名。对已授权票登记更正函。登记是同步的:SEFAZ 登记成功才返回 HTTP 200,响应即结果,不依赖回调。鉴权错误(10009xxx)见认证。
路径参数
empresaId* | string | 开票主体标识 |
nfeId* | string | 发票标识 |
* 必填字段
请求体
correcao* | string | 更正正文 |
* 必填字段
200
事件已在 SEFAZ 登记。
chaveAcesso | string | 被更正票的访问密钥 |
tipo | string | 事件类型 |
codigo | string | 事件码 |
sequencia | int | 更正函序号 |
status | string | 登记状态 |
motivo | string | SEFAZ 应答 |
protocolo | string | 事件协议号 |
data | string | 登记时刻 |
correcao | string | 更正正文 |
linkXml | string | 回执 XML 下载链接 |
linkDacce | string | DACCE 下载链接 |
更正函只改文字。凡是会改税额的都不能用更正函:24 小时内取消重开,或开退货票。
可以更正
票面备注、操作性质文字、运输信息:承运人、车辆、包装、收货地址。
json
{ "correcao": "Correcao do transportador: item (2) sem alteracao de valor" }
correcao* | string | 更正正文 |
* 必填字段
不能更正
金额、数量、单价、税基、税额、收发方证件、日期。SEFAZ 会拒(10004016);走取消重开或退货票。
- 序号由平台分配;每封在 SEFAZ 侧覆盖上一封,同票最多 20 封(
10004015)。 - 窗口:授权后 720 小时内(
10004019)。 - 更正函没有回调;以同步响应或更正函列表为准。
tipo事件类型
| 取值 | 含义 |
|---|---|
| CartaCorrecao | 更正函,对已授权票做不改税额的文字更正 |
status登记状态
| 取值 | 含义 |
|---|---|
| Registrada | 已在 SEFAZ 登记;唯一会返回的状态,被拒时直接报错 10004016 |
| 错误码 | HTTP | |
|---|---|---|
| 10004000 | 404 | nfeId 不存在。核对开票时传入的 id 与 empresaId。 |
| 10004001 | 404 | nfeId 不存在。核对开票时传入的 id 与 empresaId。 |
| 10003000 | 404 | empresaId 不存在或非本应用名下。 |
| 10004012 | 400 | 票不在 Autorizada 状态。先查询确认状态。 |
| 10004015 | 400 | 同票已达 20 封。不能再登记;取消重开或开退货票。 |
| 10004016 | 400 | SEFAZ 拒绝登记;消息里附返回码与原因。按原因处理。 |
| 10004017 | 400 | 净化后不足 15 字符。用不带重音的葡语重写。 |
| 10004019 | 400 | 超出授权后 720 小时窗口。取消重开或开退货票。 |
| 10001001 | 400 | 请求字段校验失败,每字段一条。按 mensagem 修正。 |
