销售出库单到销货单:聚水潭与畅捷通T+账期同步实战
畅捷通T+聚水潭供应链集成销售订单同步账期路由轻易云
这个策略解决什么问题
电商订单从聚水潭推到畅捷通T+做财务记账,看似只是单据搬家。但当客户按账期结算(如京东自营类店铺),不同店铺走不同资金通道,账期口径不一致,财务对账就会出问题。一次实际项目中,某零售企业同时运营多家自营店铺,我们用轻易云数据集成平台(Qeasy)把聚水潭的销售出库单按账期拆开,分别落到T+的对应账套里,让单据流和资金流对齐。
数据流向与字段映射
整体流向是:聚水潭(B端)→ 轻易云中间层 → 畅捷通T+(A端)。
| 业务含义 | 聚水潭(源) | 轻易云中间层 | 畅捷通T+(目标) |
|---|---|---|---|
| 单据编号 | io_id(出库单号) | io_id | VoucherCode(销货单号) |
| 店铺编码 | shop_id | shop_id + 账期标记 | DepartmentCode(部门/账套) |
| 客户/经销商 | customer_id | 编码映射 → CustomerCode | CustomerCode |
| 商品编码 | sku_id | 编码映射 → InventoryCode | InventoryCode |
| 出库数量 | qty | qty | Quantity |
| 含税单价 | price | price | TaxPrice |
| 税额 | tax | tax → 折算 | TaxAmount |
| 账期标记 | (源端无显式字段) | 由 shop_id 路由策略注入 | 写入单据表头自定义项 |
关键点:账期标记在源端并不存在,是我们基于店铺编码在中间层注入的。客户现场常见做法是把"店铺—账期"对应关系放到轻易云的编码映射表里集中管理,这样新增店铺只要改一张映射,不必改策略。
在轻易云上如何配置
在 Qeasy 上配这条策略,典型步骤是四步:
- 数据源注册:分别接入聚水潭(开放平台)与畅捷通T+(T+ 接口),凭据统一放在轻易云的连接器里,不写死在脚本里。
- 抓取策略:聚水潭侧用
io_query拉销售出库单,按modified_start/modified_end增量;首次跑全量用date_type=2加创建时间窗口。 - 中间层转换:在轻易云的转换器里做三件事——商品/客户编码映射、店铺→账套路由、单据表头表体拆分。这里我们习惯把表头(店铺、账期、订单时间)和表体(行项目)分两个阶段处理,先落表头再带行项目推目标,避免 T+ 单据头未生成时行项目被丢。
- 写入策略:调畅捷通T+的销货单新增接口,按账套号分流,失败的单据进容错队列,由人工补单或定时重跑。
实施步骤
我们给客户落地时,通常按三阶段推进:
- T0 全量触发:先用一次性全量把历史出库单补齐;为了不堵塞 T+,按店铺分批跑,每批 200 单,跑完一批再开下一批。
- T1 增量起点:以切换日为分界,
modified_start取切换日零点,之后按调度周期增量。 - T2 调度频率:电商场景出库密集,调度间隔一般设 5–15 分钟;账期类账套可以放到 30 分钟到 1 小时,跑批前先做单据去重(按 io_id 在轻易云中间表判重)。
稳妥的做法是增量与全量双轨:全量补历史,增量跟日常,互不干扰。
踩坑复盘
- 账期不是字段,是路由规则。典型错误是试图在聚水潭里找一个"账期"字段,最后发现要靠店铺编码反查。这里容易翻车——店铺编码在聚水潭里是数字串,到 T+ 又是另一套编码,中间必须有一张映射表集中维护。
- 表头与表体不要一次塞过去。T+ 的销货单新增接口对表头依赖强,表头没成功直接丢行项目。重做法是先写表头,落中间表,记成功标志,再带表头 ID 推表体,幂等性更好。
- 幂等键要选准。我们用
io_id + 行号作为幂等键,避免重跑时重复推单;如果只取io_id,整单重复时 T+ 侧会拒收。 - 税率与含税价折算。聚水潭给的是含税价,T+ 销货单通常要拆成不含税单价 + 税额。税率以单据日期为准,而不是商品档案,跨月单据要特别注意。
- 容错要分层。网络抖动、T+ 临时不可用是常态;我们让轻易云把失败单据分两类:可重试(网络/锁)自动重跑,需人工的(字段缺失、编码未映射)进待办队列,避免"全量失败"的误报。
适用场景与不适用场景
适用:多店铺多账期的电商零售,需要按账期/账套切分单据流向的场景;聚水潭作为交易前台、T+ 作为财务后台的典型组合。不适用:单店铺单账期的简单同步(一条规则跑到底即可,无需路由层);以及需要实时秒级回写的场景——本策略走调度模式,分钟级延迟是预期内的。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-p9210a3-jushuitan-9687-bd-bf-7e6a410e