COBI.msv ist eine serverseitige Implementierung des standardisierten MSV3-Protokolls für den Datenaustausch zwischen Apotheken und Pharmalieferanten in Deutschland. Es implementiert ausschließlich die Version 2.0 des Standards, nicht die Version 1.0, und implementiert nur die Server-Seite (Lieferant), nicht die Kunden-Seite (Apotheke).

Da MSV3 ein streng standardisiertes Protokoll ist, unterstützt COBI.msv alle Funktionen, die in Version 2.0 des Standards vorgeschrieben sind. Im Folgenden finden Sie einige Details darüber, wie genau die Funktionen des MSV3-Protokolls in COBI.msv implementiert sind:

Authentifizierung: Apotheken müssen sich mit einem Benutzernamen und einem Passwort anmelden, das ihrem SAP Business One-Geschäftspartnercode entspricht (OCRD.CardCode) und dem Wert, der im Feld “Passwort” auf der Registerkarte “Allgemein” der Geschäftspartner-Stammdaten gespeichert ist (OCRD.Password).

Vertragsdetails: Das MSV3-Protokoll enthält eine Abfrage nach Vertragsdetails, die jedoch in der Praxis nur selten verwendet wird. COBI.msv antwortet auf diese Abfrage nur mit elementaren Informationen, wie z. B. dem täglichen Zeitfenster für Bestellungen.

Artikelverfügbarkeit (Bulk): Die Kunden-Software der Apotheke sendet eine Liste von PZN bzw. ein ganzen PZN-Block, um zu fragen, ob der Lieferant die entsprechenden Produkte überhaupt anbietet. Eine positive Antwort wird für jede PZN gegeben, für die die SAP Business One-Datenbank Artikelstammdaten mit dieser PZN aufweist (gespeichert in einer UDF).

Artikelverfügbarkeit (Detail): Die Kunden-Software der Apotheke sendet eine Liste von PZN zusammen mit den Mengen, deren Verfügbarkeit sie wissen möchte. COBI.msv prüft die “Auf Lager”-Menge jedes Artikels und sendet eine Antwort, die angibt, welcher Teil der angeforderten Menge geliefert werden könnte.

Bestellung: Jede Bestellung, die von der Apotheke über ihre MSV3-Kunden-Software aufgegeben wird, wird in SAP Business One als Kundenauftrag verbucht. Zusätzlich kann eine E-Mail-Benachrichtigung verschickt werden, wenn in der Umgebung, in der COBI.msv eingerichtet ist, ein SMTP-Server verfügbar ist.

Lieferavis: Die Apotheke fragt nach neuen Lieferavisen, die eventuell vorhanden sind. COBI.msv prüft, ob ein neuer Lieferschein für die Apotheke in SAP Business One hinzugefügt wurde, und antwortet entsprechend. Die Apotheke kann auch die Details eines einzelnen Lieferavis über dessen Nummer abfragen.

Rücknahmeangebot anfordern: Die Apotheke bittet den Lieferanten um ein Angebot zur Rücknahme einer Reihe von Artikeln. COBI.msv verbucht dies als unbestätigte Retourenanfrage in SAP Business One und meldet deren ID an die Apotheke zurück. Die Apotheke kann diese ID später als Referenz verwenden, um sich nach dem Status zu erkundigen.

Retourenavis: Die Apotheke stellt eine direkte Retourenavis-Anfrage an den Lieferanten, die über das MSV3-Protokoll sofort angenommen oder abgelehnt werden muss. Derzeit antwortet COBI.msv immer mit einer Ablehnung.

• Der Dienst besteht aus einem Java-Programm, für das JDK 15 oder höher erforderlich ist.
• Es kann auf jeder GNU/Linux-Distribution als systemd-Dienst laufen.
• Für die Kommunikation mit SAP Business One wird ausschließlich Service Layer verwendet.
• Es wird ausschließlich die SAP Business One-Datenbank verwendet, keine eigene Datenbank.

Um eine aktuelle Version des JDK auf Ihrer GNU/Linux-Distribution zu erhalten, können Sie OpenJDK im ZIP- oder TAR-Format von der Oracle-Website herunterladen und in das Verzeichnis /opt entpacken.

Die folgenden UDFs müssen in SAP Business One hinzugefügt werden, damit COBI.msv funktioniert:

Unter Belege → Titel:

Unter Belege → Zeilen: