商城对接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 主数据。把两者分开,是避免数据被覆盖的关键。
关于价格如何展示,商城系统功能规划与开发费用指南第二节提到 B2B 的客户等级价与阶梯价。这类价格依赖商城侧的客户档案与登录身份,属于本文第四节要单独讨论的情况。
四、库存数据:最容易出问题的地方
1. 同步内容
| 字段 | 说明 |
|---|---|
| 实物库存 | 仓库实际可用数量 |
| 可用库存 | 扣除预占后的可销售数量 |
| 预占库存 | 已下单未支付或已锁定的数量 |
| 在途库存 | 采购在途、调拨在途 |
| 多仓库存 | 各仓库分仓库存及分配规则 |
| 库存变动 | 入库、出库、调拨、盘盈亏引起的变化 |
2. 权威源:ERP 或 WMS
库存数据由 ERP(或 WMS)作为权威源,一般做绝对值覆盖推送给商城。但具体怎么算可售量,要看库存架构。
3. 可售量计算:避免超卖的关键
商城本地存在”用户下单未支付”的预占库存,因此可售量需要结合本地预占计算:
但这里有个前提:如果 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 侧如何承接;
- ⑧ 是否需要对接其他系统?——要接哪些系统、各自同步什么数据;
- ② 谁卖给谁?——决定会员与客户的归属方向;
- ⑤ 最核心的业务流程是什么?——决定订单同步的字段范围与状态节点。
专题页第十二节给出的预算优先顺序,也对应接口的分期:优先保证核心交易流程能正常运行(商品与订单同步)、优先保证数据和订单可靠(幂等与重试)、特殊业务功能优先于”看起来高级”的功能(库存与对账优先于复杂报表)。
关于预算规划顺序的完整展开,商城系统功能规划与开发费用指南第十四节的核心判断是:先做需求范围,再谈价格。对接口而言,需求范围就是”要同步哪些数据、以谁为准、往哪个方向”。
九、常见误区与落地建议
- 接口先打通再想数据归属。没有权威源,两边都能改,上线就乱。
- 所有数据都做双向同步。双向等于没有归属,冲突不可避免。
- 商品主数据与营销内容混在一起。ERP 被商城的详情图冲刷,或营销内容被主数据覆盖。
- 会员以 ERP 为准。注册与等级变化发生在商城,ERP 只接收不回写。
- 成本价同步到商城。成本价属于敏感数据,只应在 ERP 与内部管理侧可见。
- 价格全部由 ERP 下发。阶梯价与客户等级价依赖商城侧客户档案,通常由商城计算。
- 把 ERP 库存直接当成可售量。忽略本地预占,极易超卖。
- 没确认 ERP 是否已做预占。多渠道下重复扣减,可售量虚低。
- 只做增量同步。一旦漏推,差异永久存在,无法自愈。
- 只做定时全量。高频全量压垮接口,库存实时性差。
- 订单推送不做幂等。网络超时重试后生成两笔销售订单。
- 超时只重试不查状态。其实已成功,重试变成重复。
- 没有对账机制。差异长期累积,最终无法解释。
- 财务数据让商城能修改。商城应只读展示,直接改 ERP 财务数据会造成账务失控。
- 基础资料编码不统一。商品、供应商、仓库编码对不上,后续全部同步失效。
- 一次把七个接口全做完。一期先做商品与订单,跑通后再接库存、会员、财务。
- 忽略接口监控与告警。失败只有人工发现,往往已经影响订单。
归根结底,商城系统库所强调的一点是:商城建设不是把功能清单做得越长越好,接口开发也不是把两个系统”连起来”就算完成。更合理的方式,是先确定每类数据的权威源与同步方向,再把字段映射、幂等、重试和对账逐项落实;接口范围同样要按核心交易链路排序,先跑通商品与订单,再扩展库存、会员与财务,通常比一期把所有接口全部接完更加稳妥。
本文由 李东旭 结合多年网站、商城、小程序及互联网系统规划与开发经验整理完成。
部分内容在整理过程中使用人工智能工具辅助进行资料归纳、结构梳理和文字表达优化, 但文章的选题、核心观点、经验判断及最终内容均由作者本人审核确认。 AI在这里主要作为内容整理工具,不替代实际经验与独立判断。
作者:
李东旭
|
个人博客:
lidongxu.com
运营主体:
北京金雨科技有限公司
|
官方网站:
金雨科技官网