Zum Hauptinhalt springen

​
Webhooks und Benachrichtigungen

Webhooks ermöglichen es RxScale, Ihr System in Echtzeit zu benachrichtigen, wenn etwas passiert — zum Beispiel eine Bestellstatusänderung, eine Rezeptunterschrift oder der Versand einer Bestellung durch eine Apotheke. Diese Seite erklärt, wie Sie Webhooks einrichten und effektiv nutzen.

​
Webhooks einrichten

Um Webhook-Benachrichtigungen zu erhalten:
1

Ihren Endpoint vorbereiten

Erstellen Sie einen HTTP-Endpoint auf Ihrem Server, der POST-Anfragen empfangen kann. Dieser Endpoint sollte öffentlich erreichbar sein und eingehende Webhook-Payloads verarbeiten können.
2

Ihren Webhook registrieren

Verwenden Sie die Management API, um Ihre Webhook-Endpoint-URL zu registrieren. Sie geben an, welche Ereignistypen Sie empfangen möchten.
3

Ihre Einrichtung überprüfen

RxScale sendet ein Testereignis an Ihren Endpoint. Stellen Sie sicher, dass Ihr Server mit einem 200-Statuscode antwortet, um die Funktionsfähigkeit zu bestätigen.
4

Ereignisse empfangen

Nach der Registrierung empfängt Ihr Endpoint Webhook-Benachrichtigungen für die von Ihnen abonnierten Ereignistypen.

​
Verfügbare Ereignistypen

RxScale sendet Webhook-Benachrichtigungen für eine Vielzahl von Ereignissen. Hier sind die häufigsten:
EreignistypWann er ausgelöst wird
Order createdEine neue Bestellung wurde aufgegeben.
Order updatedDer Status einer Bestellung hat sich geändert (zum Beispiel auf „waiting for pharmacy”).
Prescription approvedEin Arzt hat ein Rezept genehmigt.
Prescription signedEin Rezept wurde elektronisch unterschrieben.
Prescription declinedEin Arzt hat ein Rezept abgelehnt.
Pharmacy order updatedEine Apotheke hat den Status einer Bestellung aktualisiert (zum Beispiel versandt).
Eine vollständige Liste der Ereignistypen und deren Payload-Formate finden Sie in der Dokumentation Webhook-Ereignisse.

​
Bestellstatusänderungen überwachen

Webhooks sind der beste Weg, um über den Fortschritt Ihrer Bestellungen informiert zu bleiben. Anstatt die API wiederholt abzufragen, erhalten Sie eine Benachrichtigung in dem Moment, in dem sich etwas ändert. Ein typischer Überwachungs-Workflow:
  1. Ein Patient gibt eine Bestellung in Ihrem Shop auf.
  2. Sie erhalten einen Webhook, wenn die Bestellung erstellt wird.
  3. Sie erhalten einen Webhook, wenn der Arzt das Rezept genehmigt.
  4. Sie erhalten einen Webhook, wenn das Rezept unterschrieben wird.
  5. Sie erhalten einen Webhook, wenn die Bestellung an eine Apotheke gesendet wird.
  6. Sie erhalten einen Webhook, wenn die Apotheke die Bestellung versendet.
  7. Sie erhalten einen Webhook, wenn die Bestellung abgeschlossen wird.
Jede Benachrichtigung enthält die relevanten Bestell- oder Rezeptdaten, sodass Sie Ihre Systeme aktualisieren und Ihre Patienten in jedem Schritt informieren können.

​
Best Practices für die Webhook-Verarbeitung

Ihr Endpoint sollte so schnell wie möglich mit einem 200-Statuscode antworten. Verarbeiten Sie den Webhook-Payload bei Bedarf asynchron — blockieren Sie die Antwort nicht, während Sie langwierige Operationen durchführen.
In seltenen Fällen kann dasselbe Webhook-Ereignis mehr als einmal zugestellt werden. Gestalten Sie Ihren Handler idempotent, was bedeutet, dass die zweimalige Verarbeitung desselben Ereignisses keine Probleme verursachen sollte.
RxScale signiert Webhook-Payloads, damit Sie deren Authentizität überprüfen können. Verifizieren Sie die Signatur immer, bevor Sie den Payload verarbeiten. Weitere Details finden Sie unter Webhook-Sicherheit.
Wenn Ihr Endpoint nicht erreichbar ist oder Fehler zurückgibt, werden Webhook-Zustellungen erneut versucht. Richten Sie ein Monitoring ein, um zu erkennen, wenn Ihr Endpoint ausfällt, damit Sie Probleme schnell beheben können.
Führen Sie ein Protokoll aller empfangenen Webhook-Ereignisse. Dies ist von unschätzbarem Wert für die Fehlersuche und das Verständnis der Ereignisabfolge für eine bestimmte Bestellung.

​
Verwandte Themen