# 获取纠纷单

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getcomplaintorder

商家通过该接口可以获取纠纷单详情

相关事件通知:纠纷单更新通知

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/aftersale/getcomplaintorder?access_token=ACCESS_TOKEN

# 云调用

  • 调用方法:channels.ec.aftersale.getcomplaintorder

  • 出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:131

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
complaint_idstring纠纷单号

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
after_sale_order_idstring售后单号
order_idstring订单号
historyobject纠纷历史
statusnumber纠纷单状态, 枚举值详情请参考下文
virtual_tel_num_infoobject虚拟号码

# Res.history Object Payload

纠纷历史

参数名类型说明
item_typenumber历史操作类型,枚举值详情请参考下文
timenumber操作时间,Unix时间戳,即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数
phone_numbernumber用户联系电话
contentstring相关文本内容
media_id_listarray相关图片media_id列表
after_sale_typenumber售后类型, 1-仅退款;2-退货退款
after_sale_reasonnumber售后原因,获取全量售后原因

# Res.virtual_tel_num_info Object Payload

虚拟号码

参数名类型说明
virtual_tel_numberstring快递单号
virtual_tel_expire_timenumber物流公司id

# 4. 注意事项

status纠纷单状态

枚举值 描述
100 待商家处理纠纷
101 待客服处理
102 取消客服介入
103 客服处理中
104 待用户补充凭证
105 用户已补充凭证
106 待商家补充凭证
107 商家已补充凭证
108 待双方补充凭证
109 双方补充凭证超时
110 待商家确认
111 商家申诉中
112 调解完成
113 待客服核实
114 重新退款中
115 退款核实完成
116 调解关闭
305 用户补充凭证超时
307 商家补充凭证超时

item_type历史操作类型

枚举值 描述
1 申请平台介入
2 用户留言
3 商家留言
4 提交投诉成功
5 投诉已取消
6 商家已超时
7 用户补充凭证
8 商家补充凭证
10 待商家处理纠纷
11 待平台处理
12 取消平台介入
13 平台处理中
14 待用户补充凭证
16 待商家补充凭证
18 待双方补充凭证
20 待商家确认
21 商家申诉中
22 调解完成
23 待平台核实
24 重新退款中
26 调解关闭
30 平台判定用户责任
31 平台判定商家责任
32 平台判定双方责任
33 平台判定无责任
34 平台判定申诉无效
35 平台判定申诉生效
36 平台判定退款有效
37 平台判定退款无效
50 用户发起退款
51 商家拒绝退款
52 用户取消申请
56 待买家退货
57 退货退款关闭
58 待商家收货
59 商家逾期未退款
60 退款完成
61 退货退款完成
62 平台退款中
63 平台退款失败
64 待用户确认
111 用户补充材料超时
112 商家补充材料超时
113 双方补充材料超时

# 5. 代码示例

请求示例

{
    "complaint_id": "123456"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "order_id": "3707636310244721920",
    "after_sale_order_id": "1410973765677533",
    "history": [
        {
            "item_type": 13,
            "time": 1669123317,
            "media_id_list": []
        },
        {
            "item_type": 3,
            "time": 1669123259,
            "content": "我来自api",
            "media_id_list": []
        },
        {
            "item_type": 3,
            "time": 1669123234,
            "content": "sd",
            "media_id_list": []
        },
        {
            "item_type": 11,
            "time": 1669121432,
            "media_id_list": []
        },
        {
            "item_type": 10,
            "time": 1669120412,
            "media_id_list": []
        },
        {
            "item_type": 1,
            "time": 1669120411,
            "phone_number": "18888888888",
            "content": "测试纠纷咯摸摸摸摸马6摸摸摸摸摸摸摸摸11",
            "media_id_list": [
                "DD1YmQ48b79lccW-hdHIVv52ttLjV9XQIDDL9K1XSXge0IU_r1WCq10JmqJCAG87cFh6ekc3tdToGPIumbYh-Q",
                "DD1YmQ48b79lccW-hdHIVrnHQ7eObW6t98fEER7KLr3eZpcmqYtZ_zrPF2J7QLlxffaGsosYEH-taT_Xkvc3rA"
            ],
            "after_sale_type": 1,
            "after_sale_reason": 2
        },
        {
            "item_type": 51,
            "time": 1669120388,
            "content": "纠纷测试",
            "media_id_list": []
        },
        {
            "item_type": 50,
            "time": 1669120322,
            "phone_number": "18888888888",
            "content": "测试纠纷咯摸摸摸摸马6摸摸摸摸摸摸摸摸11",
            "media_id_list": [],
            "after_sale_type": 1,
            "after_sale_reason": 2
        }
    ]
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
10021500投诉单号不存在

# 7. 适用范围

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