ERP連携付きの医薬品卸向け発注プラットフォーム

医薬品卸向けのB2B発注プラットフォーム。購買者向けミニプログラム、運営コンソール、Spring BootのAPIで構成されます。スケジュールジョブが販売元のERPから商品と在庫を取り込み、注文と顧客を再試行付きでERPに送り返します。

要点: 販売元のERPを正のシステムのまま、医薬品卸のセルフサービス発注を構築しました。スケジュールジョブがカタログと在庫を取り込み、注文と顧客を再試行付きで送り返し、商品が出荷され請求書が発行されるまで伝票の状態をポーリングします。

概要

薬局と診療所はミニプログラムから発注します。運営者はWebコンソールで商品、購買者の資格、注文、アフターサービスを管理します。商品、在庫、請求書は引き続きERPから来ており、プラットフォームが送るのは支払い済みで承認された注文とその顧客だけです。

連携フロー。購買者向けミニプログラムと運営コンソールがプラットフォームのAPIを使う。スケジュールジョブがERPから商品を30分ごと、在庫を1分ごとに取り込み、1分ごとに注文と顧客を再試行付きで送信し、5分ごとに伝票の状態をポーリングして、計上済みの出庫伝票を出荷済み注文に変え、請求書を取得する。

課題

卸の購買者はセルフサービスで発注したいが、在庫、会計、請求はERPに残さなければなりませんでした。2つのシステムは、ERP側が公開したインタフェース仕様を通じて整合を保つ必要がありました。

制約

  • 商品、在庫、伝票の状態、請求書についてはERPが正のシステム。
  • 購入前に購買者の資格を確認する必要があり、アップロードされた許可証の文書認識も含む。
  • 開発とテストは、本番の決済、物流、通知、ERPにアクセスせずに動くこと。

アーキテクチャ

部分実装
バックエンドJava 17、Spring Boot 3.3、MySQL 8、Redis、S3互換オブジェクトストレージ、Flywayマイグレーション
クライアント購買者向けのメッセージングプラットフォームのミニプログラム。Vue 3の運営コンソール
ERPアダプタ注文を「計上済み」まで進め請求書を生成するインメモリのモックと、HTTP実装とを切り替え可能
スケジュールカタログの取り込みは30分ごと。在庫の取り込みは1分ごと。注文と顧客の再試行付き送信は1分ごと。伝票状態のポーリングは5分ごと
運用同期状態とログを表示するコンソールの連携ページ。同期、送信、ポーリングは手動でも起動できる

主な判断

  1. 取り込みとポーリング、データベースは共有しない。 プラットフォームは公開されたインタフェースを通してしかERPにアクセスしないため、片側のスキーマが変わってももう片側は壊れません。
  2. モック優先のアダプタ。 決済、物流、通知、ERPにそれぞれモックがあり、請求書発行まで含めた注文のライフサイクル全体を、パートナーの認証情報なしでローカルで動かせます。
  3. シークレットはリポジトリに置かない。 CIはバックエンドの検証、コンソールのlint、型チェック、テスト、ビルド、シークレットスキャンを実行し、コミットするのは環境ファイルのサンプルだけです。

根拠

  • バックエンドのテストクラス45、マイグレーションファイル56。
  • 本番デプロイの文書は、リリース、ロールバック、シークレットのローテーション、バックアップと復元を扱っています。

限界

注文数、購買者数、稼働開始日、取引条件は公開していません。

よくあるご質問

在庫はどうやってERPと同期していますか?

商品は30分ごと、在庫は1分ごとに取り込みます。注文と顧客は再試行付きで送信します。伝票の状態は5分ごとにポーリングします。

本物のERPにアクセスできなくても開発できますか?

モックのERPアダプタが、請求書発行を含む伝票のライフサイクルを再現します。

ERPへの送信に失敗するとどうなりますか?

そのレコードはキューに残り、1分ごとの次の実行で再試行されます。運営者はコンソールで同期ログを確認し、再試行を手動で起動できます。