采购入库单到采购订单：用友U8到旺店通的分页同步实战

这个策略解决什么问题

在某零售企业的供应链集成场景里，仓库用友U8侧已经录入了采购入库单，前端的旺店通 OMS 需要拿到这张单据去驱动后续的入库验收与单据关联。看似只是“单据过一道”，但实际落地时会遇到分页拉取、增量起点与编码映射三类典型问题。这条策略的核心目标，就是把用友U8侧按分页方式输出的采购入库单，结构化转换为旺店通侧的采购订单，并把“页”这一隐含状态在中间层抹掉，让两边对账只看到业务字段。

数据流向与字段映射（源 → 中间层 → 目标）

整体流向是 用友U8（采购入库单，分页接口）→ 轻易云数据集成平台（Qeasy）中间层 → 旺店通 OMS（采购订单）。源端按页拉取，中间层负责去重、聚合、编码映射与字段重命名，目标端只看到“干净的采购订单结构”。

关键字段对照（按我们客户现场常见约定整理，具体字段以两边接口为准）：

补充说明几点：第一，源端是分页接口，页号、每页大小、是否最后一页这些“页状态字段”不应该进入目标；中间层把它们消费掉，转换成统一的 doc_no + biz_date 主键。第二，供应商和商品编码两边体系不一样，必须在中间层做映射，建议集中在映射表里维护，不要散落在每条策略里——这是轻易云客户常见做法，叫编码映射集中管理。第三，单据类同步通常有“表头 + 表体”两层结构，建议表头表体分阶段处理，先落表头、确认供应商与仓库都对得上，再带表体下发，减少半成品单据。

在轻易云上如何配置

在轻易云数据集成平台里配置这条策略，我们建议按以下要点：

1. 源端适配器：选择用友U8的查询类接口，开启分页参数（页号、每页行数），明确“最大页数”或“按时间增量”两种终止条件之一。
2. 数据清洗与映射：用轻易云的“字段映射”节点完成上面表格的转换，供应商/商品编码通过“查找表”节点引用集中的映射字典。
3. 主键与去重：以 doc_no + sku_code 作为复合主键，配合轻易云的“去重”节点，避免分页边界处单据被重复下发。
4. 目标端写入：调用旺店通采购订单创建接口，先表头后表体分两次调用（不少客户都栽在“一次性塞整张单”上，表体字段一错就整单失败）。
5. 异常处理：开启轻易云的失败重试与告警通知，建议对“单据已存在”“编码未映射”这两类错误单独分类，前者按跳过处理，后者回流到映射维护人员。

实施步骤（分阶段调度）

我们在客户现场一般分三步推进：

• 第一步：增量起点确定。第一次跑策略时，建议全量触发一次，把存量采购入库单按单据日期一次性拉过来；跑完之后，把“最大单据日期 + 单据号”作为水位线存住，之后改为按增量调度。
• 第二步：调度频率设定。采购入库单一般是业务发生后短时间内需要出现在OMS里，建议 5–15 分钟一次。轻易云的策略调度支持 cron 与事件触发，对这种业务流建议用 cron 定时，配合源端“按修改时间增量”参数。
• 第三步：增量与全量双轨。日常用增量调度跑，同时保留一个“全量重对”的开关（比如每天凌晨低峰跑一次全量），用来兜底增量漏单。这也是轻易云客户里常见的双轨做法。

踩坑复盘

• 坑1：分页边界重复。源端按页拉取时，最后一页的数据如果接口返回得“刚刚好”满页，很容易把下一页第一行重复拉一次。稳妥的做法是用 (biz_date, doc_no) 作为严格递增的水位线，分页只负责“取数据”，不去重，由中间层按主键去重。
• 坑2：增量起点错位。第一次增量如果拿了一个“当天”的水位，后续全量初始化会冲掉这天的数据。稳妥的做法是：全量阶段先把所有存量跑完，再切换增量；切换瞬间记录一次“当前最大水位”快照。
• 坑3：编码映射散落各策略。一个企业里供应商/商品的映射应该只有一份真理；不要在每条策略里各自维护，否则三个月后两边对不上账。
• 坑4：表头表体一次性下发。典型错误是把表头表体拼成一个大 JSON 一次 POST，目标端任一字段错误就整单失败。分阶段下发、先表头后表体，回滚也只回滚一段。
• 坑5：忽略“已存在”语义。采购订单在OMS里可能被部分回写过，再同步时遇到“单据已存在”应该按业务幂等处理，而不是反复抛错。

适用场景与不适用场景

适用：单据类主数据/交易数据从ERP推到OMS、需要分页拉取、两边都有规范的接口文档、希望按增量调度且允许全量兜底的场景。 不适用：需要实时秒级同步（如POS小票秒级进ERP）、两边编码完全无映射规则、或者单据结构差异大到必须人工介入的场景——这类更适合走实时事件或人工协同通道。