销售出库单列表查询(奇门自定义)

## 接口说明 jushuitan.saleout.list.query 是聚水潭通过奇门网关开放的自定义查询接口,用于获取 ERP 内销售出库单(对应淘系等平台订单的实际发货单据)列表。由于淘系订单在普通开放接口中不可见,该接口是淘系店铺出库数据出数的必经之路。 ### 请求要点 1. 走奇门统一网关,公共参数按奇门签名规则构造,target_app_key=23060081,并携带 customer_id 路由商家。 2. 业务参数(page_index/page_size 分页)常用过滤: - status:出库单状态,待出库 Creating、待审核 WaitConfirm、已确认 Confirmed、作废 Cancelled; - wms_co_id:分仓编号;shop_id:店铺编码; - so_ids:线上单号(精确查);start_modified/end_modified:修改时间窗口。 3. 返回 data.datas 为出库单数组,含 io_id(出库单号)、so_id(线上单号)、status、warehouse(仓库)、items(sku_id、qty、sale_price、sale_amount)等。 ### 典型用途 - 出库单 → 金蝶/用友销售出库单自动生成,实现电商履约到 ERP 的闭环; - 以 items 中的 sale_amount 与平台账单、ERP 应收做三单匹配,支撑 AI 财务对账; - 按 wms_co_id 维度统计各仓发货量,为智能补货与多仓调拨提供实际销量输入。

代码示例

curl

curl -X POST "https://qimen.api.taobao.com/router/qm" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "method=jushuitan.saleout.list.query&app_key=TAOPPK&target_app_key=23060081" \
  -d "customer_id=CUST123&timestamp=2026-06-01+10:00:00&v=2.0&format=json&sign_method=md5&sign=SIGN" \
  --data-urlencode 'extend_params={"page_index":1,"page_size":50,"status":"Confirmed","start_modified":"2026-06-01 00:00:00","end_modified":"2026-06-01 01:00:00"}'

错误码	消息	含义
INVALID_SIGNATURE	签名非法	按奇门签名规则重算 sign
LIMITED	触发限频	聚水潭奇门接口常见 QPS 10,降速重试
PARAM_ERROR	业务参数错误	检查 status 枚举与时间格式

错误码

消息

含义

INVALID_SIGNATURE

签名非法

按奇门签名规则重算 sign

LIMITED

触发限频

聚水潭奇门接口常见 QPS 10,降速重试

PARAM_ERROR

业务参数错误

检查 status 枚举与时间格式