CT-e
信函更正
对已授权 CT-e 登记事件 110110，即信函更正。
POST
/openapi/v2/empresas/{empresaId}/cte/{cteId}/carta-correcao需要
token、timestamp、sign 三个签名头，参见认证与签名。信函更正用来订正已授权 CT-e 上的次要信息，既不作废原单也不用另开一张；它不能改动会影响税额的金额、参与方或日期。同步出站，成功返回事件对象。须在授权后 720 小时内（10017049）；序号自增，上限 20 条（10017044）。登记信函更正后该单据不可再取消（取消时返回 10017048）。
路径参数
empresaId* | string | 主体标识 |
cteId* | string | 单据标识 |
* 必填字段
请求体
* | array | 更正项 |
* 必填字段
200
事件已在 SEFAZ 登记，同步返回事件对象。
chaveAcesso | string | 访问密钥 |
tipo | string | 事件类型 |
codigo | string | 事件代码 |
sequencia | int | 事件序号 |
status | string | 登记状态码 |
motivo | string | 状态说明 |
protocolo | string | 事件回执号 |
data | string | 登记时刻 |
linkXml | string | 事件 XML 链接 |
平台在量长度之前会先清洗文本字段：去掉变音符号，把连续空白折叠成一个。清洗发生在长度校验之前；清洗后长度超出范围返回 10017042。
tipo事件类型
| 取值 | 含义 |
|---|---|
| Cancelamento | 取消 CT-e，代码 110111 |
| CartaCorrecao | 信函更正，代码 110110 |
| Epec | EPEC 应急事前授权，由平台登记，代码 110113 |
| ComprovanteEntrega | 交付凭证，代码 110180 |
| CancelamentoComprovanteEntrega | 撤销交付凭证，代码 110181 |
| InsucessoEntrega | 交付失败，代码 110190 |
| CancelamentoInsucessoEntrega | 撤销交付失败，代码 110191 |
| PrestacaoDesacordo | 服务不符，代码 610110 |
| CancelamentoPrestacaoDesacordo | 撤销服务不符，代码 610111 |
codigo事件代码
| 取值 | 含义 |
|---|---|
| 110111 | 取消 CT-e，即 Cancelamento |
| 110110 | 信函更正，即 CartaCorrecao |
| 110113 | EPEC 应急事前授权，由平台登记，即 Epec |
| 110180 | 交付凭证，即 ComprovanteEntrega |
| 110181 | 撤销交付凭证，即 CancelamentoComprovanteEntrega |
| 110190 | 交付失败，即 InsucessoEntrega |
| 110191 | 撤销交付失败，即 CancelamentoInsucessoEntrega |
| 610110 | 服务不符，即 PrestacaoDesacordo |
| 610111 | 撤销服务不符，即 CancelamentoPrestacaoDesacordo |
status登记状态码
平台只在这些状态码下返回 200；税务局其他返回一律转为 10017043。
| 取值 | 含义 |
|---|---|
| 134 | 已登记，税务局视为成功 |
| 135 | 已登记并挂到单据 |
| 136 | 已登记但未挂到单据 |
| 错误码 | HTTP | |
|---|---|---|
| 10017003 | 404 | cteId 不存在或非本主体。核对 id 与 empresaId。 |
| 10003000 | 404 | empresaId 不存在。 |
| 10017004 | 400 | 主体当前不可开具：已停用或证书不可用。登记事件同样要用证书；请重新启用主体或关联可用证书。 |
| 10017040 | 400 | 单据状态不允许该事件；CT-e 须为 Autorizada。 |
| 10017042 | 400 | 事件文本非法：净化后长度超出范围。 |
| 10017043 | 400 | SEFAZ 拒绝了该事件；mensagem 带上它的状态码与原因。 |
| 10017044 | 400 | 信函更正序号超限：每单 20 条。 |
| 10017049 | 400 | 信函更正超出授权后 720 小时窗口。 |
| 10001001 | 400 | 请求字段校验失败，每字段一条；按 mensagem 修正。 |