ERP / 供应链对接

一、为什么私域商城要对接 ERP

当订单量上来后，最贵的成本往往是人工：运营在商城改库存、仓管在 ERP 出库、财务两边对账。“小程序显示有货、仓库实际无货”是最常见的一类事故，根因通常就是两套库存没有实时同步。ERP/供应链对接的目标，是让商品主档、可售库存、订单出库、售后回传成为一条可信链路。

看店通可按项目对接常见进销存、ERP、WMS 或品牌中台，采用 API/中间表/消息队列等方式。对接深度取决于对方系统开放能力。库存侧能力见 库存与仓储，履约见 订单履约。

二、典型对接范围

2.1 商品主档

同步范围通常包括 SKU 编码、条码、规格、单位、成本价与上下架状态，售价则视管理方式决定由哪一侧维护。建议以 ERP 或中台作为商品主数据源，商城只负责销售属性、图片与详情装修，避免两边同时修改主档。编码规则是整个对接的地基：SKU 编码必须全局唯一且不可复用，停售商品的编码不要回收给新品，否则历史订单与库存流水都会串号。对接前应先做一次主档清洗，把重复建档、规格描述不一致、条码缺失的商品处理干净，再开始联调，这一步省不得。

2.2 库存

需要同步的库存口径包括可售库存、锁定库存、在途库存与安全库存，可按仓库或门店分仓同步，多门店场景见 多门店管理。同步策略要在实时性与系统压力之间取平衡：日常可采用增量推送加定时全量校准（例如每日凌晨对一次总账），大促期间对热销 SKU 提高同步频率并预留一层安全水位，把线上可售量设为实物库存的 80%～90%。另外建议约定一个原则——库存以 ERP 为准，商城只做扣减申请，避免两边都能直接改数导致谁也说不清真实可售量。

2.3 订单与出库

支付成功的订单下发至 ERP 或 WMS，出库结果与运单号回传商城，用户即可在小程序查看物流轨迹。缺货、地址异常、超区无法配送等异常单必须有明确的状态回传与客服处理路径，不能停在“已下发”状态无人跟进。接口设计上有两点务必落实：一是幂等，同一订单重复下发不能产生两张出库单，通常以商城订单号作为唯一幂等键；二是重试与告警，网络抖动时自动重试若干次，仍失败则进入异常队列并通知责任人，而不是静默丢弃。建议保留双向的同步日志，出问题时能快速定位是哪一侧没有收到消息。

2.4 售后

退货入库、换货、退款结果都需要回传，保证财务账与库存账一致。实务中最容易出错的是部分退货：一张订单退其中一件时，退款金额如何分摊优惠、退回的商品算不算良品、是否重新上架可售，这三个问题要在需求阶段就定好规则。虚拟资产同样要按规则回退，积分按实退金额回收、优惠券视情况恢复可用，详见 用户资产。建议每月做一次退货差异盘点，核对系统退货数量与仓库实收数量，差异超过千分之几就应追查流程漏洞。

三、对接方式对比

四、项目落地步骤

建议按 定制开发流程 推进：需求澄清（主数据以谁为准、仓库映射、售后责任）→ 字段对照表 → 联调环境 → 灰度门店/仓库 → 全量。上线后用 经营数据看板 与对账报表监控差异单。预算因接口复杂度差异大，请参考 小程序商城报价 并 联系咨询 评估。

五、实施与运营建议

对接类项目最忌讳双方各派一个技术对接人就开工。建议企业指定一名业务负责人拍板主数据归属与售后责任边界，再由技术负责人牵头字段对照与联调。上线前用真实商品、真实仓库做一次全链路演练：下单、下发、出库、回传运单、签收、退货入库、退款与积分回退，每个环节都要能在两套系统中查到对应记录。演练中发现的口径冲突（例如 ERP 的“可用库存”是否已扣除在途）必须写进对照表，避免上线后各算各的。

看店通（深圳市达希科技有限公司）在交付中通常建议“先闭环、后加深”：第一期只做商品、库存、订单、出库四类核心同步，把链路跑稳；第二期再加售后回传、批次效期、财务对账等复杂场景。灰度也要分两层——先选 1 个仓库或 2～3 家门店跑两周，再扩到全量。若企业内部已有 IT 团队或中间件平台，请在需求阶段同步接口文档、测试环境与限流策略，减少联调等待。

上线后请建立每日核对、每周复盘的节奏：每天看同步失败队列与差异单数量，每周看超卖发生次数、订单下发延迟、退货入库及时率与对账差异金额。出现异常时按“先看日志、再看映射、最后看业务规则”的顺序排查，多数问题出在映射关系而非接口本身。接口有变更时务必保留版本记录与回滚方案，不要在大促前一周上线新的同步逻辑。

六、常见问题

是否必须一次上齐所有能力？

不必。多数企业更适合分期：第一期跑通商品主档与库存同步，第二期做订单下发与出库回传，第三期再做售后、批次与财务对账。分期的前提是编码规则与字段对照表在第一期就定稳，因为主数据一旦错乱，后续每一期都要返工。

对接需要多长时间？

时间主要取决于对方系统的开放程度。对接有成熟开放接口的云 ERP，字段清晰的情况下通常 2～4 周可完成联调；传统本地部署的 ERP 若只能走中间表或文件交换，往往需要 4～8 周，还要预留对方 IT 或原厂商的排期。建议在合同中把对方的配合时间与接口文档交付时间写清楚，这是项目延期最常见的原因。

ERP 没有开放接口怎么办？

可以考虑三条路径：一是让 ERP 原厂开发接口，最规范但成本与排期不可控；二是走数据库中间表或定时文件交换，实现快但实时性差，适合日订单量不大的场景；三是引入 iPaaS 中间件做编排与监控，适合系统较多、需要长期维护的企业。无论哪种方式，都要先确认对方允许的访问方式与数据安全要求，不要绕过 IT 直接读写生产库。

七、写给决策者的小结

ERP 与供应链对接应服务明确的经营目标，而不是为了系统打通而打通。把目标写成可验证的句子（例如“上线 8 周后超卖订单降到每月 3 单以内”或“月度对账差异金额低于营业额的 0.1%”），再倒推需要同步的数据范围与组织分工。看店通可以提供标准产品能力与定制扩展，但项目能否按期完成，很大程度取决于对方系统的配合度。

若你仍在多方案之间犹豫，建议准备同一份业务样例（含商品主档、库存扣减、订单下发与部分退货），让候选服务商分别说明实现方式与异常处理机制，比较的是工程严谨度与服务响应方式，而不是方案文档的厚度。确认合作后冻结首期范围、把二期需求单列预算，是控制项目风险最有效的管理动作之一。