## 接口说明
gy.erp.trade.get 分页查询管易云 ERP 内的订单数据,返回订单头、商品明细、金额与状态信息。管易另有历史订单接口 gy.erp.trade.history.get(查询已归档订单)与详情接口 gy.erp.trade.detail.get(按单号查明细),三者配合覆盖全量订单取数。
### 请求要点
1. 按调用规范构造 appkey/sessionkey/method/sign,业务参数同包提交。
2. 分页:page_no(页码,从 1 开始)、page_size(每页条数);返回 total 为条件下总条数,据此翻页。
3. 常用过滤条件:start_date/end_date(时间窗口,需明确口径是下单还是修改时间)、shop_code(店铺代码)、order_state(单据状态)、code(订单号精确查)。
4. 明细行在订单对象的 details 数组中:item_code(商品代码)、sku_code、qty(数量)、price、amount 等。
### 集成场景
- 订单 → ERP 销售订单:以管易为订单中台,把订单推送到金蝶/用友生成销售订单与应收;
- 财务对账:以实收金额、运费、优惠金额与平台账单三单匹配;
- 售后链路:退货单走 gy.erp.trade.return.get 单独同步,与正向订单以原单号关联。
### 幂等
轻易云以订单号 + 明细序号作为幂等键,重复拉取/重推不会产生重复下游单据。
### 历史订单回补
较早的订单会归档,gy.erp.trade.get 查不到,需要改用 gy.erp.trade.history.get;首次对接做全量回补时,应先跑历史接口再切换到增量,避免时间轴上留下空洞。归档接口字段结构与在线接口基本一致,但响应更慢,回补任务要压低并发并设置断点续传。