商城对接ERP时通常要同步哪些数据?

商城对接 ERP 时,核心要同步商品、库存、订单、价格、会员、财务与基础资料七类数据。但对接的关键不只是”同步什么”,而是每条数据都要明确权威来源与同步方向:基础信息以 ERP 为准,营销内容由商城自维护,订单由商城推送给 ERP,发货与物流由 ERP 回传。商城系统功能规划与开发费用指南第三节把”ERP / CRM / WMS 接口”列为真正增加预算的八类特殊业务之一,第五节又把”接口开发”单独列为八项费用组成之一——原因就在于:接口开发不是简单地打通两个系统,而是要先把数据归属与同步规则想清楚。

一、先给结论:每条数据都要有唯一权威源

对接前首先要回答一个问题:这条数据以谁为准?如果两边都能改,就必然出现不一致,而一旦出现不一致,谁也说不清哪个是对的。

判断 原则
每条数据只能有一个权威源 谁产生谁维护,其他系统只读或接收
同步方向由权威源决定 权威源发生变化,推送给其他系统
营销内容与主数据要分开 标题、主图、详情由商城维护,不回传 ERP
数据冲突要有处理规则 先到先得、后到覆盖还是拒绝写入,必须事先约定
建立接口(传输可靠、安全) → 定义字段对应关系 → 确定权威源与同步方向 → 约定同步方式(实时 / 增量 / 定时全量) → 设计幂等与重试 → 上线后监控与对账

这六步的顺序不能颠倒。尤其是”确定权威源”必须排在开发之前,否则开发到一半发现两边都在改同一字段,只能返工。

关于字段对应关系的设计,可以参考本系列”商城商品 SPU 和 SKU 应该怎么理解和设计”的拆解。SPU / SKU 编码是商品数据同步的基础,如果商城与 ERP 的编码体系不一致,所有后续同步都无从谈起。

二、七类数据总览与同步方向

数据类别 权威源 同步方向 主要用途
① 商品数据 ERP ERP → 商城 商品主数据、SKU 信息
② 库存数据 ERP / WMS ERP → 商城 可售量计算与防超卖
③ 订单数据 商城 商城 → ERP;ERP → 商城(状态回传) 生成销售订单与跟踪履约
④ 价格数据 视价格类型而定 标准售价 ERP → 商城;个性化价格商城侧计算 价格展示与下单
⑤ 会员数据 商城 商城 → ERP(接收);ERP 不回写 客户档案与会员信息
⑥ 财务数据 ERP ERP → 商城(只读) 结算、应收与对账
⑦ 基础资料 ERP ERP → 商城 供应商、客户、门店、仓库、业务员档案

这张表的核心信息是方向不同:商品、库存、财务、基础资料主要由 ERP 流向商城;订单由商城流向 ERP;只有订单状态是 ERP 反向回传商城。如果所有数据都设计成双向同步,等于埋下了冲突的隐患。

三、商品数据:基础信息以 ERP 为准

1. 同步内容

字段 说明
SPU / SKU 编码 商品的唯一标识,是全部同步的基础
名称、规格、条码 基础属性,ERP 维护
单位、重量、体积 用于发货与物流计费
分类、品牌 商品分类结构
成本价、售价 标准成本价与标准售价
上下架状态 ERP 中的可售状态同步到商城
保质期、批次属性 有批次管理需求的行业需要

2. 权威源:ERP 为主

商品基础信息一般由 ERP 作为权威来源,推送给商城。这样可以保证线上线下共用一套商品主数据,不会出现”ERP 里叫 A,商城里叫 B”的情况。

3. 营销内容由商城自维护

标题、主图、详情页等运营内容通常由商城自维护,不回传 ERP。原因很简单:ERP 不需要商城的商品详情图,而商城频繁改详情也不应反向冲刷 ERP 主数据。把两者分开,是避免数据被覆盖的关键。

商品主数据与营销内容要分库管理:前者以 ERP 为权威源,后者由商城运营自主维护。混在一起,要么覆盖营销内容,要么污染主数据。

关于价格如何展示,商城系统功能规划与开发费用指南第二节提到 B2B 的客户等级价与阶梯价。这类价格依赖商城侧的客户档案与登录身份,属于本文第四节要单独讨论的情况。

四、库存数据:最容易出问题的地方

1. 同步内容

