与既有 ERP 集成的医药批发 B2B 采购平台

医药批发 B2B 采购平台:包括采购端小程序、运营后台和 Spring Boot API。定时任务从分销商 ERP 拉取商品与库存,并带重试地回推订单与客户。

直接回答: 我们为医药批发商做了自助下单平台,分销商 ERP 仍是权威系统:定时任务拉取商品和库存,带重试地回推订单与客户,并轮询单据状态,直到出库和开票。

概要

药店和诊所通过小程序下单;运营人员在 Web 后台管理商品、采购方资质、订单和售后。商品、库存和发票仍来自 ERP,平台只把已支付、已审核的订单和对应客户推过去。

集成流程:采购端小程序与运营后台调用平台 API;定时任务每 30 分钟从 ERP 拉取商品、每分钟拉取库存,每分钟带重试推送订单与客户,每 5 分钟轮询单据状态,出库记账后订单转为已发货并回拉发票。

问题

批发采购方需要自助下单,但库存、账务和开票必须留在 ERP 中。两个系统要依据 ERP 方提供的接口规范保持一致。

约束

  • ERP 是商品、库存、单据状态和发票的权威系统。
  • 采购前要校验采购方资质,上传的证照需要识别。
  • 开发和测试不能依赖真实的支付、物流、通知或 ERP。

架构

部分实现
后端Java 17、Spring Boot 3.3、MySQL 8、Redis、S3 兼容对象存储、Flyway 迁移
客户端面向采购方的即时通讯平台小程序;Vue 3 运营后台
ERP 适配器可在内存 mock(把订单推进到“出库记账”并生成发票)和 HTTP 实现之间切换
定时任务每 30 分钟拉取商品;每分钟拉取库存;每分钟带重试推送订单与客户;每 5 分钟轮询单据状态
运维后台对接页面展示同步状态和日志,可手动触发同步、推送或回查

关键决策

  1. 拉取加轮询,不共享数据库。 平台只通过 ERP 公开的接口和它交互,任何一方改表结构都不会把另一方弄坏。
  2. 适配器先做 mock。 支付、物流、通知和 ERP 各有 mock,完整的订单生命周期(含开票)在本地就能跑,不需要合作方凭据。
  3. 密钥不进仓库。 CI 执行后端验证和后台的 lint、类型检查、测试、构建,并做敏感信息扫描;仓库里只有示例环境文件。

证据

  • 后端有 45 个测试类和 56 个迁移文件。
  • 生产部署文档覆盖发布、回滚、密钥轮换、备份与恢复。

边界

订单量、采购方数量、上线日期和商务条款均不公开。

常见问题

库存怎样与 ERP 保持一致?

每 30 分钟拉取一次商品,每分钟拉取一次库存,订单和客户带重试推送,单据状态每 5 分钟轮询一次。

没有真实 ERP 能开发吗?

mock ERP 适配器会模拟单据的完整生命周期,包括开票。

ERP 推送失败怎么办?

记录会留在待推送状态,在下一次每分钟的任务中重试;运营人员可以在后台查看同步日志,并手动触发重试。