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
UmgebungBasis-URL
Entwicklunghttps://api.rxscale-dev.com
Produktionhttps://api.rxscale.com
Testen Sie Ihren Schlüssel mit einem Health Check: 
curl -X GET "https://api.rxscale-dev.com/v1/external-pharmacy-api-v1/health/" \
  -H "X-API-Key: your-api-key-here"

​
Schritt 2: SKUs synchronisieren

Rufen Sie den SKU-Katalog Ihrer Apotheke ab und synchronisieren Sie ihn mit Ihrem internen Produktsystem. 
curl -X GET "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_skus/" \
  -H "X-API-Key: your-api-key-here"
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
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_skus/psku-abc123" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 1299,
    "stock": 100,
    "external_id": "YOUR-PMS-ID-001"
  }'
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. 
curl -X POST "https://api.rxscale.com/v1/external-pharmacy-api-v1/webhooks/" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "https://your-pharmacy.com/webhooks/rxscale",
    "notification_type": "pharmacy_order_created"
  }'
Speichern Sie das in der Antwort zurückgegebene signing_secret. Sie benötigen es zur Überprüfung von Webhook-Signaturen. Es wird nur einmal angezeigt.
Wir empfehlen, folgende Ereignistypen zu abonnieren:
EreignistypGrund
pharmacy_order_createdSofortige Benachrichtigung, wenn eine neue Bestellung Ihrer Apotheke zugewiesen wird
pharmacy_order_updatedStatusänderungen verfolgen (z. B. Stornierungen)
pharmacy_sku_stock_updatedSynchron bleiben, wenn der Lagerbestand extern angepasst wird
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:

​
4a. Bestelldetails anzeigen

curl -X GET "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_orders/po-abc123" \
  -H "X-API-Key: your-api-key-here"
Dies gibt die vollständige Bestellung zurück, einschließlich Patientendaten, Arztdaten, Rezeptdateien und Positionen.

​
4b. Bestellstatus aktualisieren

Aktualisieren Sie den Status, während Sie die Bestellung verarbeiten: 
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "processing"}'
Und nach dem Versand: 
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "shipped"}'
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 aktualisiert bei Verarbeitung, Versand und Abschluss
  • Sonderfälle werden behandelt (Stornierungen, Bestandsprobleme)