Bestellplattform für Pharmagroßhandel mit ERP-Anbindung

Eine B2B-Bestellplattform für den pharmazeutischen Großhandel: ein Mini-Programm für Einkäufer, eine Betreiberkonsole und eine Spring-Boot-API. Geplante Jobs holen Artikel und Bestände aus dem ERP des Distributors und schicken Bestellungen und Kunden mit Wiederholungen zurück.

KURZ GESAGT: Wir haben für einen Pharmagroßhändler Bestellungen per Selbstbedienung gebaut, während das ERP des Distributors das führende System blieb: Geplante Jobs holen Katalog und Bestände ab, übertragen Bestellungen und Kunden mit Wiederholung zurück und fragen den Belegstatus ab, bis die Ware versandt und die Rechnung ausgestellt ist.

Überblick

Apotheken und Praxen bestellen über ein Mini-Programm. Betreiber pflegen Artikel, Einkäuferqualifikationen, Bestellungen und Reklamationen in einer Web-Konsole. Artikel, Bestände und Rechnungen kommen weiterhin aus dem ERP; die Plattform sendet nur bezahlte, freigegebene Bestellungen und die zugehörigen Kunden.

Integrationsablauf: Einkäufer-Mini-Programm und Betreiberkonsole nutzen die Plattform-API; geplante Jobs holen alle 30 Minuten Artikel und jede Minute Bestände aus dem ERP, übertragen jede Minute Bestellungen und Kunden mit Wiederholung und fragen alle 5 Minuten den Belegstatus ab, machen aus gebuchten Warenausgangsbelegen versandte Bestellungen und holen Rechnungen ab.

Problem

Großhandelskunden brauchten Bestellungen per Selbstbedienung, aber Bestand, Buchhaltung und Rechnungsstellung mussten im ERP bleiben. Beide Systeme mussten über eine von der ERP-Seite veröffentlichte Schnittstellenspezifikation konsistent bleiben.

Randbedingungen

  • Das ERP ist das führende System für Artikel, Bestand, Belegstatus und Rechnungen.
  • Einkäuferqualifikationen müssen vor dem Kauf geprüft werden, einschließlich Dokumentenerkennung für hochgeladene Lizenzen.
  • Entwicklung und Tests müssen ohne echten Zugang zu Zahlung, Logistik, Benachrichtigung oder ERP laufen.

Architektur

TeilUmsetzung
BackendJava 17, Spring Boot 3.3, MySQL 8, Redis, S3-kompatibler Objektspeicher, Flyway-Migrationen
ClientsMini-Programm einer Messaging-Plattform für Einkäufer; Betreiberkonsole in Vue 3
ERP-AdapterUmschaltbar zwischen einem In-Memory-Mock, der Bestellungen bis „gebucht“ durchschiebt und Rechnungen erzeugt, und der HTTP-Implementierung
ZeitpläneKatalogabruf alle 30 Minuten; Bestandsabruf jede Minute; Übertragung von Bestellungen und Kunden mit Wiederholung jede Minute; Abfrage des Belegstatus alle 5 Minuten
BetriebIntegrationsseite in der Konsole mit Sync-Status und Logs; Abgleich, Übertragung und Abfrage lassen sich von Hand auslösen

Wichtige Entscheidungen

  1. Abholen und abfragen, keine gemeinsame Datenbank. Die Plattform erreicht das ERP nur über dessen veröffentlichte Schnittstelle; eine Schemaänderung auf einer Seite bricht die andere nicht.
  2. Adapter mit Mock zuerst. Zahlung, Logistik, Benachrichtigung und ERP haben jeweils einen Mock, sodass der gesamte Bestelllebenszyklus einschließlich Rechnungsstellung lokal ohne Zugangsdaten der Partner läuft.
  3. Geheimnisse bleiben aus dem Repository. Die CI führt Backend-Verifikation, Lint, Typprüfung, Tests und Build der Konsole sowie einen Secret-Scan aus, und eingecheckt werden nur Beispiel-Umgebungsdateien.

Belege

  • 45 Backend-Testklassen und 56 Migrationsdateien.
  • Die Deployment-Dokumente für die Produktion behandeln Release, Rollback, Rotation von Geheimnissen, Backup und Wiederherstellung.

Grenzen

Bestellvolumen, Zahl der Einkäufer, Go-live-Datum und kommerzielle Konditionen werden nicht veröffentlicht.

Häufige Fragen

Wie bleibt der Bestand mit dem ERP synchron?

Artikel werden alle 30 Minuten abgeholt, Bestände jede Minute. Bestellungen und Kunden werden mit Wiederholung übertragen. Der Belegstatus wird alle 5 Minuten abgefragt.

Lässt sich ohne Zugang zum echten ERP entwickeln?

Ein Mock-ERP-Adapter simuliert den Lebenszyklus der Belege, einschließlich Rechnungsstellung.

Was passiert, wenn eine Übertragung ans ERP fehlschlägt?

Der Datensatz bleibt in der Warteschlange und wird beim nächsten Lauf im Minutentakt erneut versucht. Betreiber sehen die Sync-Logs in der Konsole und können dort eine Wiederholung auslösen.