# 商家协商

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商)

# 请求体 Request Payload

参数名类型必填说明
after_sale_order_idstring售后单号
typenumber协商修改把售后单修改成该售后类型。1:退款;2:退货退款
amountnumber金额(单位:分)
merchant_update_descstring协商描述
update_reason_typenumber协商原因,枚举值请参考下文
merchant_update_typenumber1:已协商一致,邀请买家取消售后; 2:邀请买家核实与补充凭证; 3:修改买家售后申请
media_idsarray协商凭证id列表,可使用图片上传接口获取media_id(数据类型填0),当update_reason_type对应的need_image为1时必填

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息

# 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. 适用范围

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