金蝶云星空销售出库单查询接口字段手册权威教程（逐行查询模式）

这个接口解决什么问题

在零售与电商企业的供应链里，金蝶云星空负责财务与库存记账，管易云承担前端订单与发货。两者之间最关键的纽带就是「销售出库单」：发货动作一旦在管易完成，仓库需要在金蝶生成出库凭证，反过来物流单号、收货地址、出库明细也要回流到管易对账。executeBillQuery 的逐行查询模式（FormId=SAL_OUTSTOCK）正是这条链路的数据源头，它让下游系统能够按明细行粒度稳定地拉取增量出库数据。

接口能力总览

• 认证方式：基于金蝶云星空私有化部署的用户名/密码 + 数据中心授权，使用 API 网关调用 executeBillQuery。
• 请求方法：POST，表单 ID 固定为 SAL_OUTSTOCK（销售出库单）。
• 字段键：通过 FieldKeys 集合按需声明，如 FEntity_FENTRYID、FCustomerID.FNumber、FMaterialID.FNumber 等。
• 过滤条件：FilterString 默认按审核日期增量，典型写法 FApproveDate>='{{LAST_SYNC_TIME|datetime}}'，可叠加 FBillNo、FStockOrgId.FNumber 等业务条件。
• 分页参数：Limit 控制单次最大行数（建议 2000–5000），StartRow 为起始行索引，TopRowCount 默认 0。金蝶逐行模式下必须靠分页拉完所有页才能进入下一窗口。
• 响应结构：返回明细行集合，metadata 中 id 指向 FEntity_FENTRYID，number 指向 FBillNo，idCheck: true 启用主键校验，autoFillResponse: true 自动补齐响应字段。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台里，这套接口的封装非常直接：平台内置金蝶云星空适配器，只需填写私有化部署的访问地址、账号与数据中心 ID，即可获得开箱即用的 executeBillQuery 调用能力。

• 数据源配置：选择「金蝶云星空」适配器，填入私有化网关与认证信息，平台会自动维护 Token 与重试。
• 元数据映射：在轻易云字段映射器里，把 metadata 的 id 指向 FEntity_FENTRYID，number 指向 FBillNo，平台会自动启用主键校验和响应字段补齐。
• 过滤与分页：用平台变量 LAST_SYNC_TIME、PAGINATION_PAGE_SIZE、PAGINATION_START_ROW 拼装 FilterString，轻易云会按页迭代取完所有行。
• 调度策略：建议 */5 7-23 * * * 这种白天高频、夜里停跑的窗口，轻易云的调度器会自动处理漏跑补偿与失败告警。
• 空写入策略：本接口是纯查询策略，Target 配置成「写入空操作」即可，轻易云会跳过下游写入，只产出数据流供其他策略订阅。

跨方案实战要点

1. 逐行模式必须按行主键去重：FEntity_FENTRYID 才是逐行粒度的唯一标识，FID 在分页时会出现重复，千万别混用。
2. 增量游标选 FApproveDate 而非 FDate：FDate 可被反审/修改，用 FApproveDate 才能保证增量稳定不漏单。
3. 分页大小要贴合金蝶性能：实测单页 2000–5000 行最稳，超过 1 万容易触发金蝶侧超时与内存压力。
4. 单据类型必须参与路由：B2C、零售、寄售、VMI 在财务和库存账上完全不一样，拿到 FBillTypeID_FNumber 后建议立刻分支处理。
5. 跨系统对账锚点选 FThirdEntryId：它就是管易订单号，与发货明细一对一映射，是物流回写、退款对冲的天然桥梁。
6. 隐私字段最小化传输：收货人姓名、手机、地址这类字段应按需裁剪，并尽量在落地端做脱敏，避免合规风险。

踩坑复盘

1. 用 FID 做主键导致重复入库：逐行查询返回的是明细行集合，FID 在每行里都相同，会重复入库。稳妥的做法是 metadata 把 id 显式指到 FEntity_FENTRYID。
2. FDate 增量游标被反审吃掉：业务方反审后修改出库日期，导致按 FDate 增量出现断档。我们后来统一改成 FApproveDate 才稳定下来。
3. 分页参数越界引起接口超时：单页 5 万行的激进配置在金蝶私有化环境直接超时。稳妥的做法是把 Limit 控制在 2000–5000，并设置合理的分页间隔。
4. B2C 与标准出库混算金额：B2C 出库通常含税且走电商结算，不分离单据类型会导致毛利严重失真。务必在拿到 FBillTypeID_FNumber 后分支处理。
5. 承运商/物流单号回写丢失：FCarriageNO 在多次修改物流后会覆盖旧值，回写管易要做版本控制，否则会出现旧物流单覆盖新物流单。

何时选用

适用场景：需要按明细行粒度把金蝶销售出库数据同步到管易或其他下游系统，做对账、物流回写、电商订单关联。不适用于：单据写入回传（应改用保存/审核接口）、实时逐单查询（应改用单据详情接口）、跨主体多账套混合查询（需要拆分数据源）。