# 获取群礼物超时自动退售后单
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：getpresentaftersaleorder
通过该接口可以获取微信小店的群礼物超时自动退售后单
相关事件通知：群礼物超时自动退售后单更新通知
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/aftersale/getpresentaftersaleorder?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 | 是 | 6000000000000001 | 售后单号 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| after_sale_order_id | string | 售后单号 |
| present_order_id | string | 送礼订单号，该字段可用于获取送礼订单信息 |
| status | string | 售后单当前状态，枚举值请参考下文 |
| openid | string | 买家身份标识 |
| unionid | string | 买家在开放平台的唯一标识符，若当前视频号小店已绑定到微信开放平台账号下会返回，详见[UnionID 机制说明](https://developers.weixin.qq.com/doc/oplatform/open/intro.html) |
| create_time | number | 售后单创建时间戳 |
| update_time | number | 售后单更新时间戳 |
| refund_info | object | 送礼订单整体退款详情 |
| order_info_list | objarray | 收礼者订单信息 |
# Res.refund_info Object Payload
送礼订单整体退款详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| amount | number | 退款金额（分） |
# Res.order_info_list(Array) Object Payload
收礼者订单信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| order_id | string | 收礼者订单信息 |
| refund_info | object | 当前收礼者订单退款详情 |
| product_info_list | objarray | 售后相关商品信息 |
# Res.order_info_list(Array).refund_info Object Payload
当前收礼者订单退款详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| amount | number | 退款金额（分） |
# Res.order_info_list(Array).product_info_listObject Payload
Object Payload售后相关商品信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_id | string | 商品spuid |
| sku_id | string | 商品skuid |
| count | number | 售后数量 |
| refund_info | object | 当前商品退款详情 |
| gift_product_list | objarray | 赠品信息 |
# Res.order_info_list(Array).product_info_list.refund_info Object Payload
Object Payload当前商品退款详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| amount | number | 退款金额（分） |
# Res.order_info_list(Array).product_info_list.gift_product_listObject Payload
Object Payload赠品信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_id | string | 商品spuid |
| sku_id | string | 商品skuid |
| count | number | 退款数量 |
# 4. 注意事项
status售后单当前状态
| 枚举值 | 描述 |
|---|---|
| PLATFORM_REFUNDING | 平台退款中 |
| MERCHANT_REFUND_SUCCESS | 退款完成 |
| PLATFORM_REFUND_FAIL | 平台退款失败 |
| MERCHANT_REFUND_RETRY_FAIL | 商家打款失败，客服关闭售后 |
# 5. 代码示例
请求示例
{
"after_sale_order_id": "6000000000000001"
}
返回示例
{
"errcode": 0,
"after_sale_order": {
"after_sale_order_id": "6000000000000001",
"present_order_id": "4200000000000001",
"status": "MERCHANT_REFUND_SUCCESS",
"openid": "OPENID",
"unionid": "UNIONID",
"create_time": 1591319454,
"update_time": 1612754444,
"refund_info": {
"amount": 100
},
"order_info_list": [
{
"order_id": "3700000000000001",
"refund_info": {
"amount": 51
},
"product_info_list": [
{
"product_id": "1111",
"sku_id": "2222",
"count": 1,
"refund_info": {
"amount":51
}
}
]
},
{
"order_id": "3700000000000002",
"refund_info": {
"amount": 49
},
"product_info_list": [
{
"product_id": "3333",
"sku_id": "4444",
"count": 1,
"refund_info": {
"amount": 49
}
}
]
}
]
}
}
# 6. 错误码
此接口没有特殊错误码，可参考 通用错误码
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。