Grosshaendler-Leitfaden

Das MSV3 Smart Gateway wird mit 13 vorverifizierten Grosshaendlern ausgeliefert. Alle sind getestet und arbeiten mit dem MSV3-Protokoll. Sie koennen auch eigene MSV3-kompatible Endpunkte registrieren.

Hinweis: MSV3-Server-URLs koennen sich aendern

MSV3-Server koennen ihre URL aendern (z.B. bei Migrationen oder Updates). Falls ein Grosshaendler seine URL aktualisiert hat, koennen Sie die neue URL ueber die "Eigener Grosshaendler"-Funktion sofort nutzen, ohne auf ein Plattform-Update warten zu muessen. Wir aktualisieren die offizielle Liste regelmaessig.

Verifizierte Grosshaendler

ID	Name	Endpunkt
`noweda`	NOWEDA eG	`msv3.noweda.de/msv3`
`noweda_test`	NOWEDA eG (Test)	`msv3test.noweda.de/msv3test`
`phoenix`	PHOENIX Pharmahandel	`msv3.phoenixgroup.eu/msv3`
`gehe`	GEHE Pharma Handel GmbH	`msv3.gehe.de/msv3`
`sanacorp`	Sanacorp Pharmahandel GmbH	`msv3.sanacorp.de/msv3`
`alliance_healthcare`	Alliance Healthcare Deutschland AG	`msv3.alliance-healthcare.de/msv3`
`fiebig`	Fiebig & Schlottmann	`msv3.fiebig-schlottmann.de/msv3`
`ebert_jacobi`	Ebert + Jacobi	`msv3.ebert-jacobi.de/msv3`
`max_jenne`	Max Jenne	`msv3.max-jenne.de/msv3`
`hageda_stumpf`	HAGEDA-STUMPF	`msv3.hageda-stumpf.de/msv3`
`otto_geilenkirchen`	Otto Geilenkirchen	`msv3.otto-geilenkirchen.de/msv3`
`kehr_berlin`	Kehr Pharma Berlin	`msv3.kehr-berlin.de/msv3`
`krieger_pharma`	Krieger + Pohlmann	`msv3.krieger-pharma.de/msv3`

Faehigkeiten pro Grosshaendler

Die verfuegbaren Faehigkeiten haengen von Ihrem Vertrag mit dem Grosshaendler ab. Pruefen Sie diese mit GET /v1/contracts.

ID	Bestellung	Verfuegbarkeit	Vertraege	Bulk	Retouren-Angebote
`noweda`	Ja	Ja	Ja	Variiert	Variiert
`phoenix`	Ja	Ja	Ja	Variiert	Variiert
`gehe`	Ja	Ja	Ja	Variiert	Variiert
`sanacorp`	Ja	Ja	Ja	Variiert	Variiert
`alliance_healthcare`	Ja	Ja	Ja	Variiert	Variiert
`fiebig`	Ja	Ja	Nein	Nein	Nein
`ebert_jacobi`	Ja	Ja	Nein	Nein	Nein
`max_jenne`	Ja	Ja	Nein	Nein	Nein
`hageda_stumpf`	Ja	Ja	Nein	Nein	Nein
`kehr_berlin`	Ja	Ja	Nein	Nein	Nein
`krieger_pharma`	Ja	Ja	Nein	Nein	Nein

"Variiert" bedeutet, die Faehigkeit haengt von den spezifischen Vertragsbedingungen zwischen Ihrer Apotheke und dem Grosshaendler ab.

Bekannte Besonderheiten

NOWEDA (`noweda`)

Testserver: Verwenden Sie die Grosshaendler-ID noweda_test fuer die echte NOWEDA-Testumgebung unter msv3test.noweda.de.
Nachlieferung: NOWEDA unterstuetzt die backorder-Liefervorgabe (MaxNachlieferung) vollstaendig. Erwarten Sie geteilte Lieferanteile bei Nachlieferungen.
Nachtmodus: Ausserhalb der Geschaeftszeiten erhalten Bestellungen den Status queued_night_mode und werden automatisch zum naechsten Fenster uebermittelt.
Kundennummer-Format: Typisch NowXXXXXXXX (z.B. Now00079800).

