Qeasy Cloud
Get Started
GEThttps://api.yonyouup.com/api/saleorderlist/batch_gettoken(query 传参)

Batch Get Sales Orders (saleorderlist/batch_get)

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

## Overview saleorderlist/batch_get is the sales-management batch query of the U8 open platform. U8 OpenAPI read endpoints uniformly use GET, with both the auth material (token, from_account, to_account, app_key, app_secret) and the business filters carried in the URL query string; responses are JSON. ### Request essentials 1. Exchange a token via system/token first, then append it to this endpoint's query. 2. Paginate with page_index and rows_per_page. Keep pages small (50-100 rows): the underlying EAI layer is slow on large result sets. 3. Common filters: date range (dDate start/end), order code cSOCode, customer code cCusCode; confirm exact condition fields against the API-center page of this endpoint. 4. The saleorderlist array in the response carries header fields such as cSOCode, dDate, cCusCode and cPersonCode; entry rows require the order detail endpoint keyed by the header id. ### Integration notes - U8 OpenAPI rides on EAI, so throttle bulk sync and avoid U8 peak windows (month-end closing). - Qeasy runs U8 order sync incrementally on approve/modify time and uses cSOCode as the idempotency key so downstream systems never see duplicate orders. ### Performance and patches Field semantics vary across U8 OpenAPI patch levels, so confirm the customer's patch version before mapping fields. Some tenants report pagination being ignored with the full result returned at once — protect production jobs with timeouts and batch guards against oversized responses, because a single runaway call can stall the underlying EAI service for everyone.

Code examples

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"

Error codes

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