# 获取纠纷单

接口应在服务器端调用，不可在前端（小程序、网页、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_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	说明
complaint_id	string	是	纠纷单号

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明	枚举
after_sale_order_id	string	售后单号	-
order_id	string	订单号	-
history	objarray	纠纷历史	-
status	number	纠纷单状态	枚举值
virtual_tel_num_info	object	虚拟号码	-

# Res.history(Array) `Object Payload`

纠纷历史

参数名	类型	说明	枚举
item_type	number	历史操作类型	枚举值
time	number	操作时间，Unix时间戳，即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数	-
content	string	相关文本内容	-
media_id_list	array	相关图片media_id列表（此字段为老字段，只存纯 media_id 字符串，不区分图片/视频，请优先使用 media_infos，信息更完整）	-
after_sale_type	number	售后类型, 1-仅退款；2-退货退款	-
after_sale_reason	number	售后原因，获取全量售后原因	-
media_infos	objarray	多媒体信息列表	-

# Res.virtual_tel_num_info `Object Payload`

虚拟号码

参数名	类型	说明
virtual_tel_number	string	快递单号
virtual_tel_expire_time	number	物流公司id

# Res.history(Array).media_infos`Object Payload`

多媒体信息列表

参数名	类型	说明
type	number	媒体类型，1-图片；2-视频
picture	object	图片信息，type为1时有值
video	object	视频信息，type为2时有值
video_play_length	number	视频时长（秒），仅type为2时有值

# Res.history(Array).media_infos.picture `Object Payload`

图片信息，type为1时有值

参数名	类型	说明
media_id	string	素材media_id
ticket_url	string	素材临时访问URL

# Res.history(Array).media_infos.video `Object Payload`

视频信息，type为2时有值

参数名	类型	说明
media_id	string	素材media_id
ticket_url	string	素材临时访问URL

# 4. 枚举信息

# Res.status `Enum`

纠纷单状态

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

# Res.history(Array).item_type `Enum`

历史操作类型

枚举值	描述
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	双方补充材料超时
120	待商家上传工单
121	商家已上传工单

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
    "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,
            "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,
            "content": "测试纠纷咯摸摸摸摸马6摸摸摸摸摸摸摸摸11",
            "media_id_list": [],
            "after_sale_type": 1,
            "after_sale_reason": 2
        }
    ]
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
10021500	投诉单号不存在

# 8. 适用范围

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

接口变更日志（5条）

2026 年 05 月 14 日

新增 media_infos 、 type 、 picture 、 video 、 video_play_length 、 media_id 、 ticket_url 等字段，更新 history 、 media_id_list 等字段描述

2026 年 05 月 06 日

item_type 字段新增「待商家上传工单」「商家已上传工单」等 2 个枚举值

2026 年 04 月 10 日

status 字段新增「待商家上传工单」枚举值，文档描述优化

2026 年 04 月 07 日

status 字段删除「待商家确认」枚举值

2026 年 01 月 20 日

phone_number 字段已删除，文档描述优化

# 获取纠纷单

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.history(Array) Object Payload

# Res.virtual_tel_num_info Object Payload

# Res.history(Array).media_infosObject Payload

# Res.history(Array).media_infos.picture Object Payload

# Res.history(Array).media_infos.video Object Payload