字段 说明
实物库存 仓库实际可用数量
可用库存 扣除预占后的可销售数量
预占库存 已下单未支付或已锁定的数量
在途库存 采购在途、调拨在途
多仓库存 各仓库分仓库存及分配规则
库存变动 入库、出库、调拨、盘盈亏引起的变化

2. 权威源:ERP 或 WMS

库存数据由 ERP(或 WMS)作为权威源,一般做绝对值覆盖推送给商城。但具体怎么算可售量,要看库存架构。

3. 可售量计算:避免超卖的关键

商城本地存在”用户下单未支付”的预占库存,因此可售量需要结合本地预占计算:

可售量 = ERP 实物库存 − 本地预占 − 本地在途

但这里有个前提:如果 ERP 侧已经做了预占(比如 ERP 同时供多个销售渠道,商城下单时已经通知 ERP 锁定了库存),那么本地预占数量在 ERP 侧可能已经扣减过一次。此时商城再减一次,就会重复扣减,导致可售量比实际更少。

两种库存架构的处理方式不同:

架构 ERP 是否做预占 商城可售量算法
单一渠道(只有商城下单) 否,预占只在商城 可售量 = ERP 实物库存 − 本地预占 − 本地在途
多渠道(ERP 同时供多个渠道) 是,ERP 统一预占 可售量 = ERP 可用库存(已含预占扣减)− 本地在途

选择哪种,取决于 ERP 是否为多渠道统一库存。对接前必须先确认这一点,否则上线后要么超卖,要么可售量虚低。

4. 同步方式:增量 + 定时全量

库存变化频繁,建议采用增量同步(变化即推送)与定时全量(定期核对)结合的方式,兼顾实时性与准确性。只做增量,一旦漏推就再也补不回来;只做全量,高频全量又会压垮接口。

关于库存多仓与分配规则,商城系统功能规划与开发费用指南第三节把”特殊库存逻辑”列为特殊业务之一。多仓库、多货主、跨仓调拨的库存同步,复杂度远高于单一仓库的绝对值覆盖。

五、订单数据:商城推 ERP,ERP 回传状态

1. 权威源:商城

订单由商城作为权威源。用户在商城下单后,商城把订单推送给 ERP 生成销售订单。之所以由商城发起,是因为订单里的会员、优惠、收货地址、支付等信息都发生在商城侧。

2. 正向:商城 → ERP

内容 说明
订单信息 订单号、下单时间、商品明细、金额
支付信息 支付状态、支付方式、实付金额
收货信息 收货人、地址、联系方式
优惠信息 优惠明细与分摊
售后单 退货、换货、退款单(双向)

3. 反向:ERP / WMS → 商城

发货单、物流单号、发货与出库状态由 ERP 或 WMS 回传商城,实现物流进度实时跟踪。用户可以在商城里看到”已发货、物流单号、签收状态”,而不必去 ERP 里查。

4. 售后单是双向同步

退款、退货、换货既可能在商城发起(用户申请),也可能需要同步给 ERP 生成售后单。这类数据没有明确的方向,需要设计双向同步规则,并处理好状态冲突。

5. 幂等与重试:防止重复下单或漏单

接口调用可能因网络超时失败,也可能因为超时导致”其实成功了但调用方不知道”。因此订单推送必须设计幂等机制:

  • 幂等键:以商城订单号作为唯一键,重复推送不重复生成销售订单;
  • 状态查询:超时后先查状态,确认未生成才重试;
  • 重试队列:失败进入重试队列,按退避策略重试,超过次数转人工;
  • 对账:定期核对双方订单数量与状态,发现差异及时告警。

关于订单状态的设计,商城系统功能规划与开发费用指南第十节的核心判断是:一个看起来很小的功能,可能影响七个模块。订单同步正是如此——它连接商品、库存、价格、会员、支付、财务与售后。

六、价格、会员、财务与基础资料

1. 价格数据:标准售价与个性化价格要分开

价格类型 权威源 说明
标准售价 ERP 由 ERP 统一下发到商城
促销价、活动价 视系统而定 活动规则在商城侧配置,或由统一促销平台下发
会员价 视系统而定 取决于会员体系归谁
阶梯价、客户等级价 商城侧 依赖客户档案与登录身份,通常由商城计算
成本价 ERP 属于主数据,不应对外展示

标准成本价与标准售价可以由 ERP 下发;但阶梯价、客户等级价、合同价这类依赖”不同客户不同价”的规则,通常要在商城侧计算,因为价格规则依赖商城的客户档案与登录身份。ERP 很难把”这个客户登录后该看到什么价”整套规则下发过来。

