# 商家协商
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:merchantupdateaftersale
通过该接口可以在微信小店售后管理中进行商家协商操作
相关事件通知:售后单更新通知
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/aftersale/merchantupdateaftersale?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代微信小店商家调用。
该接口所属的权限集 id 为:131
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商) |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
after_sale_order_id | string | 是 | 售后单号 |
type | number | 是 | 协商修改把售后单修改成该售后类型。1:退款;2:退货退款 |
amount | number | 是 | 金额(单位:分) |
merchant_update_desc | string | 是 | 协商描述 |
update_reason_type | number | 是 | 协商原因,枚举值请参考下文 |
merchant_update_type | number | 是 | 1:已协商一致,邀请买家取消售后; 2:邀请买家核实与补充凭证; 3:修改买家售后申请 |
media_ids | array | 是 | 协商凭证id列表,可使用图片上传接口获取media_id(数据类型填0),当update_reason_type对应的need_image为1时必填 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 4. 注意事项
售后原因列表
参数 | 类型 | 描述 |
---|---|---|
update_reason_type | Number | 协商原因枚举 |
type | Number | 适用类型 1:退款;2:退货退款 |
merchant_update_type | Number | 适用协商类型 1:已协商一致,邀请买家取消售后; 2:邀请买家核实与补充凭证; 3:修改买家售后申请 |
need_image | Number | 1:需要图片凭证 0:不需要图片凭证 |
update_reason_desc | String | 协商说明 |
update_reason_type协商原因
update_reason_type | type | merchant_update_type | need_image | update_reason_desc |
---|---|---|---|---|
6 | 1 | 3 | 1 | 已协商一致新的售后方案(当售后类型选择仅退款时,若买家同意协商,平台将自动退款) |
7 | 1 | 2 | 1 | 无法联系或联系不上买家 |
8 | 2 | 3 | 0 | 生鲜、绿植等商品邀请买家仅退款无需退货(若买家同意协商或退款金额不变,平台将自动退款) |
9 | 1 | 1 | 1 | 已发货没有拦截成功 |
10 | 1 | 3 | 1 | 仅修改退款金额(若买家同意协商,平台将自动退款) |
11 | 2 | 3 | 1 | 已协商一致新的售后方案(售后类型选择仅退款时,若买家同意协商或退款金额不变,平台将自动退款) |
13 | 2 | 1 | 1 | 已发货没有拦截成功 |
14 | 2 | 3 | 1 | 仅修改退款金额,买家仍需寄回退货(若买家同意协商,将自动进入退货退款流程) |
21 | 2 | 3 | 1 | 修改退款金额(若买家同意协商,平台将自动退款) |
29 | 2 | 2 | 1 | 买家退货商品与订单商品不一致 |
30 | 2 | 2 | 1 | 买家退货存在空包、缺少配件/赠品等少件的情况 |
31 | 3 | 2 | 1 | 买家退货存在影响二次销售的情况 |
32 | 2 | 2 | 1 | 买家上传的退货物流单号存在异常 |
44 | 1 | 1 | 1 | 已与买家协商取消售后 |
45 | 2 | 1 | 1 | 买家协商取消售后 |
46 | 2 | 1 | 1 | 协商取消售后 |
47 | 1 | 2 | 0 | 买家售后申请中没有上传图片凭证 |
48 | 2 | 2 | 1 | 买家售后申请图片凭证与商品不一致 |
49 | 2 | 2 | 1 | 无法联系或联系不上买家 |
50 | 1 | 2 | 0 | 买家售后申请图片凭证不清晰不全面 |
51 | 1 | 2 | 1 | 买家售后申请图片凭证非本订单商品 |
52 | 1 | 1 | 0 | 商品不支持7无,邀请买家取消售后 |
53 | 2 | 2 | 0 | 买家售后申请图片凭证不清晰不全面 |
54 | 2 | 2 | 0 | 买家售后申请中没有上传图片凭证 |
55 | 2 | 2 | 1 | 买家退货的物流单号存在异常 |
56 | 2 | 1 | 0 | 商品不支持7无,邀请买家取消售后 |
57 | 1 | 2 | 0 | 商品不支持7无,邀请买家补充质量问题凭证 |
58 | 2 | 2 | 0 | 商品不支持7无,邀请买家补充质量问题凭证 |
59 | 1 | 1 | 1 | 买家觉得发货/物流慢 |
63 | 2 | 3 | 0 | 物流拦截成功邀请买家修改为仅退款(若买家同意协商或退款金额不变,平台将自动退款) |
64 | 2 | 3 | 0 | 价值较低的商品邀请买家仅退款无需退货(若买家同意协商或退款金额不变,平台将自动退款) |
65 | 2 | 1 | 1 | 买家觉得发货/物流慢 |
66 | 1 | 2 | 1 | 商品需寄回(若买家同意协商,将自动进入退货流程)注:商家需将售后类型选择为“退货退款” |
67 | 2 | 1 | 1 | 买家退货的物流状态显示取消寄件 |
68 | 2 | 1 | 1 | 买家退货的物流状态存在异常 |
69 | 1 | 1 | 1 | 虚拟商品已完成服务/激活 |
# 5. 代码示例
请求示例
{
"after_sale_order_id": "1768034782998651",
"type": 1,
"amount": 100,
"merchant_update_desc": "xxx"
"update_reason_type": "123",
"merchant_update_type": 6,
"media_ids": [
"id1",
"id2"
]
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
9700223 | 系统失败 | |
9700224 | 参数错误 | |
10020000 | 售后单号不合法 | |
10020001 | 售后单状态不合法 | |
10021041 | 当前售后单不支持此操作,请检查售后单状态 | |
10021043 | 售后单非当前账号,请检查参数 | |
10021044 | 当前用户太多,请稍后再试 | |
10021050 | 售后单不存在 | |
10021057 | 售后单不存在 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。