调拨入库对接金蝶其他出库单（负数）：库存同步策略实战教程

这个策略解决什么问题

在某零售/制造企业的供应链集成场景中，仓库间的库存调拨需要在源系统产生"入库"业务，而在下游财务/库存系统则需要以"其他出库（负数）"的形式登记，以实现收发平衡与账实一致。这个策略就是把源系统的调拨入库单据，按规则转化为下游系统的其他出库单（数量为负），完成跨系统的库存业务闭环。

数据流向为：源端（调拨入库业务系统） → 轻易云数据集成平台（中间转换层） → 目标端（金蝶云星空其他出库单）。

关键字段对照表如下：

业务含义	源端字段	中间层处理	目标端字段	备注
入库单号	goodsdocNo	直接透传	FJKYNo	单据编号
调拨单号	sourceBillNo	直接透传	FJKYLinkNo	关联上游单据
单据类型	—	常量赋值	FBillTypeID	QTCKD95_SYS
库存组织	goodsDocDetailList_ownerName	编码映射	FStockOrgId	集中维护
库存方向	—	常量赋值	FStockDirect	GENERAL
业务日期	源端创建时间	格式标准化	FDate	yyyy-MM-dd

数量字段在转换层做取反处理，将入库正数转换为出库负数，这是本策略的核心逻辑。

在轻易云数据集成平台中，这条策略作为一条独立的集成流进行配置。

源端配置：API 类型为 WebAPI（POST），分页参数 pageIndex/pageSize 默认 0/50，按创建时间窗口增量拉取（startDate 用上次同步时间，endDate 用当前时间）。

目标端配置：调用 batchSave 接口写入金蝶云星空，单据类型固定为 QTCKD95_SYS，库存方向固定为 GENERAL。

编码映射集中管理：库存组织、仓库、物料等编码在轻易云的映射表中统一维护，避免散落在多个策略里。常见做法是先跑基础资料同步（客户、供应商、物料），再跑业务单据，本策略应依赖物料同步完成后再启用。

分阶段调度，避免一上来就跑全量导致目标系统压力过大。

第一阶段——增量起点初始化。首次执行时手动指定一个历史时间点作为 LAST_SYNC_TIME，确保从该时间点开始增量拉取，避免历史数据全量涌入。

第二阶段——全量触发（可选）。如果历史数据需要补传，在轻易云里配置一次性全量任务，拉取完整时间窗口的入库单，转换后写入目标端。全量完成后立即切换到增量模式。

第三阶段——日常调度。源端建议每 2 小时拉取一次（避开整点高峰），目标端写入建议错峰调度（例如每小时 59 分执行）。轻易云提供 crontab 表达式直接配置调度频率。

第四阶段——监控与对账。每日业务结束后，通过轻易云的运行日志核对源端单据数与目标端写入数是否一致，发现差异立即排查。

数量符号忘记取反：这是最典型的错误。调拨入库是正数，到了金蝶其他出库必须是负数，否则库存账实会越差越大。务必在转换脚本里显式做 -qty 处理，并加单元测试。
编码映射散落在多个策略里：库存组织、物料编码如果在每条策略里各写一套，后期维护成本极高。建议在轻易云里集中建一张映射表，所有策略引用同一份。
时间窗口跨调度周期丢数据：如果源端单据创建时间在调度边界附近，可能出现一条单据被两个周期重复拉取或漏拉。稳妥的做法是让 startDate 比上次同步时间早 1-2 分钟，endDate 比当前时间晚 1-2 分钟，留出缓冲。
依赖关系没配置：本策略依赖物料、客户等基础资料同步，如果上游基础资料没跑通就启用业务单据同步，会导致目标端写入失败或编码错乱。
全量和增量切换时机不对：全量跑完后如果忘了切回增量，会导致每天重复拉取历史数据，目标系统压力大且产生大量重复单。

适用场景：多组织、多仓库的零售或制造企业，需要把上游业务系统的调拨入库业务同步到金蝶云星空进行库存账务处理。不适用场景：单组织、单一系统的企业无需此集成；如果下游不是金蝶云星空或单据类型不是"其他出库"模式，需要重新设计字段映射与单据类型常量。