Leitfaden zur Apothekenintegration

Schritt-für-Schritt-Anleitung für Apotheken zur Integration mit RxScale

​

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

Umgebung	Basis-URL
Entwicklung	https://api.rxscale-dev.com
Produktion	https://api.rxscale.com

Testen Sie Ihren Schlüssel mit einem Health Check:

curl -X GET "https://api.rxscale-dev.com/v1/external_pharmacy_api/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/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/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/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:

Ereignistyp	Grund
pharmacy_order_created	Sofortige Benachrichtigung, wenn eine neue Bestellung Ihrer Apotheke zugewiesen wird
pharmacy_order_updated	Statusänderungen verfolgen (z. B. Stornierungen)
pharmacy_sku_stock_updated	Synchron 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/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. 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:

curl -X PATCH "https://api.rxscale.com/v1/external_pharmacy_api/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "in-progress"}'

Und wenn die Bestellung verpackt und zur Abholung oder zum Versand bereit ist:

curl -X PATCH "https://api.rxscale.com/v1/external_pharmacy_api/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "ready_for_pickup"}'

Schließen Sie die Bestellung über den dedizierten Completion-Endpoint ab, damit RxScale den Bestand reduzieren und Versand- sowie Bestellaktualisierungsereignisse veröffentlichen kann:

curl -X PATCH "https://api.rxscale.com/v1/external_pharmacy_api/pharmacy_orders/po-abc123/complete_order" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "tracking_links": [
      {
        "tracking_link": "https://tracking.example.com/parcel/123",
        "carrier": "DHL"
      }
    ]
  }'

Siehe Bestelllebenszyklus für den vollständigen Statusablauf.

​

Integrations-Checkliste

API-Schlüssel und Konnektivität

• API-Schlüssel von RxScale erhalten
• Konnektivität mit dem Health-Check-Endpoint überprüft
• In der Entwicklungsumgebung getestet, bevor Produktion genutzt wird

SKU-Synchronisierung

• Vollständigen SKU-Katalog abgerufen
• Externe IDs Ihrem Apothekenverwaltungssystem zugeordnet
• Anfangspreise und Lagerbestände festgelegt
• Regelmäßige Bestandssynchronisierung geplant (oder Webhooks verwenden)

Webhook-Einrichtung

• 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

Bestellverarbeitung

• 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)