## 接口说明
/jdy/v2/scm/sal_order_list 是星辰供应链域(scm)销售订单列表接口,GET 方式分页返回销售订单头数据(单据编号 billno、客户、单据日期、金额、状态等);单据明细行可用销售订单详情接口 /jdy/v2/scm/sal_order(按 id 查)获取。
### 请求要点
1. 鉴权:先换 app-token,再按星辰签名规则构造 X-Api-* 请求头与 X-GW-Router-Addr(见鉴权文档)。
2. 分页:page(页码)、page_size(每页条数,建议 ≤100);返回 total 判断翻页。
3. 常用过滤:bill_no(单号)、create_time 起止、modify_time 起止(增量同步游标)、bill_status(单据状态)、customer_id(客户)。
4. 响应 errcode=0 时,data.rows(或按版本 data.list)为订单数组;金额字段注意币别与含税口径,写入下游前统一。
### 集成场景
- 私域/经销商门户订单 → 星辰销售订单的写入(反向用 POST /jdy/v2/scm/sal_order)后,用本接口回拉核对;
- 财务核算:按审核状态过滤已生效订单,生成应收账款底表;
- 以 modify_time 为增量游标,bill_no + 明细序号作为幂等键写入数据仓库。
### 版本兼容
星辰接口分 V1、V2 两个时代的网关与鉴权方式,本文是 jdy/v2 现行体系;老客户早期基于 V1 网关的对接,迁移时除了换地址,还要用 app_key/app_secret 重新走授权,旧 token 不能平滑复用,需规划好凭据切换窗口,避免切换期间同步中断。