带货订单查询

POST#83api SHOP_ORDER_INFO

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

开放能力 / 交易电商 / 电商 / 接口 / 订单模块接口

调用该接口可查询带货订单信息

body 参数

名称	类型	必填	说明
openId	string	是	开放平台openId
pageSize	int	否	每页订单数量，默认100，取值区间[1,200]
nextPageIndex	int	否	下一页索引，第一页传0
queryTimeType	int	否	查询时间类型，时间区间查询时必传，固定值1-支付完成时间
queryStartTime	int64	否	订单查询开始时间，毫秒级时间戳
queryEndTime	int64	否	订单查询结束时间，毫秒级时间戳
orderIds	string	否	订单号，按英文逗号分隔，最多10个，按父单匹配

响应字段

名称	类型	必填	说明
success	bool	否	接口是否成功
code	int64	否	返回码，成功默认 0
message	string	否	返回信息
data	object	否	分页结果
pageNum	int	否	当前页码，按 nextPageIndex / pageSize + 1 计算
pageSize	int	否	本次查询分页大小
total	int64	否	总记录数
list	list	否	订单列表
orderId	string	否	父订单号
orderStatus	int	否	订单状态：1-支付完成；2-确认收货；3-结算完成；4-已取消
goodsId	string	否	商品ID
goodsName	string	否	商品名称
goodsImgUrl	string	否	商品图片URL
merchantName	string	否	商家名称
shopId	string	否	店铺ID
settlePrice	int64	否	计费金额，单位分
commRatio	int64	否	带货佣金比例，真实值x100
commissionAmount	int64	否	带货佣金，单位分
payTime	string	否	订单支付时间，格式 yyyy-MM-dd HH:mm:ss
entryTime	string	否	确认收货时间，格式 yyyy-MM-dd HH:mm:ss
upSettleTime	string	否	UP主佣金结算时间，格式 yyyy-MM-dd HH:mm:ss，未结算时为空
upUid	string	否	UP主UID
commNickname	string	否	UP主昵称
commScene	int	否	带货场景：1-视频；2-直播；3-橱窗；4-动态图文；5-其他
contentType	int	否	内容类型：0-直播；1-稿件；2-动态；3-专栏；-1-商品
contentId	string	否	直播间id/稿件id
salesType	int	否	佣金类型：1-自带货；2-通用；3-定向
payStepId	int	否	订单支付阶段：0-现货；1-定金；2-尾款

调用方式

javascript

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

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

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

官方请求示例

bash

curl --location --request GET 'https://{gateway-host}/mall-settle/open/platform/commSettle/page?uid=123456&pageSize=20&nextPageIndex=0&queryTimeType=1&queryStartTime=1744819200000&queryEndTime=1744905599000' \
--header 'Accept: application/json' \
--header 'Access-Token: your-access-token' \
--header 'x-bili-timestamp: 1744905600' \
--header 'x-bili-signature-method: HMAC-SHA256' \
--header 'x-bili-signature-version: 2.0' \
--header 'Authorization: your-signature'

原始文档：083_带货订单查询.md（5658 字节）。用 bili_docs_get { "ref": "83" } 读全文，或用 bili_api_spec { "ref": "83" } 取结构化规格。