Next revision | Previous revision |
de:cobi.msv [2022/06/03 08:49] – angelegt tkammer | de:cobi.msv [2022/06/03 12:08] (current) – [Einzelheiten zur Durchführung] tkammer |
---|
FIXME **Diese Seite wurde noch nicht vollständig übersetzt. Bitte helfen Sie bei der Übersetzung.**\\ //(diesen Absatz entfernen, wenn die Übersetzung abgeschlossen wurde)// | |
| |
====== COBI.msv ====== | ====== COBI.msv ====== |
| |
COBI.msv is a server-side implementation of the standardized MSV3 protocol for data interchange between pharmacies and pharma suppliers in Germany. It exclusively implements Version 2.0 of the standard, not Version 1.0, and only implements the server-side (supplier), not the client-side (pharmacy). | 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). |
| |
===== Features ===== | ===== Features ===== |
| |
Since MSV3 is a strictly standardized protocol, COBI.msv supports all features that are mandated by Version 2.0 of the standard. Following are some details on how exactly the features of the MSV3 protocol are implemented in COBI.msv: | 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: |
| |
**Authentication:** Pharmacies must log in with a username and password, which corresponds to their SAP Business One business partner code (''OCRD.CardCode'') and the value stored in the "Password" field under the "General" tab of the business partner master data (''OCRD.Password''). | **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''). |
| |
**Contract details:** The MSV3 protocol includes a query for contract details, although this is seldom used in practice. COBI.msv will respond to this query with rudimentary information only, such as the daily time window for purchase orders. | **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. |
| |
**Item availability (bulk):** The pharmacy's client software sends a list of PZN in bulk, to ask whether the supplier offers the associated products at all. A positive answer is given for every PZN for which the SAP Business One database contains an Item master data with that PZN (stored in a UDF). | **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). |
| |
**Item availability (detail):** The pharmacy's client software sends a list of PZN along with quantities which they wish to know the availability of. COBI.msv will check the "On Hand" quantity of each item and send a response that tells what part of the requested quantity could be delivered. | **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. |
| |
**Order:** Any order made by the pharmacy through their MSV3 client software will be booked into SAP Business One as a Sales Order. Additionally, an email notification can be sent out if an SMTP server is available in the environment in which COBI.msv is set up. | **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. |
| |
**Shipping notification:** The pharmacy asks for any new shipping notifications that may exist. COBI.msv will check if any new Delivery Note was added to SAP Business One for the pharmacy, and respond accordingly. The pharmacy can also ask for the details of an individual shipping notification via its number. | **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. |
| |
**Request return offer:** The pharmacy asks the supplier for an **offer** to take back a number of items. COBI.msv will book this as an **unconfirmed** Return Request in SAP Business One and report its ID back to the pharmacy. They can later use this ID as a reference to ask about the status. | **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. |
| |
**Request return:** The pharmacy makes a direct request to the supplier to take back a number of items, which can be immediately accepted or rejected through the MSV3 protocol. Currently, COBI.msv will always respond with a rejection. | **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. |
| |
===== Implementation details ===== | ===== Einzelheiten zur Implementation ===== |
| |
* The service consists of a Java program, requiring JDK 15 or higher. | * Der Dienst besteht aus einem Java-Programm, für das JDK 15 oder höher erforderlich ist. |
* It can run on any GNU/Linux distribution as a systemd service. | * Es kann auf jeder GNU/Linux-Distribution als systemd-Dienst laufen. |
* Only uses Service Layer to communicate with SAP Business One. | * Für die Kommunikation mit SAP Business One wird ausschließlich Service Layer verwendet. |
* Only uses the SAP Business One database, not any database of its own. | * Es wird ausschließlich die SAP Business One-Datenbank verwendet, keine eigene Datenbank. |
| |
To acquire a recent version of the JDK on your GNU/Linux distribution, you can download OpenJDK in ZIP or TAR format from the Oracle website, and unpack it in the ''/opt'' directory. | 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. |
| |
The following UDFs need to be added in SAP Business One for COBI.msv to function: | Die folgenden UDFs müssen in SAP Business One hinzugefügt werden, damit COBI.msv funktioniert: |
| |
Under //Marketing Documents -> Title//: | Unter //Belege -> Titel//: |
| |
^ Title ^ Data type ^ Size ^ | ^ Title ^ Data type ^ Size ^ |
| MSV3_GebindeId | Alphanumeric | 20 | | | MSV3_GebindeId | Alphanumeric | 20 | |
| |
Under //Marketing Documents -> Lines//: | Unter //Belege -> Zeilen//: |
| |
^ Title ^ Data type ^ Size ^ | ^ Title ^ Data type ^ Size ^ |
| MSV3_Liefervorgabe | Alphanumeric | 20 | | | MSV3_Liefervorgabe | Alphanumeric | 20 | |
| |