按资料类型确定维护来源
商品、客户、价格、库存与单据可能由不同系统维护。逐项决定哪一端是业务资料的主要维护入口,另一端怎样接收变更。双向同步需要明确冲突规则,避免两个部门同时修改后互相覆盖。
例如ERP维护采购和库存,商城承接客户订货,就要确认商城商品编号如何对应ERP,订单何时传入ERP,库存按现存、可用还是指定口径返回商城。
建立稳定编号对应关系
商品编码、SKU、单位、客户、仓库与组织的编号都需要对应。名称可以改变,外部关联不能只依赖名称相等。遇到一端一条档案对应另一端多条规格时,要单独设计映射。
准备字段表,写出来源字段、目标字段、类型、是否必填、单位和示例。缺少对应关系时应形成可处理的异常,而不是自动创建一个可能重复的客户或商品。
明确单据何时同步与何时允许修改
订单创建、审核、出库和退货是不同时间点。确定哪一个节点发送、接收后允许哪些修改,以及变更如何传递。客户改地址或取消剩余商品时,还要核对另一端是否已经开始履约。
如果只同步订单总金额而没有行明细、单位和优惠口径,仓库与财务可能无法解释后续差额。接口清单应覆盖原单、明细与需要追溯的业务关系。
库存与价格按业务口径同步
库存同步需要说明仓库范围、可用量口径、占用与更新时间。商城允许下单不等于ERP一定能立即发货;断网或延迟时如何提示和处理,也需要业务规则。
价格同步应区分基础价、客户价和活动价,确认优先级与生效时间。单位或币种不一致时先转换和核对,再决定是否允许自动写入。
处理重复、超时与失败
同一请求可能因网络超时被再次发送,接收端需要识别是否已经处理。约定稳定业务编号、重试规则与查询方式,避免一笔订单创建多次。
失败清单要能显示业务对象、失败阶段、原因和处理状态。业务人员负责补齐资料或确认业务,技术人员负责接口故障;重试前先核对外部系统的实际结果。
以场景验收接口
联调覆盖正常订单、修改、取消、部分发货、退货,以及重复通知和失联恢复。每项保存请求、结果与双方业务单据,并处理敏感信息。
接口的可交付范围、第三方提供的能力和开发工作量按实际确认。上线后持续观察失败数量与处理时效,让接口故障能够进入日常协作流程。