轻易云
注册体验
POSThttps://openapi.yonyoucloud.com/yonbip/sd/voucherorder/listaccess_token

销售订单列表查询

YonBIP 销售管理域销售订单列表接口,POST JSON 分页查询订单头与行信息,支持按时间、状态过滤,用于电商/经销商订单回写 ERP 后的核对与下游同步。

## 接口说明 该接口属于 YonBIP 销售云(sd 域),用于分页查询销售订单列表。请求方式为 POST + application/json,业务参数放在 JSON body 中,access_token 随 URL query 传递。典型场景:经销商门户或电商中台写入 YonBIP 销售订单后,财务与供应链系统通过本接口回拉订单状态、金额与发货进度,完成对账与履约跟踪。 ### 请求要点 1. URL 携带 access_token;header 为 Content-Type: application/json。 2. body 中 pageIndex(页码,从 1 开始)、pageSize(每页条数,建议 ≤100)控制分页;返回中 pageCount/totalElements 用于判断是否翻完。 3. 查询条件一般通过条件对象传入,如按制单时间、订单状态(voucherState)、客户编码过滤;具体条件字段以租户 YonBIP 版本的 API 文档为准。 4. 增量同步建议使用订单修改/审核时间作为游标,窗口向前重叠 5-10 分钟防止边界丢单。 ### 字段说明 返回 data 为订单数组,常见字段包括:订单号 code、客户 customer、单据日期 vouchdate、税率与金额(taxRate、origMoney、origTaxMoney)、明细行 orderDetails(物料 product、数量 quantity、含税单价 taxUnitPrice)等。金额字段注意币种与价税分离口径,写入财务系统前需统一。

代码示例

curl
curl -X POST "https://openapi.yonyoucloud.com/yonbip/sd/voucherorder/list?access_token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pageIndex":1,"pageSize":100,"beginTime":"2026-06-01 00:00:00","endTime":"2026-06-02 00:00:00"}'

错误码

错误码消息含义
00000success成功
20002token 失效access_token 过期,需重新调用 getAccessToken
40000参数错误分页或条件参数不合法,检查 pageIndex/pageSize 与时间格式