CT-e
交付失败
对已授权 CT-e 登记事件 110190，即交付失败。
POST
/openapi/v2/empresas/{empresaId}/cte/{cteId}/insucesso-entrega需要
token、timestamp、sign 三个签名头，参见认证与签名。交付失败是承运人向税务局登记「去送了但没送成」的事件，要说明什么时候去送的、为什么没送成。同步出站，成功返回事件对象。请保存响应中的 protocolo：它就是撤销交付失败使用的 protocoloEvento。
路径参数
empresaId* | string | 主体标识 |
cteId* | string | 单据标识 |
* 必填字段
请求体
dataTentativa* | string | 尝试时刻 |
numeroTentativa | int | 尝试次数 |
motivo* | int | 失败原因 |
justificativa*`motivo=4` 时必填 | string | 失败说明 |
latitude | number | 尝试地纬度 |
longitude | number | 尝试地经度 |
hashTentativa | string | 尝试影像指纹 |
dataHashTentativa | string | 影像生成时刻 |
chavesNfe | array | 涉及发票密钥 |
* 必填字段
200
事件已在 SEFAZ 登记，同步返回事件对象。
chaveAcesso | string | 访问密钥 |
tipo | string | 事件类型 |
codigo | string | 事件代码 |
sequencia | int | 事件序号 |
status | string | 登记状态码 |
motivo | string | 状态说明 |
protocolo | string | 事件回执号 |
data | string | 登记时刻 |
linkXml | string | 事件 XML 链接 |
平台在量长度之前会先清洗文本字段：去掉变音符号，把连续空白折叠成一个。清洗发生在长度校验之前；清洗后长度超出范围返回 10017042。
motivo失败原因
| 取值 | 含义 |
|---|---|
| 1 | 收货人不在，无人接收 |
| 2 | 收货人拒收 |
| 3 | 地址不符 |
| 4 | 其他原因，须传 justificativa |
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 带上它的状态码与原因。 |
| 10001001 | 400 | 请求字段校验失败，每字段一条；按 mensagem 修正。 |