订单明细使用 orders_list,订单汇总使用 orders_statistics。两个工具共用筛选参数,但返回形状不同;不要用明细结果代替统计,也不要把统计结果当作订单行。
常用参数直接放在工具参数对象中:
| 参数 | 含义 |
|---|---|
searchType / searchName | 搜索类型和值:订单号、交易单号、学员编码 ID、买家昵称/姓名/手机号、收货人姓名/手机号、物流单号、商品 ID 等 |
timeType | 时间类型:1 下单时间、2 付款时间、3 结算时间 |
startAt / endAt | YYYY-MM-DD 日期范围 |
minAmount / maxAmount | 金额范围,字符串传值以保留精度 |
status / afterStatus | 订单状态和售后状态,-1 表示全部 |
invoice / invoiceStatus | 发票申请和开票状态 |
prodName / prodType / orderType | 商品名称、商品类型、订单类型 |
fromAPP / paymentMethod / mchType / deliverType | 渠道、支付、收款和发货方式 |
hasGiftOrder | 是否包含赠品 |
page / limit | 分页;默认 1/10,每页最多 50 |
不要传 isStatistics;列表工具传入 0,统计工具传入 1。不要传 companyId、storeId、chainStoreId、excelCompanyId、excelStoreId、excelLoginAdminUserId 或上游地址。管理员和店铺范围来自 OAuth 授权。
只请求一页并准确说明页码和条数。沿用后台慢查询保护:可能缩小查询范围、把统计改为列表、返回上次缓存或空结果。以实际返回内容为准,不把列表当作统计,不把空结果解释为店铺没有订单。
统计工具暂不接受 searchType=10(收货人姓名)或 searchType=11(收货人手机号),因为后台统计分支不会应用这两个筛选条件;需要这类筛选时使用 orders_list。


