# 获取售后单
# 接口说明
通过该接口可以获取视频号小店的售后单
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/aftersale/getaftersaleorder?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| after_sale_order_id | String | 是 | 售后单号 |
# 请求参数示例
{
"after_sale_order_id": "123456"
}
# 返回参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| after_sale_order_id | String | 是 | 售后单号 |
| status | String | 是 | 售后单当前状态，请参考AfterSaleStatus |
| openid | String | 是 | 买家身份标识 |
| unionid | String | 是 | 买家在开放平台的唯一标识符，若当前视频号小店已绑定到微信开放平台账号下会返回，详见UnionID 机制说明 |
| product_info | Object AfterSaleProductInfo | 是 | 售后相关商品信息，请参考AfterSaleProductInfo |
| refund_info | Object RefundInfo | 否 | 退款详情，请参考RefundInfo |
| return_info | Object ReturnInfo | 否 | 用户退货信息，请参考ReturnInfo |
| merchant_upload_info | MerchantUploadInfo | 否 | 商家上传的信息，请参考MerchantUploadInfo |
| create_time | Number | 是 | 售后单创建时间戳 |
| update_time | Number | 是 | 售后单更新时间戳 |
| reason | String | 是 | 退款原因（后续新增的原因将不再有字面含义，请参考reason_text） |
| reason_text | String | 是 | 退款原因解释，全部定义参考获取全量售后原因 |
| type | String | 是 | 售后类型。REFUND:退款；RETURN:退货退款。 |
| complaint_id | String | 否 | 纠纷id，该字段可用于获取纠纷信息 |
| order_id | String | 是 | 订单号，该字段可用于获取订单 |
| refund_resp | Object ApplyRefundResp | 否 | 微信支付退款的响应，请参考ApplyRefundResp |
| deadline | Number | 否 | 仅在待商家审核退款退货申请或收货期间返回，表示操作剩余时间（秒数） |
# 返回参数示例
{
"errcode": 0,
"after_sale_order": {
"after_sale_order_id": "123456",
"status": "MERCHANT_REFUND_SUCCESS",
"openid": "OPENID",
"order_id": "1768683047558651",
"product_info": {
"product_id": "3286",
"sku_id": "4740",
"count": 1
},
"details": {
"desc": "1234",
"receive_product": 4294967295,
"cancel_time": 0,
"media id list": [],
"tel_number": ""
},
"refund_info": {
"amount": 11,
"refund_reason":1
},
"return_info": {
"waybill_id": "",
"delivery_id": "",
"delivery_name": ""
},
"merchant_upload_info": {
"reject_reason": "",
"refund_certificates": []
},
"create_time": 1591319454,
"update_time": 1612754444,
"reason": "NO_LONGER_WANT",
"refund_resp": {
"code": "",
"ret": 0,
"message": ""
},
"type": "REFUND"
}
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
# 结构体
# AfterSaleProductInfo
售后相关商品信息
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| product_id | String | 是 | 商品spuid |
| sku_id | String | 是 | 商品skuid |
| count | Number | 是 | 售后数量 |
| fast_refund | Bool | 是 | 是否极速退款 |
# RefundInfo
退款详情
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| amount | Number | 是 | 退款金额（分） |
| refund_reason | Number | 否 | 标明售后单退款直接原因, 枚举值详情请参考RefundReason |
# ReturnInfo
用户退货信息
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| waybill_id | String | 是 | 快递单号 |
| delivery_id | String | 是 | 物流公司id |
| delivery_name | String | 是 | 物流公司名称 |
# MerchantUploadInfo
商家上传的信息
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| reject_reason | String | 否 | 拒绝原因 |
| refund_certificates | Array<String> | 否 | 退款凭证 |
# AfterSaleDetails
售后详情
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| desc | String | 是 | 售后描述 |
| receive_product | Bool | 是 | 发起售后的时候用户是否已经收到货 |
| cancel_time | Number | 否 | 取消售后时间 |
| media_id_list | Array<String> | 否 | 举证图片media_id列表,根据mediaid获取文件内容接口 |
| tel_number | String | 否 | 联系电话 |
# ApplyRefundResp
微信支付退款的响应
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | String | 否 | 错误码 |
| ret | Number | 否 | 状态码 |
| message | String | 否 | 描述 |
# 枚举值
# RefundReason
售后单退款直接原因
| 枚举值 | 描述 |
|---|---|
| 1 | 商家通过店铺管理页或者小助手发起退款 |
| 2 | 退货退款场景，商家同意买家未上传物流单号情况下确认收货并退款，该场景限于订单无运费险 |
| 3 | 商家通过后台api发起退款 |
| 4 | 未发货售后平台自动同意 |
| 5 | 平台介入纠纷退款 |
| 6 | 特殊场景下平台强制退款 |
| 7 | 退货退款场景，买家同意没有上传物流单号情况下，商家确认收货并退款，该场景限于订单包含运费险，并无法理赔 |
| 8 | 商家发货超时，平台退款 |
| 9 | 商家处理买家售后申请超时，平台自动同意退款 |
| 10 | 用户确认收货超时，平台退款 |
| 11 | 商家确认收货超时，平台退款 |
# AfterSaleStatus
售后单当前状态
| 枚举值 | 描述 |
|---|---|
| USER_CANCELD | 用户取消申请 |
| MERCHANT_PROCESSING | 商家受理中 |
| MERCHANT_REJECT_REFUND | 商家拒绝退款 |
| MERCHANT_REJECT_RETURN | 商家拒绝退货退款 |
| USER_WAIT_RETURN | 待买家退货 |
| RETURN_CLOSED | 退货退款关闭 |
| MERCHANT_WAIT_RECEIPT | 待商家收货 |
| MERCHANT_OVERDUE_REFUND | 商家逾期未退款 |
| MERCHANT_REFUND_SUCCESS | 退款完成 |
| MERCHANT_RETURN_SUCCESS | 退货退款完成 |
| PLATFORM_REFUNDING | 平台退款中 |
| PLATFORM_REFUND_FAIL | 平台退款失败 |
| USER_WAIT_CONFIRM | 待用户确认 |
| MERCHANT_REFUND_RETRY_FAIL | 商家打款失败，客服关闭售后 |
| MERCHANT_FAIL | 售后关闭 |
| USER_WAIT_CONFIRM_UPDATE | 待用户处理商家协商 |
| USER_WAIT_HANDLE_MERCHANT_AFTER_SALE | 待用户处理商家代发起的售后申请 |
# AfterSaleReason
售后原因
| 枚举值 | 描述 |
|---|---|
| INCORRECT_SELECTION | 拍错/多拍 |
| NO_LONGER_WANT | 不想要了 |
| NO_EXPRESS_INFO | 无快递信息 |
| EMPTY_PACKAGE | 包裹为空 |
| REJECT_RECEIVE_PACKAGE | 已拒签包裹 |
| NOT_DELIVERED_TOO_LONG | 快递长时间未送达 |
| NOT_MATCH_PRODUCT_DESC | 与商品描述不符 |
| QUALITY_ISSUE | 质量问题 |
| SEND_WRONG_GOODS | 卖家发错货 |
| THREE_NO_PRODUCT | 三无产品 |
| FAKE_PRODUCT | 假冒产品 |
| NO_REASON_7_DAYS | 七天无理由 |
| INITIATE_BY_PLATFORM | 平台代发起 |
| OTHERS | 其它 |