金蝶云星空分步式调出单接口字段手册权威教程（旺店通供应链集成）

这个接口解决什么问题

在旺店通与金蝶云星空的供应链集成场景里,分步式调出单承载了库存调拨出库的核心业务事实。本接口以仅查询模式从金蝶云星空拉取分步式调出单及其明细行,用于对账核对、状态跟踪、与旺店通侧出库单的源单追溯。它不向目标系统写入数据,适合做"事实表"层的数据沉淀与下游分发。

接口能力总览

• 认证方式:金蝶云星空标准 OAuth/WebAPI 鉴权,需在轻易云适配器中配置账套信息与安全令牌。
• 请求结构:基于金蝶 QueryService,表单 ID 为 STK_TRANSFEROUT,通过 FilterString 传入过滤条件(如 FApproveDate>='{{LAST_SYNC_TIME|dateTime}}'),结合 Limit/StartRow 实现分页。
• 响应结构:返回头表(FID、FBillNo、FDocumentStatus 等)与分录表(FSTKTRSOUTENTRY_FEntryID、FQty、FSrcStockID_FNumber 等)的嵌套结构。
• 分页/增量模式:推荐以**审核日期(FApproveDate)**为增量游标,辅以单据状态 C(已审核)作为过滤条件,避免把暂存、审核中数据误同步。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台中,该接口通常通过金蝶云星空查询适配器接入:选择表单 STK_TRANSFEROUT,配置账套、用户与安全令牌;在字段映射器里,平台会自动识别 FID/FSTKTRSOUTENTRY_FEntryID 为主键字段,无需手工标注。增量策略推荐使用「按审核日期增量 + 仅同步已审核」的组合过滤器,轻易云的调度器会把 {{LAST_SYNC_TIME}} 自动注入为金蝶可识别的日期时间格式。分页通过适配器的 Limit/StartRow 参数自动翻页,通常设置 2000 条/页即可。

跨方案实战要点

1. 增量游标首选 FApproveDate:在多个客户项目里,创建日期会被反审/重审操作影响,导致漏数;审核日期是更稳定的增量锚点。
2. 过滤条件必须叠加 FDocumentStatus='C':否则会拉到暂存、审核中数据,引发对账错位。
3. 第三方追溯四件套要全量落地:FThirdSystem、FThirdSrcId、FThirdSrcBillNo、FThirdSrcEntryId 缺一不可,否则后续双向对账无据可查。
4. 双单位数量要分别保留:FQty(主单位)与 FExtAuxUnitQty(辅单位)在箱规/辅单位场景下必须同时落库,避免下游计算口径不一致。
5. 跨组织调拨要走特殊分支:FTransferBizType 取值 OverOrgTransfer/OverOrgSale/OverOrgPurchase 等时,结算路径与库存影响完全不同,集成逻辑需分支处理。
6. 货主与库存组织组合判定:FOwnerID_FNumber 与 FStockOrgId_FNumber 不一致时,代表代管/寄售业务,不要直接做库存扣减。

踩坑复盘

• 踩坑一:拉到未审核单据——未叠加 FDocumentStatus='C' 过滤,导致下游消费了暂存/审核中数据,后续被反审时引发对账异常。稳妥做法:在 FilterString 中强制追加状态条件,且轻易云里建议用「已审核变更推送」事件触发兜底。
• 踩坑二:父子行被展平——分录存在父子结构(FParentRowId),直接映射会被展平,丢失层级。稳妥做法:轻易云的字段映射器里保留 FRowId 与 FParentRowId,下游按需还原。
• 踩坑三:辅单位数量丢失——只同步了 FQty,忽略了 FExtAuxUnitQty,导致箱规商品库存扣减口径错乱。稳妥做法:两个数量字段都落库,并在映射时备注单位换算关系。
• 踩坑四:源单追溯字段未回写——同步到下游后,发现 FThirdSystem 等字段为空,无法反向定位旺店通侧单据。稳妥做法:确认上游写入时四件套齐全,轻易云可在映射器里加「空值告警」拦截。
• 踩坑五:跨组织调拨的库存口径错乱——未识别 OverOrg* 类型,把跨组织调拨按组织内调拨扣减,导致库存虚减。稳妥做法:在轻易云的路由策略里按 FTransferBizType 分流,跨组织走特殊通道。

何时选用

适用于旺店通与金蝶云星空供应链集成中,需要从金蝶侧定时拉取库存调拨出库事实、构建对账宽表或下游分发的场景;不适用于需要反向写入金蝶或实时强一致库存同步的场景,后者建议改用事件推送或库存事务接口。