ERP 与仓配系统对账集成
把 ERP 出库与仓配实绩拉齐：失败可重试、差异可对账、切换可回滚，结束月末人工对表。
背景
ERP 管订单与财务，仓配系统管拣货出库；两端靠人工导出 Excel 对账，月末经常对不齐。
曾尝试厂商“标准接口包”，因字段语义不一致与权限申请卡住，半途停摆。
财务希望跨月前能自动发现差异；仓储希望不影响现有作业节奏。
约束
- ERP 仅开放有限 API + 只读视图，禁止改存储过程
- 仓配侧高峰时段不可长时间锁单，同步必须可削峰
- 上线窗口卡在盘点月前，必须先灰度再全量
真正的难点
难点不在“调通一个接口”，而在主数据以谁为准、部分失败如何补偿、以及业务能否在链路抖动时继续出货。
关键取舍
先做接口探查周，再锁工期
用两周验证鉴权、分页、字段空值与生产/文档差异。探查结论写入风险清单后，才签 12 周交付包，避免“按文档排期、按现实翻车”。
以出库实绩为履约事实，ERP 为财务事实
明确两套事实源与对账规则：数量/批次差异进队列，人工裁定后回写。不假装实时绝对一致。
双写观察期 + 一键停同步
灰度期保留旧导出流程作对照；同步异常可熔断，业务回退人工补录路径，避免仓配停摆。
怎么做的
建设同步服务：订单下发、出库回传、库存水位抽检；失败入死信队列并告警。
对账台：按日/单号展示差异、责任方建议与处理状态；财务可导出审计痕迹。
监控覆盖成功率、延迟、积压深度；盘点月前完成两仓灰度后全量。
可核对的结果
月末对账从 2–3 人日 → 半日内关闭差异队列替代全量 Excel 对表
出库回传自动率 > 98%剩余进入人工兜底，可追踪
灰度 3 周零停业切换熔断演练 2 次，业务侧可独立执行
厂商接口包项目重启成功关键是探查与对账规则，而非再买一套中间件
复盘
- 集成立项前先问清：主数据归属、失败重试、对账人、回滚权——九问里答不上来就别排开发。
- “标准接口包”失败，常常败在语义与权限，不败在有没有 HTTP。
- 给业务一条比系统更慢但可用的人工路径，比承诺永不失败更负责任。
技术栈
Node.js消息队列PostgreSQLPrometheus/告警ERP/WMS 适配层