旺店通与金蝶云星空供应链集成接口字段手册权威教程

这个接口解决什么问题

在零售与电商企业的中后台架构中,旺店通承担电商WMS/ERP前端单据入口,金蝶云星空则负责财务与供应链中台核算。两者之间的销售出库、采购入库、调拨、退货、基础资料等单据若靠手工录入,极易出现库存口径不一致、应收应付错账、跨组织对账困难等问题。本教程聚焦"旺店通↔金蝶云星空"供应链集成的接口字段实战,让读者一次性掌握23条策略的核心字段、映射规则与落地经验。

接口能力总览

• 认证方式:旺店通侧采用应用级API密钥签名;金蝶云星空侧采用WebAPI登录票据+组织编码,二者在轻易云适配器中均封装为可视化凭证。
• 请求结构:旺店通以shop_no、start_time/end_time、status作为入参;金蝶以FormId(如SAL_OUTSTOCK)+FieldKeys+FilterString查询。
• 响应结构:均为JSON数组+分页游标。旺店通支持页号/页大小,金蝶支持Limit/StartRow。
• 分页/增量模式:旺店通业务单据以modified_time时间窗增量为主,金蝶侧以FModifyTime或单据编号区间增量,物料首次全量、后续按FModifyTime增量。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台中,旺店通与金蝶云星空分别有官方适配器,只需选择源/目标系统并填写凭证即可。

• 适配器:平台内置"旺店通·企业奇门""金蝶云星空"两个适配器,封装了签名、登录、分页逻辑。
• 字段映射器:在策略画布里,通过拖拽完成源字段→目标字段的1:1、函数、映射表、常量四类映射;AfterSourceInvoke钩子可注入运费拆行等自定义逻辑。
• 编码映射:物料/客户/仓库/组织四类映射表可上传Excel初始化,平台会按主键自动查询;缺失编码会写入失败记录表并告警。
• 调度:平台提供cron表达式与错峰配置,删除90天数据这类维护策略可指定每日02:00低峰执行。

跨方案实战要点

1. 基础资料先行:物料(M)策略必须先于业务策略上线,否则出入库会因为找不到物料编码而批量失败。
2. 查询预加载是关键:查询金蝶收料通知单(L)与查询入库单(K)虽不产生下游单据,但为C/D等策略提供联查数据源,务必先跑。
3. 单据类型用常量区分:销售出库、寄售、调拨、其他出入库在金蝶端是不同FBillTypeID,不要复用同一编码。
4. 店铺即客户,仓库即组织:这是零售电商最常见的混淆点,务必维护两份独立映射表。
5. 增量窗口按业务量设定:日单量大时增量窗口建议15~20分钟,避免单次拉取超限。
6. 运费拆行用钩子实现:post_amount>0时,通过AfterSourceInvoke在明细行追加虚拟规格码x0001,避免总单据金额不平。

踩坑复盘

• 坑1:物料编码未提前同步。多个客户项目里,业务策略上线后才发现旺店通货品在金蝶找不到,整批失败。稳妥做法是物料策略先全量跑一次,再启动业务策略。
• 坑2:时区不一致导致日期错位。旺店通默认UTC+8,金蝶按服务器时区,跨时区时FDate会偏一天。务必在适配器里统一时区配置。
• 坑3:店铺与客户映射混淆。把shop_name直接当客户推送,导致应收挂到错误组织。必须区分销售组织与客户两套映射。
• 坑4:退货单未关联原销售单。src_trade_no未写入F_wk_wdtysdh,后续无法反查。需要在主表映射里加截断函数。
• 坑5:删除90天策略误删进行中数据。如果按updated_time删除而任务仍在重试,会丢失单据。建议按"已完成且超过90天"双重条件过滤。

何时选用

本教程适用于电商零售、多组织多店铺、旺店通作为前端WMS/ERP、金蝶云星空作为财务供应链中台的集成场景。若企业只用单一ERP、或旺店通与金蝶同属私有化部署且单据量极小,直接走数据库中间表即可,无需本方案;反之,凡是涉及销售、采购、库存、退货四大类单据跨系统同步,均应按本教程的23策略框架实施。