## 接口说明
/erp/opentrade/list/trades 查询万里牛 ERP 内的销售订单(open trade 域),返回订单头、商品明细、金额与状态信息。万里牛作为全渠道订单中台,聚合了 30+ 电商平台的订单,本接口把这些订单以统一结构开放给外部系统,适合同步进 ERP(金蝶/用友)生成销售订单与应收,或进入财务对账库。
### 请求要点
1. 按调用规范构造 _app/_t/_sign,业务参数以 form 提交。
2. 分页:page、limit(每页条数);也可按 bill_code(系统单号)精确查询单个订单。
3. 时间/状态等过滤条件以官方接口文档为准;增量同步建议以订单修改时间窗口推进并重叠数分钟。
4. 返回 data 中订单数组含系统单号、平台单号、店铺、状态、实付金额、商品明细(SKU、数量、单价)等;发货状态跟踪可配合订单状态流转接口(/erp/opentrade/trade/commit)理解状态机。
### 集成注意
- 万里牛拆单后一个平台单号可能对应多个系统单号,下游建单应以系统单号为幂等键、平台单号为关联键。
- 大促期间订单量激增,分页窗口切片 + 失败重试 + 幂等写入是稳定同步的三件套,轻易云方案默认内置。
### 与发货/售后的衔接
订单履约的后续状态(发货、签收)会回流到订单状态;售后单(退款、退货)是独立的单据域,需要单独接口拉取并以原订单号关联。对账场景要把正向订单、售后单、平台结算单三类数据齐备后再跑匹配,否则匹配引擎会把“售后未同步”误判为金额差异,产生大量无效工单。