Produkte und SKUs
Ihr Produktkatalog ist das Fundament Ihrer RxScale-Integration. Diese Seite erklärt, wie Produkte und SKUs funktionieren und wie Sie sie verwalten.Produkte und SKUs verstehen
Produkte
Ein Produkt stellt ein Medikament oder eine Behandlung dar, die Patienten über Ihren Shop anfordern können. Jedes Produkt hat:- Name — Der Anzeigename, den Patienten sehen.
- Beschreibung — Informationen über das Produkt.
- Kategorie — Wie das Produkt klassifiziert ist.
- Zugeordneter Fragebogen — Der medizinische Fragebogen, den Patienten bei der Anforderung dieses Produkts ausfüllen müssen.
SKUs (Stock Keeping Units)
Jedes Produkt kann eine oder mehrere SKUs haben. Eine SKU stellt eine spezifische Variante eines Produkts dar. Zum Beispiel:
Jede SKU hat ihren eigenen Preis, Lagerbestand und Verfügbarkeitseinstellungen.
Ihren Produktkatalog verwalten
Sie können Ihre Produkte und SKUs über die Management API oder in Zusammenarbeit mit Ihrem RxScale-Kundenbetreuer verwalten. Häufige Aufgaben umfassen:Produkte hinzufügen
Neue Produkte werden typischerweise während Ihres initialen Onboardings eingerichtet. Um später Produkte hinzuzufügen:- Definieren Sie die Produktdetails (Name, Beschreibung, Kategorie).
- Erstellen Sie den zugehörigen medizinischen Fragebogen, falls noch keiner vorhanden ist.
- Fügen Sie eine oder mehrere SKUs mit Preis- und Bestandsinformationen hinzu.
- Verknüpfen Sie das Produkt mit Ihrem Shop.
Das Hinzufügen neuer Produkte erfordert in der Regel eine Abstimmung mit Ihrem Kundenbetreuer, insbesondere wenn ein neuer medizinischer Fragebogen erstellt werden muss.
SKU-Varianten verwalten
Sie können SKU-Varianten für bestehende Produkte hinzufügen, aktualisieren oder deaktivieren. Beachten Sie bei der Verwaltung von SKUs:- Jede SKU muss eine eindeutige Kennung haben.
- Preis und Lagerbestände werden pro SKU verwaltet.
- Das Deaktivieren einer SKU entfernt sie aus Ihrem Shop, ohne historische Daten zu löschen.
Produkte mit Shops verknüpfen
Produkte müssen mit einem Shop verknüpft werden, bevor Patienten sie sehen und bestellen können. Wenn Sie mehrere Shops betreiben, kann jeder Shop eine eigene Produktauswahl haben.- Ein Produkt kann mit mehreren Shops verknüpft werden.
- Jeder Shop kann basierend auf seiner Zielgruppe oder Region unterschiedliche Produkte anzeigen.
- Die Produktverfügbarkeit wird auf SKU-Ebene gesteuert, sodass ein Produkt in einem Shop verfügbar, in einem anderen aber nicht vorrätig sein kann.
Produkte und SKUs mit Ihrem Shopify-Shop verbinden
Öffnen Sie im Admin-Tool ein Produkt und verbinden Sie es mit dem passenden Produkt in Ihrem Shop. Verbinden Sie danach jede SKU mit der passenden Variante. Beide Dialoge listen die Shop-Produkte und Varianten auf, die noch nicht verbunden sind. Steht das gesuchte Produkt oder die Variante nicht in der Liste, verbinden Sie es per ID:- Für ein Produkt geben Sie die Shopify-Produkt-ID ein.
- Für eine SKU geben Sie die Shopify-Varianten-ID oder den SKU-Code der Variante ein. Teilen sich mehrere Varianten denselben SKU-Code, verwenden Sie die Varianten-ID.
Eine verbundene Shop-SKU bearbeiten
Bei einer verbundenen Shop-SKU können Sie den SKU-Code, die Varianten-ID (Shop-SKU-ID), die Produkt-ID (Shop-Produkt-ID), den Preis und das Bild korrigieren. Jede Varianten-ID und jede Produkt-ID kann pro Shop nur einmal verwendet werden. Gehört die eingegebene ID in diesem Shop bereits zu einer anderen Shop-SKU oder einem anderen Shop-Produkt, nennt das Admin-Tool die vergebene ID, speichert nichts und behält Ihre Eingaben, damit Sie sie korrigieren können. Ist die Shop-SKU, die diese Varianten-ID bereits hat, die eigentlich gewünschte, trennen Sie die aktuelle Shop-SKU und verbinden Sie stattdessen die andere — eine SKU kann pro Shop mit einer Shop-SKU verbunden sein.Entwürfe und archivierte Produkte in Shopify
RxScale speichert pro Shop den Status jedes Shopify-Produkts (Aktiv, Entwurf, Archiviert oder Nicht gelistet). Produkte mit dem Status Entwurf oder Archiviert werden weiterhin mit RxScale synchronisiert, werden in diesem Shop aber niemandem für eine Bestellung angeboten:- Ärzte sehen sie nicht, wenn sie im Ärzteportal ein Direktrezept erstellen.
- Das Admin-Tool listet sie nicht, wenn Sie das Produkt einer Bestellung ändern.
- Die Produktliste der Public API enthält sie nicht.
Preis- und Bestandsverwaltung
Preisgestaltung
Preise werden pro SKU festgelegt. Beim Aktualisieren von Preisen:- Preisänderungen gelten sofort für neue Bestellungen.
- Bestehende Bestellungen sind von Preisänderungen nicht betroffen.
- Stellen Sie sicher, dass Ihre Preise mit der Anzeige in Ihrem Shop übereinstimmen, um Verwirrung zu vermeiden.
Lagerbestände
Lagerbestände bestimmen, ob ein Produkt bestellt werden kann. Der Bestand jeder SKU wird von der Apotheke verwaltet, die Bestellungen für dieses Produkt ausführt.- Wenn der Bestand Null erreicht, wird die SKU als nicht vorrätig markiert und kann nicht bestellt werden.
- Der Bestand wird automatisch reduziert, wenn Bestellungen abgeschlossen werden.
- Apotheken können ihre Lagerbestände über das Apothekenportal oder die API aktualisieren.
Bestand pro Apotheken-Standort in Shopify
Wenn Ihr Shopify-Shop für jede Apotheke einen eigenen Standort hat, kann RxScale den Bestand jeder Apotheke an ihrem Standort führen, statt eine Zahl für den ganzen Shop zu schreiben. Im Admin-Tool unter Einstellungen → Shops:1
Standorte zuordnen
Öffnen Sie für den Shop die Standort-Zuordnungen und ordnen Sie jede Shopify-Standort-ID ihrer Apotheke zu. Eine Apotheke kann pro Shop einen Standort haben.
2
Bestandssync pro Apotheke aktivieren
Öffnen Sie Bestandssync und aktivieren Sie ihn für jede Apotheke, deren Bestand den Shop erreichen soll.
3
Shop-Einstellung aktivieren
Öffnen Sie die Einstellungen des Shops und aktivieren Sie Apothekenbestand am Shopify-Standort der Apotheke synchronisieren.
- Eine Apotheke ohne Standort im Shop oder mit deaktiviertem Bestandssync sendet keinen Bestand an den Shop. Ausnahme ist die Apotheke, die den Produkt-Feed des Shops beliefert: ihr Bestand erreicht ihren Standort trotzdem, weil der Feed ihn schreibt.
- Eine Apotheke, der im selben Shop mehrere Standorte zugeordnet sind, sendet keinen Bestand, weil dieselbe Zahl an jedem Standort mehr ergäbe, als die Apotheke hat.
- Hat Ihr Shop einen CanDoc-Produkt-Feed, entscheidet der Feed, welche Apotheken ein Produkt überhaupt verkaufen dürfen: die in seiner Liste
pharmacy_uid_all. Eine Apotheke, die der Feed für ein Produkt nicht aufführt, zeigt dafür an ihrem Standort 0, auch wenn sie Bestand hat. Nimmt der Feed eine Apotheke heraus, setzt der nächste Feed-Lauf ihren Standort auf 0; nimmt er sie auf, setzt der nächste Lauf ihren aktuellen Bestand. - Jeder Feed-Lauf gleicht außerdem den Standort jeder Apotheke ab, sodass ein Bestand, der auf dem Weg zu Shopify verloren ging, erneut gesendet wird.
- Existiert der Standort der Apotheke und ist er aktiv, aktiviert RxScale das Produkt dort, wenn es noch nicht geführt wird, und setzt den Bestand, auch 0. Existiert der Standort nicht, oder ist der Standort selbst deaktiviert, ändert RxScale den Bestand nicht.
- Eine digitale SKU (
digital: true) hat keinen Apothekenbestand. Ihr Bestand kommt nur aus dem Produkt-Feed, und RxScale setzt ihn am Standardstandort Ihres Shops in Shopify (Einstellungen → Standorte), nie am Standort einer Apotheke. Bestandsänderungen einer Apotheke ändern ihn nicht. In Shopify muss die digitale Variante am Standardstandort geführt werden; ist sie es nicht, lehnt Shopify die Aktualisierung ab.
Prüfen Sie vor der Umstellung eines bestehenden Shops den Bestand an Ihren Shopify-Standorten. Hat RxScale bisher Bestand in den Shop geschrieben, dann den Gesamtbestand des Shops an einen Standort, und diese Zahl bleibt dort, bis Sie sie ändern. Das gilt auch für digitale SKUs: RxScale setzt ihren Bestand nicht am Standort einer Apotheke, eine Zahl, die dort bereits steht, bleibt also, bis Sie sie ändern.
Digitale oder physische SKUs einer Apotheke ausblenden
Ein Shop kann einen SKU-Typ einer verknüpften Apotheke nicht mehr anbieten: ihre digitalen SKUs, ihre physischen SKUs oder beide. Öffnen Sie im Admin-Tool unter Einstellungen → Shops für den Shop Ausgeblendete SKU-Typen und wählen Sie pro Apotheke Digitale SKUs ausblenden oder Physische SKUs ausblenden. Für einen ausgeblendeten Typ gilt:- Der Bestand der Apotheke zählt in diesem Shop als 0. In einem Shop mit Bestand pro Apotheken-Standort zeigt der Standort der Apotheke für diese SKUs 0. In einem Shop mit einer Bestandszahl fließt der Bestand der Apotheke nicht in die Summe ein, und damit auch nicht in die Produkt-Feeds für Dr. Ansay und docnow24.
- Die automatische Apothekenwahl schickt eine Bestellung dieses Shops, die eine solche SKU enthält, nicht mehr an die Apotheke. Eine andere verknüpfte Apotheke, die die SKU führt, erhält sie. Gibt es keine, wird die Bestellung an keine Apotheke gesendet und zeigt ein Fulfillment-Problem.
- Eine Bestellung, die die Apotheke bereits festlegt, geht weiterhin an sie: wenn der Patient die Apotheke gewählt hat, ein Partner sie gesetzt hat oder Shopify die Bestellung an den Standort der Apotheke geleitet hat.
- Die Einstellung gilt nur für diesen Shop. Dieselbe Apotheke kann in einem anderen Shop beide Typen zeigen.
Arzt-SKU-Blacklist
Die Arzt-SKU-Blacklist ermöglicht es Ihnen, bestimmte SKUs für einzelne Ärzte zu sperren. Dies ist nützlich für:- Fachgebietsbeschränkungen — Ärzte auf SKUs innerhalb ihres Fachgebiets beschränken.
- Zulassungsanforderungen — Sicherstellen, dass Ärzte nur Medikamente verschreiben, für die sie zugelassen sind.
- Compliance — Durchsetzung organisatorischer oder regulatorischer Beschränkungen auf Arztebene.
Funktionsweise
Wenn eine SKU für einen Arzt auf die Blacklist gesetzt wird, kann dieser Arzt sie nicht mehr verschreiben. Die Blacklist funktioniert auf SKU-Ebene (nicht auf Produktebene) und bietet Ihnen so eine feingranulare Kontrolle darüber, welche spezifischen Varianten ein Arzt verschreiben kann.Das Sperren einer SKU betrifft keine anderen Ärzte. Jeder Arzt hat seine eigene unabhängige Blacklist.
Blacklist verwalten
Die SKU-Blacklist wird über das Admin-Portal auf der Arzt-Detailseite verwaltet:- Navigieren Sie zu Ärzte im Admin-Portal.
- Wählen Sie den Arzt aus, den Sie verwalten möchten.
- Scrollen Sie zum Abschnitt Gesperrte SKUs.
- Verwenden Sie die Hinzufügen-Schaltfläche, um eine oder mehrere SKUs in einem Schritt zur Blacklist hinzuzufügen. SKUs, die bereits auf der Blacklist dieses Arztes stehen, bleiben sichtbar, können aber nicht erneut ausgewählt werden.
- Verwenden Sie die Entfernen-Schaltfläche bei einem Eintrag, um eine SKU wieder freizugeben.
API-Zugang
Sie können die Blacklist auch programmatisch über die Admin API verwalten:page, limit) und Suche (search) als Query-Parameter.
Verwandte Themen
- Bestellungen und Rezepte — Wie Bestellungen durch das System fließen.
- Management API — Produkte programmgesteuert verwalten.
- Management API Produkte-Referenz — Vollständige API-Dokumentation für Produkt-Endpoints.