售后列表查询

POST#97api SHOP_AFTERSALES_INFO

https://member.bilibili.com/arcopen/fn/market/common/after_sale_query_list

开放能力 / 交易电商 / 电商 / 接口 / 售后模块接口

调用该接口可查询退货列表

body 参数

名称	类型	必填	说明
order_id	int	否	父订单号
after_sale_type	int	否	售后类型: 1-仅退款；2-退货退款；3-换货；
reason	int	否	售后理由；1-七天无理由退货；2-非七天无理由退货；
logistics_status	int	否	退货物流状态，枚举为1(全部),2(已发货),3(未发货)
refund_type	int	否	退款类型:0-无需退款；1-原路退款；2-线下退款；
arbitrate_status	int	否	仲裁状态：0-默认状态；1-待商家上传凭证；2-双方举证中；3-平台仲裁中；61-买家撤销仲裁；62-系统撤销仲裁；8-仲裁完成
start_time	int	否	申请时间开始，单位为秒（查询范围包含开始值）
end_time	int	否	申请时间结束，单位为秒（查询范围不包含结束值）
amount_start	int	否	售后退款金额下限，单位为分（查询范围包含开始值）
amount_end	int	否	售后退款金额上限，单位为分（查询范围不包含结束值）
order_by	string	否	排序方式，优先级按照列表顺序从前往后依次减小，写法为"<字段名称> <排序方式>"，字段名称目前支持"apply_time"（申请时间）和 "update_time"（更新时间），排序方式目前支持"asc"（升序）和"desc"（降序）。
page	int	是	页数，从0开始
size	int	是	每页数量，最多100个
after_sale_id	int	否	售后单号
after_sale_status	list	否	售后状态：1-申请退款；2-取消退款申请；3-拒绝退款申请；11-申请退货退款；12-取消退货退款申请；13-拒绝退货退款申请；14-待用户提交物流；15-待商家确认收货；21-申请换货；22-取消换货申请；23-拒绝换货申请；24-换货待商家发货；25-换货发货，待买家确认收货；60-售后完成；61-售后终止；
update_start_time	int	否	更新时间开始，单位为秒（查询范围包含开始值）；当使用update_start_time和update_end_time时，order_by= update_time；
update_end_time	int	否	更新时间结束，单位为秒（查询范围包含开始值）；当使用update_start_time和update_end_time时，order_by= update_time；

响应字段

名称	类型	必填	说明
after_sale_list	list	否	售后列表
has_more	bool	否	是否还有更多
total	int	否	当前搜索条件下，匹配到的总数量
page	int	否	页码，从0开始
size	int	否	当前返回售后数量
after_sale_info	struct	否	售后信息
order_info	struct	否	订单信息
text_info	struct	否	文案信息
after_sale_id	int	否	售后单号
after_sale_type	int	否	售后类型: 1-仅退款；2-退货退款；3-换货；
after_sale_status	int	否	售后状态：1-申请退款；2-取消退款申请；3-拒绝退款申请；11-申请退货退款；12-取消退货退款申请；13-拒绝退货退款申请；14-待用户提交物流；15-待商家确认收货；21-申请换货；22-取消换货申请；23-拒绝换货申请；24-换货待商家发货；25-换货发货，待买家确认收货；60-售后完成；61-售后终止
order_id	int	否	关联的订单ID
apply_time	int	否	申请时间
update_time	int	否	最近更新时间
status_deadline	int	否	当前节点逾期时间
refund_amount	int	否	售后退款金额，单位为分
refund_post_amount	int	否	售后退运费金额，单位为分
after_sale_num	int	否	售后数量
refund_type	int	否	退款类型:0-无需退款；1-原路退款；2-线下退款
arbitrate_status	int	否	仲裁状态：0-默认状态；1-待商家上传凭证；2-双方举证中；3-平台仲裁中；61-买家撤销仲裁；62-系统撤销仲裁；8-仲裁完成
create_time	int	否	售后单创建时间
return_logistics_code	string	否	退货物流单号
refund_status	int	否	退款状态；1-待退款;2-退款中;3-退款成功;4-退款失败;
exchange_sku_info	struct	否	换货sku信息
logistics_status	int	否	申请售后时商品发货状态，枚举为0-未发货；1-已发货；
shop_order_id	int	否	店铺单订单ID
sku_order_infos	struct	否	售后关联的订单信息
sku_order_id	int	否	商品单id
item_num	int	否	购买数量
product_name	string	否	商品名称
product_id	int	否	商品ID
product_image	string	否	商品图片
sku_id	int	否	sku_id
after_sale_item_num	int	否	售后商品数量
after_sale_pay_amount	int	否	售后退款金额
price	int	否	实际售卖价格（不包括运费）
after_sale_status_text	string	否	售后状态文案
after_sale_type_text	string	否	售后类型文案
return_logistics_text	string	否	退货物流发货状态文案
after_sale_refund_type_text	string	否	售后退款类型文案
reason_text	string	否	售后理由文案
arbitrate_status_text	string	否	仲裁状态文案
sku_id	Long	否	商品skuId
num	Integer	否	替换数量
url	String	否	商品图片url
name	String	否	商品名称
price	Long	否	换货商品价格，单位分
specDesc	String	否	sku规格信息

调用方式

javascript

// 让 AI 直接调（需要开放平台凭据）
bili_api_call { "ref": "97", "query": {…}, "body": {…} }

// 只看将要发出的请求（不需要凭据）
bili_api_call { "ref": "97", "dryRun": true }

// 生成完整调用代码
bili_codegen { "ref": "97", "lang": "python" }

官方请求示例

bash

curl --location --request POST 'https://member.bilibili.com/arcopen/fn/market/common/after_sale_query_list' \
--header 'Accept: application/json' \
--header 'Access-Token: a24e56a0fc0093668bca0f3a15410ea2' \
--header 'Content-Type: application/json' \
--header 'x-bili-timestamp: 1712473117' \
--header 'x-bili-signature-method: HMAC-SHA256' \
--header 'x-bili-signature-version: 2.0' \
--header 'Authorization: afdf0ddc6dd8f5af9c7f25cf3115a03142e67df99e15f909a17c11e4c82ad4f9' \
--header 'x-bili-signature-nonce: 1712473117993237000' \
--header 'x-bili-accesskeyid: 8ca079bc20ce433d' \
--header 'x-bili-content-md5: 795a2d7e13f989cee460801379fe543c' \
--header 'Connection: keep-alive' \
--data-raw '{
 "order_id":8001008998033036,
 "page": 0,
 "size": 10
}'

原始文档：097_售后列表查询.md（11491 字节）。用 bili_docs_get { "ref": "97" } 读全文，或用 bili_api_spec { "ref": "97" } 取结构化规格。