Zum Hauptinhalt springen

Leitfaden zur Apothekenintegration

Dieser Leitfaden führt Sie durch die Schritte zur Integration Ihrer Apotheke oder Ihres Apothekenverwaltungssystems mit RxScale — von der Bereitstellung Ihres API-Schlüssels bis zur Verarbeitung Ihrer ersten Bestellung.

Schritt 1: API-Schlüssel erhalten

Wenden Sie sich an Ihren RxScale-Kundenbetreuer, um Ihre API-Zugangsdaten zu erhalten. Sie erhalten:
  • Einen API-Schlüssel zur Authentifizierung
  • Eine Apotheken-UID (oder Zugriff auf Gruppenebene, wenn Sie mehrere Apotheken verwalten)
  • Zugang zur Entwicklungsumgebung zum Testen
Testen Sie Ihren Schlüssel mit einem Health Check:

Schritt 2: SKUs synchronisieren

Rufen Sie den SKU-Katalog Ihrer Apotheke ab und synchronisieren Sie ihn mit Ihrem internen Produktsystem.
Für jede SKU können Sie:
  • Ihren Preis festlegen (in Euro-Cent)
  • Lagerbestände aktualisieren, um Ihren aktuellen Bestand widerzuspiegeln
  • Eine externe ID verknüpfen aus Ihrem Apothekenverwaltungssystem
Siehe Apotheken-SKUs für die vollständige Dokumentation.

Schritt 3: Webhooks registrieren

Richten Sie Webhooks ein, damit Ihr System Echtzeit-Benachrichtigungen erhält, wenn neue Bestellungen eingehen oder sich Lagerbestände ändern.
Speichern Sie das in der Antwort zurückgegebene webhook_secret. Sie benötigen es zur Überprüfung von Webhook-Signaturen. Es wird nur einmal angezeigt.
Wir empfehlen, folgende Ereignistypen zu abonnieren: Siehe Webhook-Sicherheit für die Überprüfung von Webhook-Signaturen.

Schritt 4: Bestellungen verarbeiten

Wenn Sie einen pharmacy_order_created-Webhook erhalten (oder den Bestellungen-Endpoint abfragen), verarbeiten Sie die Bestellung in Ihrem Apothekenworkflow:
Gruppenweite API-Schlüssel hängen ?pharmacy_uid=<Apotheken-UID> an jede Bestell-URL in diesem Schritt an. Ein Schlüssel für eine einzelne Apotheke lässt den Parameter weg.
Fehlt pharmacy_uid bei einem gruppenweiten Schlüssel, antwortet die API mit 400:
Eine pharmacy_uid außerhalb der Apothekengruppe des Schlüssels liefert ebenfalls 400, mit der Meldung "Pharmacy not found in the API key's pharmacy group.".

4a. Bestelldetails anzeigen

Dies gibt die vollständige Bestellung zurück, einschließlich Patientendaten, Arztdaten, Rezeptdateien und Positionen. doctor_data und prescription_file sind null bei rezeptfreien (OTC) Bestellungen, denen kein Rezept beigefügt ist.

4b. Bestellstatus aktualisieren

Aktualisieren Sie den Status, während Sie die Bestellung verarbeiten:
Wenn eine Abholbestellung (Lieferart-Identifier pickup) verpackt ist und auf den Patienten wartet, setzen Sie ready_for_pickup:
ready_for_pickup gilt nur für Abholbestellungen. Jede andere Lieferart liefert 400 mit code delivery_type_must_be_pickup. Hat die Bestellung keine Lieferart, lautet der Code delivery_type_required.
Versandbestellungen überspringen ready_for_pickup. Schließen Sie sie direkt aus in-progress ab und übergeben Sie den Tracking-Link, damit RxScale den Bestand reduzieren und Versand- sowie Bestellaktualisierungsereignisse veröffentlichen kann:
Abholbestellungen verwenden denselben complete_order-Endpoint nach ready_for_pickup. tracking_links ist optional. Siehe Bestelllebenszyklus für den vollständigen Statusablauf.

Integrations-Checkliste

  • API-Schlüssel von RxScale erhalten
  • Konnektivität mit dem Health-Check-Endpoint überprüft
  • In der Entwicklungsumgebung getestet, bevor Produktion genutzt wird
  • Vollständigen SKU-Katalog abgerufen
  • Externe IDs Ihrem Apothekenverwaltungssystem zugeordnet
  • Anfangspreise und Lagerbestände festgelegt
  • Regelmäßige Bestandssynchronisierung geplant (oder Webhooks verwenden)
  • Webhooks für pharmacy_order_created und pharmacy_order_updated registriert
  • Signaturschlüssel sicher gespeichert
  • Signaturüberprüfung implementiert
  • Endpoint antwortet innerhalb von 5 Sekunden mit 2xx
  • Eingehende Bestellungen werden verarbeitet (über Webhook oder Abfrage)
  • Bestellstatus wird bei Verarbeitung und Versand aktualisiert
  • Bestellungen werden über den dedizierten complete_order-Endpoint abgeschlossen
  • Sonderfälle werden behandelt (Stornierungen, Bestandsprobleme)