# 商家获取保障单列表

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:searchguaranteeorder

通过该接口可以在微信小店售后管理中获取保障单列表

相关事件通知:保障单更新通知

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/aftersale/searchguaranteeorder?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口支持第三方平台代微信小店商家调用。

  • 该接口所属的权限集 id 为:131

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商)

# 请求体 Request Payload

参数名类型必填示例说明
guarantee_order_id_listnumarray2000001077270153保障单号
order_id_listnumarray3726524657461498624订单号
typenumber-想要获取的保障单类型;0-全部类型,1-假一赔三,2-坏损包退
begin_timenumber-保障单申请的开始时间戳
end_timenumber-保障单申请的结束时间戳
status_listnumarray-保障单当前状态筛选,枚举值参考下文
offsetnumber-列表起始下标,默认从0开始
limitnumber-需要的保障单列表条数

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
guarantee_order_listobjarray-保障单详情列表
total_numnumber-保障单列表总数

# Res.guarantee_order_list(Array) Object Payload

保障单详情列表

参数名类型说明
guarantee_order_idnumber保障单号
typenumber保障单类型 1-假一赔四 2-坏损包退
order_idnumber订单号
statusstring保障单当前状态,枚举值参考下文
create_timenumber保障单创建时间戳
update_timenumber保障单更新时间戳
apply_reasonstring申请原因
product_infoobjarray商品信息
expire_timenumber保障单过期时间
openidstring买家身份标识
unionidstring买家在开放平台的唯一标识符,若当前微信小店已绑定到微信开放平台账号下会返回,详见[UnionID 机制说明](https://developers.weixin.qq.com/doc/oplatform/open/intro.html)
pay_amountnumber退款金额(分)
merchant_refuse_reasonstring商家拒绝原因
order_pay_infoobject订单支付信息
complete_timenumber保障单完成时间
apply_reason_typenumber申请原因
order_present_infoobject送礼信息
order_typenumber发起保障的订单类型;0-普通订单,10-礼物订单
fake_one_pay_four_infoobject假一赔四保障单详情
bad_pay_infoobject坏损包退保障单详情
wxa_vip_discounted_pricenumber小程序会员已经优惠金额,单位分
history_listarray协商历史

# Res.guarantee_order_list(Array).product_infoObject Payload

商品信息

参数名类型说明
thumb_imgstring商品小图
titlestring商品名称
real_pricenumber商品价格
product_cntnumber商品件数
detailstring商品详情

# Res.guarantee_order_list(Array).order_pay_info Object Payload

订单支付信息

参数名类型说明
transaction_idstring交易单号

# Res.guarantee_order_list(Array).order_present_info Object Payload

送礼信息

参数名类型说明
present_order_idnumber礼物单号
accept_present_timenumber收礼时间
giver_nicknamestring送礼者微信昵称

# Res.guarantee_order_list(Array).fake_one_pay_four_info Object Payload

假一赔四保障单详情

参数名类型说明
identify_feenumber鉴定费用
product_feenumber商品费用
total_pay_feenumber预计赔付
identify_proof_pic_listarray鉴定凭证media_id列表,根据mediaid获取文件内容接口
fee_proof_pic_listarray费用凭证media_id列表,根据mediaid获取文件内容接口
apply_reasonnumber申请原因,1-假一赔四假冒注册商标,2-假一赔四假冒材质成分
acctual_paynumber最终赔付金额

# Res.guarantee_order_list(Array).bad_pay_info Object Payload

坏损包退保障单详情

参数名类型说明
bad_levelnumber损坏程度
contentstring损坏凭证文字
pic_listarray损坏凭证图片media_id列表,根据mediaid获取文件内容接口
pay_feenumber赔付金额,含运费
merchant_modify_levelnumber商家协商损坏程度
merchant_remarkstring商家备注
platform_modify_levelnumber平台调整损坏程度
refund_typenumber退款类型,1-仅退款,2-退货退款,3-换货
receive_productnumber是否收到货,1-未收到货,2-收到货
refund_reasonnumber退款原因
refund_reason_textstring退款原因文案
title_pic_listarray凭证图片media_id列表,根据mediaid获取文件内容接口

# 4. 注意事项

status_list保障单当前状态

枚举值 描述
10 等待商家处理
15 等待平台处理
12 等待用户确认
20 等待商家举证
25 等待用户举证
30 等待双方举证
31 等待OP确认
32 等待支付分付款
33 无需赔付
35 赔付中
36 假一赔四金额异常,待确认
40 赔付成功
45 赔付失败
50 用户取消申请

status保障单当前状态

枚举值 描述
STATUS_WAIT_MERCHANT_HANDLE 等待商家处理
STATUS_WAIT_PLATFORM_HANDLE 等待平台处理
STATUS_WAIT_USER_CONFIRM 等待用户确认
STATUS_WAIT_MERCHANT_PROOF 等待商家举证
STATUS_WAIT_USER_PROOF 等待用户举证
STATUS_WAIT_BOTH_PROOF 等待双方举证
STATUS_WAIT_OP_COMFIRM 等待OP确认
STATUS_WAIT_PAYSCORE_DONE 等待支付分付款
STATUS_NO_NEED_PAY 无需赔付
STATUS_PAYING 赔付中
STATUS_PAY_BLOCK 假一赔四金额异常,待确认
STATUS_PAY_SUCC 赔付成功
STATUS_PAY_FAIL 赔付失败
STATUS_USER_CANCEL 用户取消申请

# 5. 代码示例

请求示例

{
    "guarantee_order_id_list": [
        2000001077270153
    ],
    "order_id_list": [
        3726524657461498624
    ]
    "type": 0
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok"
}

# 6. 错误码

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

错误码错误描述解决方案
9700223系统失败
9700224参数错误
10021041当前售后单不支持此操作,请检查售后单状态
10021057售后单不存在

# 7. 适用范围

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