## 接口说明
orders/single/query 对应聚水潭 ERP【订单 → 订单操作 → 订单】列表数据,数据流向为外部系统从聚水潭拉取订单。按修改时间增量分页返回订单头、商品明细、金额与状态信息,是订单同步到 WMS/财务/BI 的标准入口。注意:此接口查不到淘系和拼多多订单(平台数据安全限制),这两类订单需通过奇门自定义接口获取。
### 请求要点
1. POST + application/json;公共参数 app_key、access_token、timestamp、charset、sign 与业务参数一并参与签名。
2. 业务参数:page_index(页码,从 1 开始)、page_size(每页条数,最大 50)、start_time/end_time(修改时间窗口)、status(订单状态)、date_type 等。
3. 返回 code=0 时,data.orders 为订单数组,含 so_id(线上单号)、order_date、shop_id、status、items(sku_id、qty、amount)、freight、paid_amount 等;page 对象含总条数用于翻页判断。
4. page_size 上限较小(50),大促期间要按 15-30 分钟窗口切片,防止单窗口订单超过翻页上限导致丢单。
### 对账字段
财务对账重点关注 paid_amount(实付)、free_amount(减免)、freight(运费)、refund_status(退款状态);与平台账单核对时以 so_id(平台单号)为关联键。