售后详情

POST#98api SHOP_AFTERSALES_INFO

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

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

调用该接口可查询退货详情

body 参数

名称	类型	必填	说明
after_sale_id	int	是	售后单ID
need_operate_record	bool	否	是否需要协商记录

响应字段

名称	类型	必填	说明
process_info	struct	否	售后单及相关信息
order_info	struct	否	售后单关联订单信息
after_sale_info	struct	否	售后单信息
arbitrate_info	struct	否	仲裁信息
logistics_info	struct	否	物流信息
record_logs_list	struct	否	协商记录
after_sale_id	int	否	售后单号
after_sale_status	int	否	售后状态：1-申请退款；2-取消退款申请；3-拒绝退款申请；11-申请退货退款；12-取消退货退款申请；13-拒绝退货退款申请；14-待用户提交物流；15-待商家确认收货；21-申请换货；22-取消换货申请；23-拒绝换货申请；24-换货待商家发货；25-换货发货，待买家确认收货；60-售后完成；61-售后终止
after_sale_status_desc	string	否	售后状态文案
refund_type	int	否	退款类型:0-无需退款；1-原路退款；2-线下退款
refund_type_text	string	否	退款类型文案
refund_status	int	否	退款状态：0-无退款；1-待退款;2-退款中;3-退款成功;4-退款失败;
refund_amount	int	否	售后总金额（含运费）
refund_post_amount	int	否	售后运费
apply_time	int	否	售后单申请时间，单位秒
update_time	int	否	售后单更新时间，单位秒
reason	string	否	申请原因
after_sale_type	int	否	售后类型: 1-仅退款；2-退货退；3-换货；
after_sale_type_text	string	否	售后单类型文案
reason_remark	string	否	申请描述
evidence	list	否	买家申请退款图片凭证，仅支持图片。
after_sale_apply_count	int	否	用户申请售后件数
return_address	struct	否	退货地址
post_address	struct	否	换货地址
real_refund_amount	int	否	实际退款金额;单位：分（此字段只有退款成功后才会记录）
got_pkg	int	否	买家是否收到货，0-表示未收到货；1-表示收到货
status_deadline	int	否	当前节点逾期时间
exchange_sku_info	struct	否	换货sku信息
part_type	int	否	部分退状态，0为全额退款，1为部分退
refund_fail_reason	string	否	退款失败文案
apply_role	int	否	售后申请角色：1-买家；2-商家；3-平台客服；4-系统
refund_time	int	否	退款成功时间，即平台最后原路退回金额到用户账户的成功时间，Unix时间戳：秒
return_method	int	否	用户申请时的退货方式：0-未选择，1-用户上传物流，2-上门取件
logistics_status	int	否	申请售后时商品发货状态，枚举为0-未发货；1-已发货；
detail	string	否	详细地址
detail	STRING	否	详细地址
province	Struct	否	省
city	Struct	否	市
area	Struct	否	区
id	INTEGER	否	地址 id
name	STRING	否	地址名称
sku_id	Long	否	商品skuId
num	Integer	否	替换数量
url	String	否	商品图片url
name	String	否	商品名称
price	Long	否	换货商品价格，单位分
specDesc	String	否	sku规格信息
arbitrate_id	int	否	仲裁单id
arbitrate_status	int	否	仲裁状态：0-默认状态；1-待商家上传凭证；2-双方举证中；3-平台仲裁中；61-买家撤销仲裁；62-系统撤销仲裁；8-仲裁完成
arbitrate_status_deadline	int	否	仲裁当前节点截止时间
arbitrate_create_time	int	否	仲裁单创建时间
arbitrate_update_time	int	否	仲裁单更新时间
return_logistics	struct	否	买家退货物流信息
exchange_logistics	Struct	否	换货物流信息
tracking_no	string	否	物流单号
company_name	string	否	物流公司名称
company_code	string	否	物流公司编码
logistics_time	int	否	买家填写退货物流时间
operator	string	否	操作人
time	string	否	操作时间
text	string	否	操作内容
images	list	否	图片列表
action	string	否	动作
role	int	否	角色；1-买家，2-商家，3-平台客服，4-系统
desc_kvs	list	否	额外信息
shop_order_id	int	否	店铺单ID
sku_order_infos	list	否	sku单信息
sku_order_id	int	否	商品单信息
item_quantity	int	否	订单件数
create_time	int	否	下单时间
product_name	string	否	商品名称
product_id	int	否	商品ID
product_image	string	否	商品图片
sku_id	int	否	skuID
sku_refund_amount	int	否	sku退款金额
after_sale_item_num	int	否	商品单对应的售后数量
price	int	否	sku单价

调用方式

javascript

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

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

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

官方请求示例

bash

curl --location --request POST 'https://member.bilibili.com/arcopen/fn/market/common/after_sale_query_detail' \
--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 '{
  "after_sale_id" : 78720031036,
  "need_operate_record" : true
}'

原始文档：098_售后详情.md（13017 字节）。用 bili_docs_get { "ref": "98" } 读全文，或用 bili_api_spec { "ref": "98" } 取结构化规格。