错误码
HTTP 200 且 errCode = 0 表示业务成功。下表 errCode 来自 Go Error.go(与响应 JSON 中 errCode 一致)。
重试:仅 920xxx 及 720404(token 过期) 等明确可恢复场景建议重试;其余码请修正入参或业务状态后再调。详见 出站重试规则。
801034 = 没有延保险商品,无需投保。801035「延保险暂不支持退保」为未使用常量。现行口径是邮包险和延保险都仅支持发货前退保,统一走 CancelServiceOrder;发货后如有特殊需求,请联系产品和业务人员。
Token 与鉴权(720xxx)
Section titled “Token 与鉴权(720xxx)”| 错误码 | 说明 | 可重试 | 常见相关接口 |
|---|---|---|---|
| 720401 | 获取 token 失败 | 视情况 | 申请令牌 |
| 720402 | 校验 token 失败 | 否 | 需 Bearer 的出站接口 |
| 720404 | token 已过期 | 是 | 重新 申请令牌 |
| 720405 | 刷新 token 失败 | 视情况 | 申请令牌 |
| 720406 | 生成 appSecret 失败(服务端历史消息原文为「生成appSecrect失败」) | 否 | 申请令牌 |
| 720407 | appId 参数错误 / 生成 app 失败 | 否 | 申请令牌 |
| 720408 | app 信息未查得 | 否 | 申请令牌、检查 AppAuth |
业务错误(801xxx)
Section titled “业务错误(801xxx)”| 错误码 | 说明 | 可重试 | 常见相关接口 |
|---|---|---|---|
| 801001 | 币种错误 | 否 | 试算、同步订单、退保等含 currency 的请求 |
| 801002 | 不支持的独立站平台 | 否 | 同步平台订单 |
| 801003 | 数据比较不一致 | 否 | 同步类接口 |
| 801004 | ID 不一致 | 否 | 同步类、退保 |
| 801005 | 发货数据已存在,不能再退保(仅未同步发货的订单可退保) | 否 | 取消投保(服务单号) |
| 801011 | 试算记录不存在 | 否 | 同步平台订单(引用试算) |
| 801012 | 试算归属错误 | 否 | 同步平台订单 |
| 801013 | 试算错误 | 否 | 购物车试算 |
| 801014 | 金额转数字出错 | 否 | 含金额字段的试算 / 同步 / 退保 |
| 801015 | 已投保,无需再次执行投保 | 否 | 同步平台订单 |
| 801016 | 已退保,不能再次投保 | 否 | 同步平台订单 |
| 801017 | 已支付成功,无需再次执行支付 | 否 | 同步平台订单 |
| 801018 | 退费失败,退保失败 | 视情况 | 取消投保 |
| 801021 | 风控记录不存在 | 否 | 试算、同步订单 |
| 801022 | 没有邮包险商品,无需投保 | 否 | 同步平台订单 |
| 801023 | 没有货运信息 | 否 | 同步发货、理赔 |
| 801024 | 货运已同步但订单未支付,支付后自动待承保 | 否 | 同步发货 |
| 801025 | 无需执行投保动作 | 否 | 同步平台订单 |
| 801026 | 计算费率为空,无法完成试算 | 否 | 购物车试算 |
| 801027 | 邮包险价格超过最大保额,暂时无法投保 | 否 | 试算、同步订单 |
| 801028 | 邮包险价格小于等于最小保额,暂时无法投保 | 否 | 试算、同步订单 |
| 801029 | 邮包险保费为 0,可能无可投商品 | 否 | 试算、同步订单 |
| 801030 | shop auth not found | 否 | 鉴权相关出站接口 |
| 801031 | 邮包险服务开关获取失败 | 视情况 | 试算 |
| 801032 | 邮包险服务没有开启 | 否 | 试算、同步订单 |
| 801033 | 邮包险:订单创建时间在安装时间之前 | 否 | 同步平台订单 |
| 801034 | 没有延保险商品,无需投保 | 否 | 同步平台订单 |
| 801035 | 延保险暂不支持退保 | — | 未使用常量,现网不应返回 |
| 801036 | 退费单已存在 | 否 | 取消投保 |
可重试错误(920xxx)
Section titled “可重试错误(920xxx)”下列码表示临时故障或并发冲突,建议按指数退避重试(仍须 HTTP 200 且检查 errCode):
| 错误码 | 说明 | 可重试 | 常见相关接口 |
|---|---|---|---|
| 920000 | 网络连接超时 | 是 | 通用出站 |
| 920001 | 连接被拒绝 | 是 | 通用出站 |
| 920002 | 连接被重置 | 是 | 通用出站 |
| 920003 | 连接中断 | 是 | 通用出站 |
| 920004 | DNS 解析失败 | 是 | 通用出站 |
| 920005 | TLS 握手失败 | 是 | 通用出站 |
| 920020 | 服务繁忙 | 是 | 通用出站 |
| 920021 | 请求频率超限 | 是(降速) | 通用出站 |
| 920022 | 资源暂时耗尽 | 是 | 通用出站 |
| 920023 | 服务器内部错误 | 是 | 通用出站 |
| 920024 | 服务暂时不可用 | 是 | 通用出站 |
| 920025 | 网关超时 | 是 | 通用出站 |
| 920026 | 系统维护中 | 是 | 通用出站 |
| 920040 | 数据已被修改(乐观锁) | 是 | 通用出站 |
| 920041 | 资源被锁定 | 是 | 通用出站 |
| 920042 | 事务冲突 | 是 | 通用出站 |
| 920043 | 检测到死锁 | 是 | 通用出站 |
| 920060 | 数据库连接失败 | 是 | 通用出站 |
| 920061 | Redis 连接失败 | 是 | 通用出站 |
| 920062 | 消息队列连接失败 | 是 | 通用出站 |
| 920063 | 对象存储连接失败 | 是 | 通用出站 |
| 920064 | 第三方服务超时 | 是 | 通用出站 |
| 920065 | 第三方服务暂时错误 | 是 | 通用出站 |
| 920080 | 数据同步中 | 是 | 通用出站 |
| 920081 | 缓存数据过期 | 是 | 通用出站 |
| 920082 | 版本冲突 | 是 | 通用出站 |
延迟自动赔付错误码(预设计)
Section titled “延迟自动赔付错误码(预设计)”| 错误码 | 说明 | 可重试 | 常见相关接口 |
|---|---|---|---|
| 801046 | 该理赔单已确认发放,请勿重复回执 | 否 | 赔付发放结果回执 |
| 801047 | 理赔单当前状态不允许发放回执(非待发放状态) | 否 | 赔付发放结果回执 |
| 801048 | 发放指令回调地址未配置,无法选择积分/礼品卡赔付形式 | 否 | 赔付发放指令回调 |