PHOENIX (`phoenix`)

Domain: PHOENIX MSV3-Endpunkte laufen unter phoenixgroup.eu, nicht phoenix-pharma.de.
Hageda-Beziehung: Hageda ist PHOENIXs Tochtermarke. Mit Hageda-Vertrag koennen Sie die phoenix-Grosshaendler-ID verwenden.
Antwortzeiten: PHOENIX-Endpunkte koennen langsamer sein (~300-500ms). Stellen Sie ein Timeout von mindestens 30 Sekunden ein.

GEHE (`gehe`)

Geteilte Lieferungen: GEHE liefert haeufig mehrere Lieferanteile pro PZN -- einen normalen Teil und einen Nachlieferungsteil.
Verfuegbarkeitsantwort: GEHE gibt manchmal response_type: unspecific zurueck, d.h. ein Gesamtergebnis statt pro-PZN-Daten.

Sanacorp (`sanacorp`)

Retouren: Unterstuetzt Retouren-Angebote und Retouren-Ankuendigungen. Faehigkeiten ueber GET /v1/contracts pruefen.
Lieferfenster: Betreibt mehrere taegliche Bestellfenster.

Alliance Healthcare (`alliance_healthcare`)

Grosse Kataloge: Bulk-Verfuegbarkeit (POST /v1/availability/bulk) eignet sich gut zum Vorfiltern grosser PZN-Listen.
Substitutionen: Wendet automatische Substitutionen fuer nicht lieferbare Artikel an, wenn substitution im Vertrag aktiviert ist.

Kleinere Grosshaendler

fiebig, ebert_jacobi, max_jenne, hageda_stumpf, otto_geilenkirchen, kehr_berlin, krieger_pharma -- diese unterstuetzen Kernbestellung und Verfuegbarkeit, bieten aber typischerweise keine Vertragsabfrage, Bulk-Verfuegbarkeit oder Retouren-Preise.

Grosshaendler auflisten

# API
curl -s "https://api.msv3gateway.example.com/v1/wholesalers" \
  -H "X-API-Key: pk_live_abc123"

# CLI
msv3 wholesalers

Eigene Endpunkte registrieren

Registrieren Sie jeden MSV3-kompatiblen Endpunkt, der nicht in der verifizierten Liste steht:

curl -s -X POST "https://api.msv3gateway.example.com/v1/wholesalers/custom" \
  -H "X-API-Key: pk_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Regional Pharma GmbH",
    "endpoint": "https://msv3.regional-pharma.de/msv3"
  }'

Die zurueckgegebene id (z.B. regional-pharma-gmbh) kann dann in allen API-Aufrufen verwendet werden.

Hinweise zu eigenen Endpunkten:

Eigene Endpunkte werden nicht vom Gateway-Team getestet oder verifiziert.

Das capabilities[]-Array startet leer -- verwenden Sie GET /v1/contracts, um die tatsaechlichen Faehigkeiten zu ermitteln.

Eigene Endpunkte sind auf Ihren API-Schluessel beschraenkt und fuer andere Konten nicht sichtbar.

Verfuegbarkeit bei mehreren Grosshaendlern vergleichen

Wenn Ihre Apotheke Vertraege mit mehreren Grosshaendlern hat, koennen Sie die Verfuegbarkeit ueber alle abfragen und Lieferzeiten vergleichen:

const wholesalers = ['noweda', 'phoenix', 'gehe'];

const results = await Promise.all(
  wholesalers.map(wholesaler =>
    client.availability.check({ ...creds, wholesaler }, {
      items: [{ pzn: '761271', quantity: 5 }],
    })
  )
);

for (const result of results) {
  const item = result.items[0];
  const eta = item.deliveries[0]?.estimated_at ?? 'unbekannt';
  console.log(`${result.wholesaler}: verfuegbar=${item.available}, ETA=${eta}`);
}

Hinweis: Sie benoetigen separate MSV3-Zugangsdaten fuer jeden Grosshaendler.

PharmaAutopilot