Qeasy Cloud
Get Started
POSThttps://qimen.api.taobao.com/router/qm (method=jushuitan.saleout.list.query)奇门签名 + target_app_key/customer_id 路由

Sales Outbound Order List Query (Qimen Custom)

聚水潭奇门自定义接口 jushuitan.saleout.list.query,分页查询销售出库单列表(含明细),支持按状态、分仓、店铺与时间窗口过滤,是出库履约与财务核算的关键取数口。

## Overview jushuitan.saleout.list.query is a Qimen custom query exposed by Jushuitan for fetching sales outbound orders — the actual fulfillment documents behind marketplace orders. Because Taobao-family orders are invisible in the plain open API, this interface is the only compliant way to extract outbound data for Taobao shops. ### Request essentials 1. Call the unified Qimen gateway; sign per Qimen rules, set target_app_key=23060081 and pass customer_id for merchant routing. 2. Business parameters (page_index/page_size) with common filters: - status — Creating (pending), WaitConfirm, Confirmed, Cancelled; - wms_co_id — sub-warehouse; shop_id — shop; - so_ids — online order numbers (pinpoint); start_modified/end_modified — modify-time window. 3. data.datas returns outbound rows with io_id (outbound no), so_id, status, warehouse and items (sku_id, qty, sale_price, sale_amount). ### Typical uses - Generate Kingdee/Yonyou sales-delivery vouchers automatically from outbound orders, closing the e-commerce-to-ERP loop. - Run three-way matching across items.sale_amount, marketplace statements and ERP receivables for AI-assisted reconciliation. - Aggregate shipped quantities per wms_co_id as the actual-demand input for replenishment and inter-warehouse transfer models. ### Operational tips The Qimen gateway expects form encoding, not JSON bodies — sending JSON is the most common first-call mistake. Persist customer_id per merchant in the connection store and never hard-code it into shared code. When replaying history, watch the QPS budget: one saturated backfill window starves the real-time sync that shares the same credentials.

Code examples

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"}'

Error codes

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