# 获取纠纷单

接口应在服务器端调用，不可在前端（小程序、网页、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	object	纠纷历史	-
status	number	纠纷单状态	枚举值
virtual_tel_num_info	object	虚拟号码	-

# Res.history `Object Payload`

纠纷历史

参数名	类型	说明	枚举
item_type	number	历史操作类型	枚举值
time	number	操作时间，Unix时间戳，即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数	-
phone_number	number	用户联系电话	-
content	string	相关文本内容	-
media_id_list	array	相关图片media_id列表	-
after_sale_type	number	售后类型, 1-仅退款；2-退货退款	-
after_sale_reason	number	售后原因，获取全量售后原因	-

# Res.virtual_tel_num_info `Object Payload`

虚拟号码

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

# 4. 枚举信息

# Res.status `Enum`

纠纷单状态

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

# Res.history.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	双方补充材料超时

# 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,
            "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
        }
    ]
}

# 7. 错误码

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

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

# 8. 适用范围

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

# 获取纠纷单

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.history Object Payload

# Res.virtual_tel_num_info Object Payload

# 4. 枚举信息

# Res.status Enum

# Res.history.item_type Enum

# 5. 注意事项

# 6. 代码示例

# 7. 错误码

# 8. 适用范围

# 查询参数 `Query String parameters`

# 请求体 `Request Payload`

# 返回体 `Response Payload`

# Res.history `Object Payload`

# Res.virtual_tel_num_info `Object Payload`

# Res.status `Enum`

# Res.history.item_type `Enum`