领星售后手工单同步金蝶其他出库单：单策略实战教程
这个策略解决什么问题
在跨境电商或全渠道零售场景里，售后手工单往往不在标准出库流程里——客服手工补发、换货、损耗出库都会落到这类单据。如果只在领星ERP里记账，金蝶云星辰的实物库存就会逐渐失真：账面有货、仓库没有，财务结账时两边数字对不上。
我们这次在客户现场要做的，就是把领星的售后手工单按发货时间增量抓回来，在轻易云数据集成平台里转换为金蝶的其他出库单，并通过 audit 直接审核，让两边库存口径在当天内收敛。
数据流向与字段映射
数据流向非常清晰：领星ERP → 轻易云集成平台 → 金蝶云星辰。中间层不承担业务逻辑，只做字段重命名、编码映射和时间窗控制。
关键字段对照（按素材中的请求体整理）：
| 业务含义 | 领星源字段 | 轻易云中间字段 | 金蝶目标字段 | 说明 |
|---|---|---|---|---|
| 单据编号 | global_order_no | global_order_no | bill_no | 售后手工单唯一号 |
| 出库日期 | global_delivery_time | global_delivery_time | bill_date | 转 datetime 类型 |
| 业务类型 | — | 固定值 | trans_type_id | 其他出库单填 13 |
| 操作类型 | — | 固定值 | operation_key | audit 直接审核 |
| 单据备注 | remark | 模板拼接 | remark | `领星多平台订单：售后手工单店铺 |
| 商品行 | material_entity | 编码映射后 | material_entity | 领星 SKU → 金蝶物料编码 |
表头和表体在轻易云里分两个阶段处理：先把单据头落到金蝶，再批量写入物料行，最后再触发审核。
在轻易云上如何配置
在轻易云数据集成平台里，这条策略对应一个"源执行器 + 目标执行器"的标准组合。
源端（领星）
- 接口：
/pb/mp/order/v2/list，POST。 - 时间窗：
date_type=global_delivery_time，start_time用{{DAYS_AGO_s10}}，end_time用{{CURRENT_TIME}}，避免漏单。 - 分页：
offset=0，length=100，领星上限 10000，按需调整。 - 幂等键：
global_order_no开启idCheck，重复单据直接跳过。
目标端（金蝶）
- 接口：
/jdy/v2/scm/inv_other_out，POST。 - 固定值写入：
trans_type_id=13、operation_key=audit。 - 表体物料编码走集中编码映射表，把领星 SKU 翻译成金蝶物料编码，避免在每条策略里硬编码。
- 单据备注用模板字符串统一拼接，便于售后对账。
轻易云侧的常用应对模式
- 编码映射集中管理：所有 SKU / 仓库 / 客户映射放在一张映射表，多条策略共享。
- 表头表体分阶段：先落头再写行，失败可重试，不会出现"半张单"。
- 增量与全量双轨：日常走增量（按
global_delivery_time），首次上线或断点恢复时跑一次全量补齐。
实施步骤
阶段一：初始化（首次上线）
- 在轻易云里建立领星和金蝶两个数据源的连接，完成 token 拉取策略验证。
- 把历史售后手工单按
global_delivery_time跑一次全量，写入金蝶并audit。 - 抽取一条样本，检查
bill_no、bill_date、material_entity是否对得上。
阶段二：增量起点确认
- 取全量结束时刻作为增量起点
start_time，避免重复或漏单。 end_time设为调度执行时刻，由轻易云模板变量{{CURRENT_TIME}}自动填充。
阶段三：调度频率
- 领星源端：
20 3-5 * * *（凌晨 3:20 起每小时一次，覆盖跨日单据）。 - 金蝶目标端：
59 1-4 * * *（凌晨 2:00 前完成审核，赶在结账前）。 - 轻易云侧按"源先写、目标后写"的依赖关系串行触发。
阶段四：上线后观察
- 头一周每天核对一次两边库存差异；稳定后改为抽样核对。
- 监控轻易云运行日志里的失败条数，重点看
idCheck命中和映射失败两类。
踩坑复盘
-
时间窗太短会漏单。领星的
global_delivery_time有跨日更新的情况，最初我们只取当天，结果第二天对账发现少了一批发货。稳妥做法是start_time回退 10 天（DAYS_AGO_s10），让窗口覆盖延迟更新。 -
直接
audit的副作用。金蝶接口里operation_key=audit会立刻审核，一旦表体物料编码写错，库存就被错误扣减。我们后来改成"先 submit 自查 → 再 audit"的两步法，在轻易云里拆成两个执行器。 -
物料编码硬编码在策略里。早期版本把 SKU 映射直接写在字段转换里，新增一个仓库就要改 N 条策略。后来全部抽到轻易云的集中映射表，策略只引用映射表名。
-
global_order_no重复。同一个售后单可能在领星里被多次编辑，idCheck一定要开，否则金蝶会生成多张重复出库单。 -
库存为负不报错。金蝶其他出库单在库存不足时默认允许负库存，容易掩盖问题。建议在轻易云侧加一个前置校验：领星可用量 < 出库量时直接拦截，人工确认后再放行。
适用场景与不适用场景
适用：跨境电商、全渠道零售，需要把第三方 ERP 的售后手工单按发货口径实时同步到财务/库存系统，库存口径必须当日收敛。
不适用：领星和金蝶属于同一组织内的多套账；需要按订单生命周期多状态联动的复杂场景（这类更适合走中间表 + 状态机）。