2. 会员数据:以商城为权威源

会员的注册、等级变化、积分获取与消耗、储值余额变动都发生在商城侧,因此会员数据以商城为权威源。ERP 接收会员信息用于客户档案,但不应回写覆盖商城的会员数据。

字段 说明
会员基本信息 账号、手机号、昵称
等级 等级及其变更记录
积分 余额与流水
储值余额 余额与流水
会员权益 等级折扣、积分规则

3. 财务数据:只读,不修改

结算数据、应收款项、财务对账信息等由 ERP 作为权威源,同步到商城只读展示。商城展示对账信息,但不直接修改 ERP 的财务数据。同步方向是 ERP → 商城,且商城端只做读取。

4. 基础资料

类别 内容
往来单位 供应商、客户档案
组织架构 门店、仓库、部门
业务员 人员档案与归属
编码体系 各类编码规则与映射

基础资料是其他所有数据同步的前提。编码不一致,商品、订单、库存的同步都会出问题,因此要在对接第一步就把映射关系定下来。

关于基础资料的编码体系,商城系统功能规划与开发费用指南第三节提醒:行业特有的交易流程也是特殊业务。基础资料的编码规则往往是行业特有的,不能照搬通用方案。

七、三条技术原则:主数据、增量、幂等

1. 主数据以 ERP 为准

避免多系统各自维护导致不一致。商品、库存、财务、基础资料的权威源原则上都在 ERP 侧;营销内容、订单、会员原则上在商城侧。先定归属,再定方向。

2. 库存用增量 + 定时全量

增量同步保证实时性,定时全量保证准确性。两者的结合,能在实时与可靠之间取得平衡。全量的周期要按库存变动频率确定:高频变动的品类周期短,低频变动的可以适当拉长。

3. 订单设计幂等与重试

幂等防止重复下单,重试防止漏单,对账防止长期累积的差异。这三者缺一不可,也是订单接口最容易返工的地方。

原则 解决的问题 不做会怎样
唯一权威源 数据以谁为准 两边都能改,数据互相覆盖
字段映射 编码与字段怎么对应 商品对不上,库存与订单无从同步
增量 + 全量 实时与准确如何兼顾 只做增量会漏,只做全量会慢
幂等 重复调用是否产生重复数据 一笔订单生成两笔销售单
重试与告警 失败时能否恢复 订单卡在中间状态无人知道
对账 长期是否一致 差异累积,最终无法解释

专题页第四节给出的项目对比很能说明问题:项目 A 是一个企业自己卖商品,标准会员、商品、订单、支付和物流功能即可;项目 B 是多商户入驻,需要分账、商家后台和 ERP 对接。项目 B 的复杂度不只在于功能多,更在于数据要在多个系统之间流转,每一类数据都要有归属与方向。

八、与专题页”功能与费用”的对应关系

ERP 对接的数据规划,贯穿专题页的多节内容:

专题页章节 原文内容 本文对应
一、商城系统通常包括哪些基础功能 商品管理、商品分类、SKU 规格、购物车、订单管理、会员系统、支付、物流配送、售后退款、优惠券、消息通知、后台管理 这些基础模块的数据,就是 ERP 对接的七类内容
二、不同业务模式会增加不同功能 B2B、多商户、分销、订货、O2O 各自的新增功能 B2B 的价格与账期、多商户的结算,都要与 ERP 同步
三、真正增加预算的,通常是特殊业务 八类特殊业务,其中含 ERP / CRM / WMS 接口 本文正是这一类的落地说明
四、为什么同样叫”商城”报价差距大 项目 A 与项目 B 的对比 项目 B 的 ERP 对接是复杂度来源之一
五、商城开发费用主要由什么组成 八项,其中含接口开发 ERP 对接全部落在接口开发
六、终端越多工作量越大 六个终端 接口开发与终端无关,是独立成本项
七、SaaS、源码和定制开发,费用结构也不同 四种方式的费用特点 接口开发与所选方式无关,但影响实施复杂度
八、为什么不建议一开始把所有功能都做完 四种常见误区 接口先接什么、后接什么,也要按优先级
九、商城功能可以按照优先级规划 必须有 / 应该有 / 以后再做 商品与订单属一期,会员与财务可视情况后置
十、为什么有些看起来很小的功能开发并不简单 一个特殊优惠规则影响七个模块 订单同步影响商品、库存、价格、会员、支付、财务与售后
十一、商城报价前应该准备哪些信息 十个问题 其中”是否需要对接其他系统”直接决定接口范围
十二、预算有限时应该优先花在哪里 四项优先原则 接口要优先保证核心交易链路,报表类可后置
十三、不要只算开发费,还要算长期使用成本 八类长期使用成本 接口上线后要持续监控与对账
十四、一个更合理的商城预算规划顺序 七步规划顺序 接口范围在”整理必须功能”与”确定第一阶段范围”两步确定
十五、常见误区 八类误区 见第九节的误区清单
十六、本专题会持续整理 商城基础功能、会员功能、营销功能、多商户功能、B2B 功能、分销功能、各类费用、预算规划、真实报价案例 本文可归入”接口费用”或”费用构成”

