Zum Hauptinhalt springen

API-Integration

Die RxScale External Pharmacy API ermöglicht es Ihnen, Ihren Bestellbearbeitungs-Workflow zu automatisieren. Anstatt Bestellungen manuell über das Apothekenportal zu verwalten, können Sie Ihre bestehenden Apothekensysteme direkt mit RxScale verbinden.

Übersicht

Die External Pharmacy API ermöglicht es Ihnen:
  • Bestellungen automatisch empfangen — Erhalten Sie Benachrichtigungen in Echtzeit, wenn neue Bestellungen Ihrer Apotheke zugewiesen werden.
  • Bestellstatus aktualisieren — Bewegen Sie Bestellungen programmgesteuert durch die Bearbeitungsphasen.
  • Lagerbestände verwalten — Halten Sie Ihren Bestand zwischen Ihrem Apothekensystem und RxScale synchron.
  • Sendungen verfolgen — Aktualisieren Sie Versandinformationen über die API.
Dies ist ideal für Apotheken, die manuelle Arbeit reduzieren und RxScale in ihre bestehende Software und Prozesse integrieren möchten.

API-Schlüssel einrichten

Um die API zu nutzen, benötigen Sie einen API-Schlüssel. Sie können Ihre API-Schlüssel im Bereich API-Zugang des Apothekenportals verwalten.
1

Zu API-Zugang navigieren

Navigieren Sie über die Seitenleiste zum Bereich API-Zugang.
2

API-Schlüssel erstellen

Generieren Sie einen neuen API-Schlüssel. Geben Sie ihm einen aussagekräftigen Namen, damit Sie ihn später identifizieren können (zum Beispiel „Integration Apothekenverwaltungssystem”).
3

Schlüssel kopieren und sicher aufbewahren

Kopieren Sie den API-Schlüssel und bewahren Sie ihn an einem sicheren Ort auf. Sie können den vollständigen Schlüssel nach Verlassen dieser Seite nicht mehr einsehen.
Behandeln Sie Ihren API-Schlüssel wie ein Passwort. Teilen Sie ihn nicht und legen Sie ihn nicht in öffentlichen Code-Repositories ab. Wenn Sie vermuten, dass Ihr Schlüssel kompromittiert wurde, widerrufen Sie ihn sofort und erstellen Sie einen neuen.

Webhooks registrieren

Webhooks ermöglichen es RxScale, Ihr System automatisch zu benachrichtigen, wenn etwas passiert, zum Beispiel wenn eine neue Bestellung Ihrer Apotheke zugewiesen wird oder eine Bestellung storniert wird. So richten Sie Webhooks ein:
  1. Navigieren Sie zum Bereich API-Zugang des Apothekenportals.
  2. Fügen Sie eine Webhook-Endpoint-URL hinzu — dies ist eine URL auf Ihrem Server, an die RxScale Benachrichtigungen sendet.
  3. Wählen Sie die Ereignistypen aus, die Sie empfangen möchten (zum Beispiel neue Bestellungen, Statusänderungen).
  4. Speichern Sie Ihre Webhook-Konfiguration.
Nach der Konfiguration sendet RxScale bei jedem relevanten Ereignis eine HTTP-POST-Anfrage an Ihren Endpoint.
Stellen Sie sicher, dass Ihr Webhook-Endpoint öffentlich erreichbar ist und mit einem 200-Statuscode antwortet, um den Empfang zu bestätigen. Weitere Informationen zu Payload-Formaten und Sicherheit finden Sie in der Webhooks-Dokumentation.

Bestellbearbeitung automatisieren

Mit der API und Webhooks können Sie einen automatisierten Workflow aufbauen:
  1. Webhook-Benachrichtigung empfangen, wenn eine neue Bestellung Ihrer Apotheke zugewiesen wird.
  2. Bestelldetails abrufen über die API, um die vollständigen Bestellinformationen zu erhalten.
  3. Bestellung in Ihrem Apothekensystem bearbeiten (Bestand prüfen, Medikament vorbereiten).
  4. Bestellstatus aktualisieren über die API, während Sie die einzelnen Bearbeitungsschritte durchlaufen.
  5. Versandinformationen hinzufügen, sobald die Bestellung versandt wurde.
Diese Automatisierung macht es überflüssig, das Apothekenportal manuell auf neue Bestellungen zu prüfen und Status manuell zu aktualisieren.

Vollständige API-Referenz

Die vollständige API-Dokumentation, einschließlich aller verfügbaren Endpoints, Anfrageformate und Antwortschemata, finden Sie in der External Pharmacy API-Referenz.

Verwandte Themen