# 查询投诉单详情

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstring接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
complaintOrderIdstring订单id

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
complaintOrderobjectcomplaintOrder
itemobject投诉进度
returnBillobjectreturnBill

# Res.complaintOrder Object Payload

complaintOrder

参数名类型示例说明枚举
complaintOrderIdstring-订单id-
openidstring用户的openid-
createTimenumber投诉发起时间-
phoneNumbernumber联系方式-
typenumber投诉问题分类枚举值
statusnumber101投诉单状态枚举值
customerMaterialobject投诉信息-
orderIdstring微信支付订单号-
outTradeNostring商家订单号-
productNamestring商品名称-
payTimenumber支付时间-
totalCoststring交易金额-
expireTimenumber-投诉单当前状态到期时间,0为不存在-
headImgUrlstring-头像URL-
nickNamestring-微信昵称-
appealStatenumber-申诉状态枚举值

# Res.item Object Payload

投诉进度

参数名类型说明枚举
itemTypenumber投诉节点状态枚举值
timenumber时间-
contentstring内容文本-
mediaIdListarray图片cdn资源列表-
phoneNumbernumber手机号-
blameResultnumberitemType 为(31, 32)时,判断是否经过退货的描述, 1对应文案为待用户退货中,0则对应文案为待上传处理凭证-
nickNamestring操作者昵称-
appealItemTypenumber处于申诉阶段节点的申诉状态枚举值

# Res.returnBill Object Payload

returnBill

参数名类型说明枚举
returnIdstring退货id-
waybillIdstring运单号-
deliveryNamestring运力公司-
orderStatusnumber运单状态枚举值

# Res.complaintOrder.customerMaterial Object Payload

投诉信息

参数名类型说明
contentstring投诉内容
mediaIdListarray投诉内容图片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 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试

# 8. 适用范围

本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。