外部 ERP 与 WMS 对接边界

当前可依据什么做沟通？

单体版仓库保留 OpenAPI 契约，管理端和 PC 端提供依据该契约生成接口类型的命令。

公开契约、所属域用例和数据范围是沟通输入。外部系统名、版本、接口文档和测试授权需由客户提供。不能让对接程序直接跨域写私有表，也不能把一个同名字段认作同一业务语义。

映射表应包含什么？

对象	需要确认
商品	SPU/SKU、单位、上下架与审核来源
价格	币种、含税口径、精度及有效期
库存	可售、预占、实物、仓库与更新时间
订单	业务单号、成交快照、取消与重复处理
发货	包裹行、数量、运单与状态回传

同步方式如何选择？

实时请求、定时批次或消息推送需要外部系统能力配合。选择时明确顺序、重复、延迟和失败处理；推荐设计不意味着源码已经带有目标系统连接器或消息中间件交付。

怎样验收连接器？

1. 脱敏样本确定字段、单位与标识映射。
2. 验证正常下发、重复、乱序、超时和撤销。
3. 保留源结果、目标结果及差异，不仅统计HTTP成功。
4. 明确补偿入口、人工处理和双方责任，以项目范围确认上线条件。

基于开放接口同步商品、库存、订单与发货，提供失败重试与对账；15 个工作日交付。

接入范围见ERP对接和WMS对接，客户侧授权与接口变更不由此文形成承诺。