先确定每类数据的主系统

商品、价格、库存、订单和物流状态不应该在每个系统中都被视为最终权威。项目开始时，需要明确每类数据由哪个系统创建、哪个系统可以修改，以及冲突时采用什么规则。

例如 ERP 可以管理商品主数据和可售库存，独立站负责接收订单，仓库系统负责出库与物流信息。明确边界后，字段映射和同步方向才不会反复变化。

状态映射比接口调用更重要

不同系统对“已付款”“已确认”“待发货”“部分发货”和“已完成”的定义可能不同。同步设计需要建立明确的状态表，并说明每一次转换由什么事件触发。

  • 订单编号和外部引用必须稳定
  • 部分取消和部分退款需要单独处理
  • 库存预占和实际扣减要区分
  • 物流事件必须保留原始时间
关键原则：先确定数据责任、同步方向和失败处理，再开始编写接口代码。

通过幂等和重试避免重复订单

网络超时并不代表对方没有成功处理请求。每个写入操作都应携带可重复识别的业务键，并在重试前查询结果，避免重复创建订单、重复扣减库存或重复发送通知。

重试应区分临时故障和永久错误。权限失效、字段缺失和业务规则冲突不能通过无限重试解决，需要进入人工处理队列。

让同步过程可以被看见

运营人员需要看到同步状态、失败原因、最后成功时间和受影响对象，而不是只能查看服务器日志。建议为同步任务建立业务级日志、异常筛选和手动重试入口。

在正式上线前，应使用真实数据副本覆盖订单高峰、库存为零、部分退款、物流回传延迟和接口限流等场景。