轻易云
注册体验
POSThttps://api.wangdian.cn/openapi2/trade_query.phpsid + appkey + MD5 签名

订单查询(trade_query)

旺店通企业版订单查询接口,按时间窗口分页拉取订单头、明细、支付与收件人信息,是电商订单出数到 ERP/财务对账场景的核心接口。

## 接口说明 trade_query.php 批量查询旺店通企业版 ERP 内的订单(原始订单/订单管理),支持按下单时间、审核时间等窗口分页拉取,返回订单头、商品明细、支付信息、买家与收件人信息等结构,常用于订单同步到财务系统、BI 以及三单匹配对账。 ### 请求要点 1. 公共参数(sid、appkey、timestamp、sign)按签名规则构造,业务参数以 form 表单提交。 2. 分页:pageno(页号,从 0 开始)、pagesize(每页条数,建议 ≤100)。 3. 时间窗口:start_time/end_time(yyyy-MM-dd HH:mm:ss),并需指定时间类型(如下单时间或最后修改时间),单次窗口不宜过大,大促期间建议按小时切片。 4. 可选店铺编号 shop_no、订单状态 status 等条件收窄范围。 ### 响应结构 返回 status=0 时,data 中包含订单总数与 trades 数组:trade_no(系统单号)、tid(平台单号)、shop_name、trade_status、pay_status、receiver_name/address/mobile、goods_list(货品编号 spec_no、数量 num、成交价 price、实付 paid)等。对账场景重点使用 paid、post_fee、refund_status 字段,注意退款中的订单金额口径。 ### 集成建议 轻易云默认按"最后修改时间"增量拉取,并以 trade_no + 明细序号作为幂等键写入财务对账库。

代码示例

curl
curl -X POST "https://api.wangdian.cn/openapi2/trade_query.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "sid=myshop&appkey=AK123&timestamp=1780000000&sign=SIGN" \
  --data-urlencode "start_time=2026-06-01 00:00:00" \
  --data-urlencode "end_time=2026-06-01 01:00:00" \
  -d "pageno=0&pagesize=100"

错误码

错误码消息含义
100sign 校验失败签名错误,检查参数排序与 secret
102appkey 无权限未开通 trade_query 接口授权
105timestamp 过期时间偏差超过 5 分钟