# 查询投诉单详情
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getOrderDetail
该接口用于查询投诉单详情。
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxaapi/minishop/complaintOrderDetail?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:76
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| complaintOrderId | string | 是 | 订单id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| complaintOrder | object | complaintOrder |
| item | object | 投诉进度 |
| returnBill | object | returnBill |
# Res.complaintOrder Object Payload
complaintOrder
| 参数名 | 类型 | 示例 | 说明 | 枚举 |
|---|---|---|---|---|
| complaintOrderId | string | - | 订单id | - |
| openid | string | 用户的openid | - | |
| createTime | number | 投诉发起时间 | - | |
| phoneNumber | number | 联系方式 | - | |
| type | number | 投诉问题分类 | 枚举值 | |
| status | number | 101 | 投诉单状态 | 枚举值 |
| customerMaterial | object | 投诉信息 | - | |
| orderId | string | 微信支付订单号 | - | |
| outTradeNo | string | 商家订单号 | - | |
| productName | string | 商品名称 | - | |
| payTime | number | 支付时间 | - | |
| totalCost | string | 交易金额 | - | |
| expireTime | number | - | 投诉单当前状态到期时间,0为不存在 | - |
| headImgUrl | string | - | 头像URL | - |
| nickName | string | - | 微信昵称 | - |
| appealState | number | - | 申诉状态 | 枚举值 |
# Res.item Object Payload
投诉进度
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| itemType | number | 投诉节点状态 | 枚举值 |
| time | number | 时间 | - |
| content | string | 内容文本 | - |
| mediaIdList | array | 图片cdn资源列表 | - |
| phoneNumber | number | 手机号 | - |
| blameResult | number | itemType 为(31, 32)时,判断是否经过退货的描述, 1对应文案为待用户退货中,0则对应文案为待上传处理凭证 | - |
| nickName | string | 操作者昵称 | - |
| appealItemType | number | 处于申诉阶段节点的申诉状态 | 枚举值 |
# Res.returnBill Object Payload
returnBill
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| returnId | string | 退货id | - |
| waybillId | string | 运单号 | - |
| deliveryName | string | 运力公司 | - |
| orderStatus | number | 运单状态 | 枚举值 |
# Res.complaintOrder.customerMaterial Object Payload
投诉信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| content | string | 投诉内容 |
| mediaIdList | array | 投诉内容图片cdn(出于安全性考虑,目前该图片url有过期时间,如需查看图片,需每次重新调用该接口获取,防止图片过期导致无法查看) |
# 4. 枚举信息
# Res.complaintOrder.type Enum
投诉问题分类
| 枚举值 | 描述 |
|---|---|
| 611 | 发货问题-未按约定时间发货 |
| 612 | 发货问题-商家拒绝发货 |
| 613 | 发货问题-少发/错发 |
| 614 | 发货问题-物流信息长时间不更新 |
| 621 | 客服问题-客服不回复 |
| 622 | 客服问题-客服辱骂/骚扰/恐吓 |
| 631 | 承诺未履行-赠品承诺未履行 |
| 632 | 承诺未履行-物流承诺未履行 |
| 633 | 承诺未履行-其他 |
| 641 | 商品问题-描述不符 |
| 642 | 商品问题-商品破损 |
| 643 | 商品问题-其他 |
| 650 | 收费异常问题-车辆没电或故障 |
| 651 | 收费异常问题-关锁成功仍计费 |
| 652 | 收费异常问题-扣费金额不对 |
| 653 | 收费异常问题-规范停车仍扣调度费 |
| 654 | 收费异常问题-其他 |
| 655 | 骑行卡问题-已购买骑行卡,仍扣费 |
| 656 | 骑行卡问题-骑行卡退款 |
| 657 | 押金/余额退还问题-押金退还 |
| 658 | 押金/余额退还问题-余额退还 |
| 659 | 客服问题-客服不回复 |
| 660 | 收费异常问题-充电宝未弹出,已扣费 |
| 661 | 收费异常问题-充电宝无法正常使用 |
| 662 | 收费异常问题-已归还,仍计费 |
| 663 | 收费异常问题-不认可计费时长 |
| 664 | 收费异常问题-其他 |
| 665 | 押金退还问题-押金退还异常 |
| 666 | 其他问题-客服不回复 |
| 667 | 其他问题-归还点少无法归还 |
| 668 | 其他问题-误操作购买,需消费 |
| 670 | 欺诈问题-虚假广告 |
| 671 | 欺诈问题-剧集数量与承诺不符 |
| 672 | 欺诈问题-付款金额与页面不符 |
| 673 | 欺诈问题-剧集内容与宣传不符 |
| 674 | 欺诈问题-营销活动问题 |
| 675 | 扣费问题-重复扣费 |
| 676 | 扣费问题-无理由扣费 |
| 677 | 扣费问题-扣费标准不一致 |
| 678 | 扣费问题-未成年误付款 |
| 679 | 其他问题 |
| 610001 | 可观看数量/时长与承诺不符 |
| 610002 | 剧集内容与宣传不符 |
| 610003 | 内容无法播放 |
| 610004 | 未成年人误付款 |
| 610005 | 其他 |
# Res.complaintOrder.status Enum
投诉单状态
| 枚举值 | 描述 |
|---|---|
| 101 | 平台客服处理中 |
| 102 | 用户取消申请 |
| 103 | 平台客服处理中 |
| 104 | 平台客服处理中 |
| 105 | 平台客服处理中 |
| 106 | 待商家补充凭证 |
| 107 | 平台客服处理中 |
| 108 | 待双方补充凭证 |
| 109 | 平台客服处理中 |
| 112 | 投诉已完结 |
| 115 | 投诉已完结 |
| 116 | 投诉已完结 |
| 201 | 待处理 |
| 202 | 商家超时未回应,待用户确认 |
| 203 | 已回应,待用户确认 |
| 204 | 已回应,待用户确认 |
| 205 | 投诉已完结 |
| 206 | 平台已判定为商责,待上传处理凭证 |
| 207 | 平台客服核实凭证中 |
| 208 | 超时未上传凭证 |
| 209 | 投诉已关闭 |
| 305 | 平台客服处理中 |
| 307 | 平台客服处理中 |
| 308 | 平台已判定为商责,待用户退货中 |
| 309 | 平台已判定为商责,待用户退货中 |
| 310 | 平台客服处理中 |
| 311 | 签收异常 |
| 312 | 平台判定商家责任,平台退款中 |
# Res.complaintOrder.appealState Enum
申诉状态
| 枚举值 | 描述 |
|---|---|
| 0 | 未进入申诉阶段 |
| 401 | 待商家申诉 |
| 402 | 超过申诉时间 |
| 403 | 申诉中 |
| 117 | 申诉成功 |
| 118 | 申诉失败 |
# Res.item.itemType Enum
投诉节点状态
| 枚举值 | 描述 |
|---|---|
| 1 | 用户发起投诉 |
| 2 | 用户补充留言 |
| 3 | 商家补充留言 |
| 7 | 用户补充凭证 |
| 8 | 商家补充凭证 |
| 11 | 用户申请平台客服协助 |
| 12 | 用户撤销投诉 |
| 13 | 平台客服处理中 |
| 14 | 待用户补充凭证 |
| 16 | 待商家补充凭证 |
| 18 | 平台要求双方补充凭证 |
| 26 | 平台核实处理凭证异常,投诉关闭,请商家自行联系用户解决问题,保障用户体验 |
| 30 | 平台已核实此投诉非商家责任,投诉已完结 |
| 31 | 平台已核实此投诉为商家责任,待上传处理凭证(blameResult为0)/平台已核实此投诉为商家责任,待用户退货中(blameResult为1) |
| 32 | 平台已核实此投诉为商家责任,待上传处理凭证(blameResult为0)/平台已核实此投诉为商家责任,待用户退货中(blameResult为1) |
| 33 | 平台已核实此投诉非商家责任,投诉已完结 |
| 36 | 平台已核实处理凭证,投诉完结 |
| 37 | 平台核实处理凭证异常,投诉关闭,请商家自行联系用户解决问题,保障用户体验 |
| 101 | 商家超时未回应投诉 |
| 104 | 用户认可处理结果,投诉已完结 |
| 107 | 商家超时未提交投诉处理凭证,平台客服处理中 |
| 108 | 用户超时未确认商家回应结果,投诉已完结 |
| 109 | 商家已回应投诉 |
| 110 | 商家提交投诉处理凭证 |
| 111 | 用户补充凭证超时 |
| 112 | 商家补充凭证超时 |
| 113 | 双方补充凭证超时 |
| 118 | 商责自动赔付 |
# Res.item.appealItemType Enum
处于申诉阶段节点的申诉状态
| 枚举值 | 描述 |
|---|---|
| 0 | 未进入申诉阶段 |
| 401 | 待商家申诉 |
| 402 | 超过申诉时间 |
| 403 | 申诉中 |
| 117 | 申诉成功 |
| 118 | 申诉失败 |
# Res.returnBill.orderStatus Enum
运单状态
| 枚举值 | 描述 |
|---|---|
| 0 | 已下单待揽件 |
| 1 | 已揽件 |
| 2 | 运输中 |
| 3 | 派件中 |
| 4 | 已签收 |
| 5 | 异常 |
| 6 | 代签收 |
| 7 | 揽收失败 |
| 8 | 签收失败 |
| 10 | 未下单 |
| 11 | 已取消 |
| 12 | 已删除 |
| 13 | 退件中 |
| 14 | 已退件 |
| 15 | 运力方取消 |
| 99 | 未确认状态 |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
请求示例
GET https://api.weixin.qq.com/wxaapi/minishop/complaintOrderDetail?access_token=ACCESS_TOKEN
返回示例
{
errcode: 0,
errmsg: "ok",
complaintOrder: {
complaintOrderId: 'sadfasdf',//订单id
openId: 'dfasefasefase', //openId
createTime: 123124124, //投诉发起时间
phoneNumber: 156222222, //联系方式
type: 12, //投诉问题分类
status: 101,//投诉单状态,枚举值
customerMaterial:{
content: '', //投诉内容
mediaIdList: ['fsadfasdfsaf'] //投诉内容图片cdn列表
},
orderId: '2342', //微信支付订单号
outTradeNo: 'sdfsfd', //商家订单号
productName: 'sdf', //商品名称
payTime: 123123', //支付时间
totalCost: 1213, //交易金额
expireTime: 1231231 //投诉单当前状态到期时间,0为不存在
},
// 投诉进度
item:[{
itemType: 1, //投诉节点状态
time: 1233234234, //时间
phoneNumber: 123123, //手机号
content: "", //内容
mediaIdList: ['asdfasdf'] //图片cdn列表
}],
returnBill: {
returnId: '23234234234', //退货id
waybillId: 'adfasdf', //运单号
orderStatus: 4 //运单状态
}
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙,此时请开发者稍候再试 |
# 8. 适用范围
本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。