# 商家协商
接口应在服务器端调用,不可在前端(小程序、网页、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. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。