轻易云
注册体验
GEThttps://api.yonyouup.com/api/saleorderlist/batch_gettoken(query 传参)

销售订单列表批量获取(saleorderlist/batch_get)

U8 OpenAPI 销售订单列表接口,GET + token 分页批量拉取销售订单头信息,支持按日期、单据号条件过滤,是经销商订单与电商订单回写 U8 后核对的标准取数口。

## 接口说明 saleorderlist/batch_get 是 U8 开放平台销售管理类接口,用于批量获取销售订单列表。U8 OpenAPI 的查询类接口统一采用 GET 方式,鉴权参数(token、from_account、to_account、app_key、app_secret)与业务参数都放在 URL query 中,响应为 JSON。 ### 请求要点 1. 先用 system/token 换取 token,再拼接到本接口 query 中。 2. 分页参数 page_index(页号)与 rows_per_page(每页行数,注意单页不要过大,U8 EAI 层处理大结果集较慢,建议 50-100)。 3. 过滤条件常用:日期范围(如 dDate 起止)、单据号 cSOCode、客户编码 cCusCode;条件字段以 API 中心该接口文档为准。 4. 返回体中 saleorderlist 为订单数组,包含 cSOCode(订单号)、dDate(单据日期)、cCusCode(客户)、cPersonCode(业务员)等表头字段;明细行需结合订单详情接口或按主表 ID 再查。 ### 集成注意 - U8 OpenAPI 底层走 EAI,大数据量同步要控制频率并避开 U8 业务高峰(月末结账)。 - 轻易云对 U8 订单增量同步通常以审核时间/修改时间做游标,且以 cSOCode 作为幂等键防止下游重复建单。 ### 性能与补丁 不同 U8 版本的 OpenAPI 补丁对字段口径存在差异,对接前应确认客户环境的接口补丁级别;实践中部分客户反馈大结果集时分页参数不生效(一次性返回全部),生产任务要针对超大响应设置超时与分批保护,防止长事务拖垮 EAI 服务。

代码示例

curl
curl -G "https://api.yonyouup.com/api/saleorderlist/batch_get" \
  --data-urlencode "from_account=source_acc" \
  --data-urlencode "to_account=u8_acc" \
  --data-urlencode "app_key=your_app_key" \
  --data-urlencode "app_secret=your_app_secret" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode "page_index=1" \
  --data-urlencode "rows_per_page=100"

错误码

错误码消息含义
0成功查询成功
20005U8 服务调用失败EAI 执行异常,检查 U8 服务端与接口补丁版本
token失效token 无效或过期errcode 非 0 且提示 token 相关错误时,重新获取 token 再重试