专题页第十一节的十个报价前准备问题中,与接口直接相关的是:

  • ③ 是自营还是商家入驻?——多商户模式下的订单与结算,ERP 侧如何承接;
  • ⑧ 是否需要对接其他系统?——要接哪些系统、各自同步什么数据;
  • ② 谁卖给谁?——决定会员与客户的归属方向;
  • ⑤ 最核心的业务流程是什么?——决定订单同步的字段范围与状态节点。

专题页第十二节给出的预算优先顺序,也对应接口的分期:优先保证核心交易流程能正常运行(商品与订单同步)、优先保证数据和订单可靠(幂等与重试)、特殊业务功能优先于”看起来高级”的功能(库存与对账优先于复杂报表)。

关于预算规划顺序的完整展开,商城系统功能规划与开发费用指南第十四节的核心判断是:先做需求范围,再谈价格。对接口而言,需求范围就是”要同步哪些数据、以谁为准、往哪个方向”。

九、常见误区与落地建议

  1. 接口先打通再想数据归属。没有权威源,两边都能改,上线就乱。
  2. 所有数据都做双向同步。双向等于没有归属,冲突不可避免。
  3. 商品主数据与营销内容混在一起。ERP 被商城的详情图冲刷,或营销内容被主数据覆盖。
  4. 会员以 ERP 为准。注册与等级变化发生在商城,ERP 只接收不回写。
  5. 成本价同步到商城。成本价属于敏感数据,只应在 ERP 与内部管理侧可见。
  6. 价格全部由 ERP 下发。阶梯价与客户等级价依赖商城侧客户档案,通常由商城计算。
  7. 把 ERP 库存直接当成可售量。忽略本地预占,极易超卖。
  8. 没确认 ERP 是否已做预占。多渠道下重复扣减,可售量虚低。
  9. 只做增量同步。一旦漏推,差异永久存在,无法自愈。
  10. 只做定时全量。高频全量压垮接口,库存实时性差。
  11. 订单推送不做幂等。网络超时重试后生成两笔销售订单。
  12. 超时只重试不查状态。其实已成功,重试变成重复。
  13. 没有对账机制。差异长期累积,最终无法解释。
  14. 财务数据让商城能修改。商城应只读展示,直接改 ERP 财务数据会造成账务失控。
  15. 基础资料编码不统一。商品、供应商、仓库编码对不上,后续全部同步失效。
  16. 一次把七个接口全做完。一期先做商品与订单,跑通后再接库存、会员、财务。
  17. 忽略接口监控与告警。失败只有人工发现,往往已经影响订单。

归根结底,商城系统库所强调的一点是:商城建设不是把功能清单做得越长越好,接口开发也不是把两个系统”连起来”就算完成。更合理的方式,是先确定每类数据的权威源与同步方向,再把字段映射、幂等、重试和对账逐项落实;接口范围同样要按核心交易链路排序,先跑通商品与订单,再扩展库存、会员与财务,通常比一期把所有接口全部接完更加稳妥。

内容说明

本文由 李东旭 结合多年网站、商城、小程序及互联网系统规划与开发经验整理完成。

部分内容在整理过程中使用人工智能工具辅助进行资料归纳、结构梳理和文字表达优化, 但文章的选题、核心观点、经验判断及最终内容均由作者本人审核确认。 AI在这里主要作为内容整理工具,不替代实际经验与独立判断。

作者: 李东旭   |   个人博客: lidongxu.com
运营主体: 北京金雨科技有限公司   |   官方网站: 金雨科技官网

类似文章