
企业客户、渠道客户在建设商城时,通常需要同时连接ERP、WMS、CRM、支付和物流系统。真正困难的并不是“有没有接口”,而是库存、订单、商品、客户和履约状态分别由谁负责,以及不同系统之间如何保持数据一致。
如果企业继续依靠Excel导入、人工录单或定时批处理,业务量增加后容易出现库存超卖、订单重复、发货状态滞后和财务对账困难。本文将从业务问题出发,说明企业商城如何通过开放API对接ERP与WMS,明确系统边界、实施步骤和可验证的业务价值,为系统选型与项目落地提供判断依据。
为什么企业商城与ERP、WMS需要打通?
企业商城负责客户下单、商品展示、价格策略和交易体验;ERP通常负责商品主数据、采购、销售、财务或客户信息;WMS则聚焦仓储作业、库存数量、库位、拣货、出库和退货。
当这些系统彼此独立运行时,常见问题主要包括以下几类:
| 业务问题 | 直接影响 | 长期风险 |
|---|---|---|
| 商城库存与仓库库存不同步 | 客户下单后缺货或取消订单 | 影响渠道信任和复购 |
| 订单需要人工录入ERP | 订单处理时间延长 | 录入错误、重复下单 |
| WMS发货状态未回传商城 | 客户无法查看准确进度 | 客服咨询量增加 |
| 商品编码、单位不一致 | 接口匹配失败或数据错配 | 财务与库存核算困难 |
| 退货状态没有形成闭环 | 可售库存恢复不及时 | 产生库存积压或账实差异 |
因此,系统集成的重点不是简单地把ERP和WMS“接进来”,而是建立统一的数据流和业务责任边界。
开放API集成应该解决哪些核心问题?
1. 明确谁是数据源头
不同数据应由不同系统负责维护,避免多个系统同时修改同一字段。
| 数据对象 | 建议主责系统 | 商城侧主要用途 |
|---|---|---|
| 商品编码、名称、规格 | ERP或主数据系统 | 商品展示和下单识别 |
| 销售价格、渠道价格 | ERP、价格中心或商城 | 价格展示与交易校验 |
| 可售库存 | WMS、ERP或库存中心 | 控制前端可下单数量 |
| 订单信息 | 商城 | 触发后续审核、出库和履约 |
| 仓储出库状态 | WMS | 回传发货和物流信息 |
| 订单结算与财务状态 | ERP或财务系统 | 对账与收入核算 |
具体归属需要根据企业现有系统确定。关键是形成一份书面的数据主责清单,并在项目开始前完成确认。
2. 建立稳定的接口通信方式
开放API通常包括以下几种通信方式:
- 商城主动调用ERP或WMS接口,获取商品、库存和订单状态;
- ERP或WMS通过回调接口,将库存变化、出库结果和物流信息推送至商城;
- 通过消息队列或中间件处理高并发、异步通知和失败重试;
- 通过定时任务执行数据补偿,处理网络异常或接口短暂不可用的情况。
对于库存和订单这类关键数据,不建议只依赖单次同步。接口设计应至少考虑身份认证、参数校验、幂等处理、超时控制、日志记录和失败重试。
3. 统一编码、单位和状态
接口对接失败,很多时候不是技术问题,而是基础数据规则没有统一。例如:
- 商城使用SKU编码,ERP使用物料编码;
- 商城按“件”销售,WMS按“箱”出库;
- 商城状态为“已支付”,ERP状态为“待审核”;
- WMS拆分发货,但商城只支持单一物流单号。
在开发前,应建立字段映射表和状态映射表,明确每个字段的格式、长度、是否必填、默认值及异常处理方式。
库存与订单数据应该如何设计同步流程?
库存同步:先区分实物库存与可售库存
商城前端展示的库存,不一定等于仓库中的实物库存。通常需要考虑已锁定库存、质检库存、在途库存、残次品库存和安全库存。
一种常见的可售库存计算方式是:
可售库存 = 实物库存 - 已锁定库存 - 安全库存 - 不可销售库存
库存同步流程可以设计为:
- ERP或WMS提供库存基础数据;
- 库存中心或商城接收库存变更;
- 系统根据销售渠道、仓库和安全库存计算可售数量;
- 商城更新商品库存并控制下单;
- 出现同步失败时,进入重试和人工核查队列;
- 按小时或按日进行库存对账。
对于高频变化的库存,建议采用“实时变更通知+定时全量校准”的组合方式,既降低延迟,也避免长期累积差异。
订单同步:明确订单状态与履约状态
商城订单不应直接等同于仓库出库单。建议将订单拆分为交易状态和履约状态:
- 交易状态:待支付、已支付、待审核、已取消、已退款;
- 履约状态:待出库、拣货中、部分发货、已发货、已签收、退货中。
典型订单流程如下:
- 客户在商城提交订单;
- 商城完成支付、价格和库存校验;
- 商城生成唯一外部订单号;
- 订单通过API推送至ERP或WMS;
- ERP或WMS返回接收结果和内部单号;
- WMS执行拣货、复核和出库;
- WMS回传发货单号、物流信息和发货时间;
- 商城更新客户可见状态;
- 取消、退款或退货时,系统同步释放或恢复相应库存。
订单接口必须具备幂等机制。相同外部订单号重复提交时,目标系统应返回原处理结果,而不是创建第二笔订单。
系统集成实施应该分为哪些步骤?
第一步:梳理业务流程和系统边界
项目组应先绘制商品、库存、订单、发货、退货和对账流程图,回答以下问题:
- 商城面向哪些客户和销售渠道?
- 一个订单是否可能对应多个仓库?
- 是否支持拆单、合单和部分发货?
- 库存由ERP、WMS还是独立库存中心维护?
- 订单取消的截止时间是什么?
- 退货入库后由谁确认可售?
- 哪些异常需要自动重试,哪些必须人工处理?
这一阶段的产物应包括业务流程图、系统边界清单、数据主责表和异常场景清单。
第二步:完成接口和字段设计
接口设计至少应包含:
- 接口名称与业务用途;
- 请求和返回字段;
- 字段类型、长度和必填规则;
- 编码、单位和状态映射;
- 鉴权方式与传输安全要求;
- 超时、重试和幂等规则;
- 错误码及处理方式;
- 日志、监控和告警要求。
对于库存、订单和发货接口,应特别定义唯一业务标识,例如外部订单号、SKU编码、仓库编码和物流单号。
第三步:分环境开发与联调
建议至少划分开发、测试和生产环境,避免测试数据进入真实业务系统。联调可按以下顺序进行:
- 商品与基础资料同步;
- 库存查询和库存变更;
- 下单与订单接收;
- 取消、退款和库存释放;
- 出库、发货和物流回传;
- 退货入库和库存恢复;
- 财务对账与异常补偿。
每完成一类接口,都应记录请求报文、响应报文、业务结果和异常原因,不能只以“接口返回成功”作为验收标准。
第四步:开展异常与压力测试
测试不应只覆盖正常流程,还应覆盖:
- 重复推送同一订单;
- 库存不足时下单;
- 接口超时或返回空数据;
- WMS部分发货;
- 订单取消与出库同时发生;
- 商品编码不存在;
- 物流单号重复;
- 网络恢复后的数据补偿;
- 同一SKU多仓库存同时变化。
测试结果应形成问题清单、责任人、修复时间和复测结论。
第五步:上线切换与持续对账
正式上线前,应确认历史数据、未完成订单、库存初始值和接口权限。切换期间可以采用分批上线方式,先选择一个渠道、一个仓库或一部分SKU进行验证。
上线后,应持续关注:
- 订单接收成功率;
- 库存同步延迟;
- 订单状态回传完整率;
- 接口失败重试次数;
- 商城库存与仓库库存差异;
- 订单与财务系统对账差异。
项目责任边界应该如何划分?
系统集成项目容易延期,常见原因是“接口由谁改、数据由谁确认、异常由谁处理”没有提前约定。
| 工作内容 | 商城方责任 | ERP/WMS方责任 | 企业业务方责任 |
|---|---|---|---|
| 商城订单接口 | 提供接口和调用规则 | 接收并返回处理结果 | 确认订单业务规则 |
| 商品与SKU映射 | 支持字段配置 | 提供主数据 | 确认编码和规格关系 |
| 库存同步 | 展示和控制可售库存 | 提供库存数据 | 确认安全库存和仓库策略 |
| 发货状态回传 | 更新客户侧状态 | 提供出库和物流结果 | 确认履约节点定义 |
| 异常处理 | 提供日志和重试机制 | 提供错误码和补偿能力 | 指定人工处理责任人 |
| 上线验收 | 配合技术测试 | 配合接口联调 | 组织业务验收和最终确认 |
企业方最好指定一名项目负责人统一协调业务、技术、仓储和财务部门,避免不同部门分别提出互相冲突的接口要求。
如何判断ERP与WMS集成方案是否可行?
选型时不能只看“是否支持API”,还应从以下维度判断:
接口开放能力
重点关注是否支持标准REST API、Webhook、批量接口、分页查询、签名认证、幂等控制和失败重试。
业务覆盖能力
确认方案是否覆盖商品、库存、订单、发货、取消、退款、退货和对账,而不是只实现订单创建。
数据治理能力
查看是否支持字段映射、编码转换、状态转换、数据校验和异常数据修正。
运维可视化能力
接口出现异常后,是否能够查看请求记录、响应结果、失败原因和重试状态。没有可追踪日志的集成项目,后期排障成本通常更高。
扩展与责任边界
需要明确新增仓库、新增渠道或新增业务状态时,哪些内容可以通过配置完成,哪些需要二次开发,以及相关变更由哪一方负责。
匿名示例:多仓企业如何验证接口集成价值?
以下为用于说明实施方法的匿名示例,不代表LegendShop客户案例或已公开项目数据。
背景
某企业拥有企业商城、ERP和两套WMS,商城服务企业客户和渠道客户。上线前,订单由运营人员导入ERP,仓库根据内部单据处理发货,商城库存每天人工更新一次。
挑战
- 不同仓库使用不同库存编码;
- 同一订单可能拆分到两个仓库;
- 商城库存更新存在时间差;
- 发货状态不能自动回传;
- 订单取消后,库存释放依赖人工操作。
方案
项目组先确定ERP负责商品和客户主数据,WMS负责仓储库存及出库状态,商城负责交易订单和客户侧展示。随后通过开放API完成商品、库存、订单、发货和退货接口,并增加订单幂等、库存校准和失败重试机制。
实施过程
项目分为四个阶段:
- 完成SKU、仓库和订单状态映射;
- 先打通单仓订单和库存流程;
- 验证拆单、部分发货、取消和退货;
- 扩展至第二个仓库并进行全量对账。
已确认的验收结果口径
项目验收不以“接口已开发完成”为标准,而以以下指标确认是否达到上线要求:
- 订单重复推送不产生重复订单;
- 正常订单能够完成接收、出库和