授权、查单与接口目录
适用于网页版 3.0极速版、企业版、旗舰版。请在控制台选择「旺店通网页版」,使用自己的 sid 调用。
先完成授权
- 在慧策开放平台选择「接入旺店通网页版」,申请奇门自定义授权。AppKey 使用控制台显示的授权 AppKey,SID 填自己的卖家账号。
- 在奇门云保存网页版绑定,代码中填写相同的 sid。原有客户端绑定仍用于客户端接口。
- 开通套餐后,在控制台订单测试区选择网页版账号,输入原始订单号即可查询。
需要标准接口时,在网页版绑定的可选配置中一起填写网页版标准 AppKey、AppSecret。服务器负责签名,调用代码只需你的使用密钥和 sid。
标准接口不返回淘系及系统供销平台订单;这些订单请走奇门接口。奇门也只返回平台允许提供的数据。授权及数据范围以旺店通为准。
Python 签名直连查单
下载签名客户端与下方脚本,放在同一文件夹即可运行,无需安装依赖。订单号保持字符串,网页版分页从 0 开始。ERP 数据由官方通道直接返回你的服务器。
# 旺店通网页版签名直连查单:Python 3.9+,无需安装依赖
# 另存 https://api.miandanni.com/examples/qimenyun_direct.py 到本文件同目录。
# 订单数据来自 ERP,通常通过淘宝奇门路由;不使用万相台广告接口。
import json
from qimenyun_direct import Client, CallError, check_result
CONFIG = {
"apiKey": "你的奇门云密钥",
"sid": "你的SID",
"platform": "wangdian_web",
"method": "wdt.trade.query",
"timeout": 30,
}
PARAMS = {
"src_tid": "你的订单号", # 原平台订单号保留字符串
"page_no": 0,
"page_size": 25,
}
def call_api(*, display=False):
if not isinstance(CONFIG["sid"], str) or not CONFIG["sid"].strip() or CONFIG["sid"] == "你的SID":
raise RuntimeError("请填写自己的 sid")
if not CONFIG["apiKey"] or CONFIG["apiKey"] == "你的奇门云密钥":
raise RuntimeError("请填写自己的奇门云密钥 apiKey")
client = Client({
"mode": "direct", "apiKey": CONFIG["apiKey"],
"services": {"qimen": {"signEndpoint": "https://api.miandanni.com/api/gateway/sign"}},
}, timeout=CONFIG["timeout"])
try:
result = client.call("qimen", {
"sid": CONFIG["sid"], "platform": CONFIG["platform"],
"method": CONFIG["method"], "params": PARAMS,
})
except CallError as exc:
raise RuntimeError(str(exc) + ": " + client.display(exc.payload)) from None
if not isinstance(result, dict):
raise RuntimeError("接口返回格式异常,预期为 JSON 对象")
try:
check_result(result)
except RuntimeError as exc:
raise RuntimeError(str(exc) + ": " + client.display(result)) from None
return client.display(result) if display else result
if __name__ == "__main__":
try:
print(call_api(display=True))
except (RuntimeError, ValueError) as exc:
raise SystemExit(str(exc))
① 下载签名客户端 ② 下载网页版查单脚本奇门接口(11 个)
将下表方法名填写到请求的 method;业务参数按对应官方文档放入 params。不会自动改走标准接口。
| 接口 | method | 业务参数文档 |
|---|---|---|
| 查询店铺 | wdt.shop.query | 查看参数 |
| 查询仓库 | wdt.warehouse.query | 查看参数 |
| 物流公司 | wdt.dict.logistics.query | 查看参数 |
| 查询货品档案 | wdt.goods.query | 查看参数 |
| 查询组合装 | wdt.suites.query | 查看参数 |
| 销售出库单 | wdt.stockout.order.query.trade | 查看参数 |
| 查询退换管理 | wdt.refund.query | 查看参数 |
| 退货入库单查询 | wdt.ext.stockin.order.query.refund | 查看参数 |
| 查询原始退单 | wdt.api.refund.query | 查看参数 |
| 查询原始订单 | wdt.vip.api.trade.query | 查看参数 |
| 系统订单(系统订单查询) | wdt.trade.query | 查看参数 |
标准接口(84 个)
在同一个签名请求中,method 填下表的 .php 接口名,例如 stock_query.php。params 填官方业务参数;SID、AppKey、时间戳和签名由服务器填写,再由你的服务器执行官方请求。数组和对象自动转为 JSON 字符串。
创建、修改、审核、取消、回写类接口会改变 ERP 数据;仅在需要执行相应业务时调用。每个接口仍需旺店通授权。
订单类(19 个)
| 接口 | method | 参数与返回说明 |
|---|---|---|
| 创建原始订单 | trade_push.php | 官方文档 |
| 批量订单换货 | sales_trade_batch_change.php | 官方文档 |
| 单笔订单换货 | sales_trade_simple_change.php | 官方文档 |
| 查询物流同步 | logistics_sync_query.php | 官方文档 |
| 物流同步回写 | logistics_sync_ack.php | 官方文档 |
| 修改订单标签 | sales_trade_tags_modify.php | 官方文档 |
| 系统订单(系统订单查询) | trade_query.php | 官方文档 |
| 查询原始订单 | vip_api_trade_query.php | 官方文档 |
| 销售出库单 | stockout_order_query_trade.php | 官方文档 |
| 修改系统订单 | sales_trade_modify.php | 官方文档 |
| 创建补发订单 | sales_trade_replenish.php | 官方文档 |
| 撤销发货的销售出库单查询 | stockout_order_query_trade_cancel.php | 官方文档 |
| 批量修改系统订单的标旗和备注 | sales_trade_batch_remark_flag.php | 官方文档 |
| 小时达自配送三方运力回传状态和位置接口 | xsd_self_delivery_location_callback.php | 官方文档 |
| 查询直播主播信息 | api_trade_live_extend_query.php | 官方文档 |
| 查询多物流单号 | logistics_multi_query.php | 官方文档 |
| 小时达订单图片回传 | xsd_upload_media.php | 官方文档 |
| 查询JIT出仓单接口 | jit_delivery_order_query.php | 官方文档 |
| 历史订单查询 | his_trade_query.php | 官方文档 |
库存类(24 个)
| 接口 | method | 参数与返回说明 |
|---|---|---|
| 查询库存同步 | api_goods_stock_change_query.php | 官方文档 |
| 查询出库单管理 | stockout_order_query.php | 官方文档 |
| 查询入库单管理 | stockin_order_query.php | 官方文档 |
| 库存同步回写 | api_goods_stock_change_ack.php | 官方文档 |
| 创建入库单 | stockin_order_push.php | 官方文档 |
| 创建盘点单 | stock_sync_by_pd.php | 官方文档 |
| 查询可用库存 | stock_query.php | 官方文档 |
| 创建出库单 | stockout_order_push.php | 官方文档 |
| 分拣单状态回写接口 | pick_status_ack.php | 官方文档 |
| 查询分拣单接口 | pick_order_query.php | 官方文档 |
| 查询分拣单订单 | pick_trade_query.php | 官方文档 |
| 查询出入库明细表 | stock_detail_report_query.php | 官方文档 |
| 查询出入库序列号 | stock_inout_sn_query.php | 官方文档 |
| 查询调拨单及明细 | stock_transfer_query.php | 官方文档 |
| 创建委外出入库单 | vip_wms_stockinout_order_push.php | 官方文档 |
| 序列号管理查询接口 | stock_goods_sn_query.php | 官方文档 |
| 查询生产加工单接口 | stock_production_order_query.php | 官方文档 |
| 全量查询库存 | stock_full_query.php | 官方文档 |
| 创建调拨单 | stock_transfer_create.php | 官方文档 |
| 查询委外出入库单 | stock_outsource_order_query.php | 官方文档 |
| 运营仓单据创建 | operational_order_create.php | 官方文档 |
| 运营仓单据查询 | operational_order_query.php | 官方文档 |
| 运营仓库存明细查询 | operational_stock_detail_query.php | 官方文档 |
| 库存明细查询 | stock_query_detail.php | 官方文档 |
货品类(14 个)
| 接口 | method | 参数与返回说明 |
|---|---|---|
| 平台货品查询 | vip_api_goods_query.php | 官方文档 |
| 查询货品档案 | goods_query.php | 官方文档 |
| 创建平台货品 | api_goodsspec_push.php | 官方文档 |
| 创建货品档案 | goods_push.php | 官方文档 |
| 创建组合装 | suites_push.php | 官方文档 |
| 查询组合装 | suites_query.php | 官方文档 |
| 查询货品分类 | goods_category_query.php | 官方文档 |
| 查询货品分类平级 | goods_category_flat_query.php | 官方文档 |
| 打印唯一码 | unique_code_print.php | 官方文档 |
| 创建系统货品多条码 | spec_barcode_push.php | 官方文档 |
| 查询品牌信息 | goods_brand_query.php | 官方文档 |
| 创建铺货基础商品资料 | pdk_basic_spu_create.php | 官方文档 |
| 查询铺货基础商品详情 | pdk_basic_spu_detail_query.php | 官方文档 |
| 分页查询铺货基础商品 | pdk_basic_spu_query.php | 官方文档 |
基础类(14 个)
| 接口 | method | 参数与返回说明 |
|---|---|---|
| 查询供应商 | purchase_provider_query.php | 官方文档 |
| 查询标签/异常 | cfg_tags_query.php | 官方文档 |
| 查询唯一码 | unique_code_query.php | 官方文档 |
| 物流公司 | logistics.php | 官方文档 |
| 员工查询 | employee_query.php | 官方文档 |
| 称重 | vip_stockout_sales_weight_push.php | 官方文档 |
| 查询店铺 | shop.php | 官方文档 |
| 查询仓库 | warehouse_query.php | 官方文档 |
| 修改唯一码状态为已到货 | unique_code_status_change.php | 官方文档 |
| 创建供应商 | purchase_provider_create.php | 官方文档 |
| 业务单据审核接口 | order_audit.php | 官方文档 |
| 业务单据取消 | order_cancel.php | 官方文档 |
| 业务单停止等待 | order_stop_waiting.php | 官方文档 |
| 业务单据驳回审核接口 | order_reject.php | 官方文档 |
售后类(7 个)
采购类(6 个)
目录核对日期:2026-09-14。以上为已接入的调用通道,客户实际可调用范围取决于其授权;需使用网页版账号完成实际联调。