Zum Hauptinhalt springen

Bestelllebenszyklus

Jede Bestellung in RxScale durchläuft eine Reihe von Status, während sie von der Erstellung bis zum Abschluss fortschreitet. Das Verständnis dieser Status ist entscheidend für den Aufbau einer zuverlässigen Integration.

Statusablauf

Statusbeschreibungen

Übergänge

Gruppenweite API-Schlüssel hängen ?pharmacy_uid=<Apotheken-UID> an jede URL unten 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.".

Waiting for Pharmacy zu Pending Review

Wenn Ihre Apotheke eine neue Bestellung erhält (Status: waiting for pharmacy), bestätigen Sie, dass die Prüfung begonnen hat:

Pending Review zu In Progress

Sobald die Verfügbarkeit bestätigt wurde und die Vorbereitung beginnt, aktualisieren Sie den Status auf in-progress:

In Progress zu Ready for Pickup (nur Abholung)

Sobald eine Abholbestellung verpackt ist und auf den Patienten wartet, setzen Sie ready_for_pickup. Der Identifier der Lieferart muss pickup sein.
Jede andere Lieferart liefert 400 mit code delivery_type_must_be_pickup und der Meldung Cannot set status to 'ready_for_pickup': delivery type must be 'pickup'. Hat die Bestellung keine Lieferart, lautet der Code delivery_type_required. Versandbestellungen schließen Sie aus in-progress mit complete_order ab.

Bestellung abschließen

Rufen Sie complete_order auf, wenn die Bestellung erfüllt ist. Dieser Schritt reduziert den Bestand und veröffentlicht Versand- sowie Bestellaktualisierungsereignisse. Abholbestellungen schließen Sie nach ready_for_pickup ab. Versandbestellungen — jede Lieferart außer pickup — überspringen ready_for_pickup und werden direkt aus in-progress abgeschlossen. Übergeben Sie beim Versand den Tracking-Link:
Setzen Sie completed nicht über den generischen Status-Endpoint. Verwenden Sie complete_order, damit RxScale den Bestand reduzieren und Versand- sowie Bestellaktualisierungsereignisse konsistent auslösen kann.

Stornierung

Eine Bestellung kann vor dem Abschluss storniert werden:

Webhook-Benachrichtigungen

Sie erhalten Webhook-Benachrichtigungen bei Statusänderungen und bei Sendungsaktualisierungen, wenn Sie den Ereignistyp pharmacy_order_updated abonniert haben. Jede Benachrichtigung enthält die vollständigen Bestelldaten mit dem aktuellen Status und data.shipments (von der Apotheke erfasste Pakete, einschließlich Tracking-URLs sofern vorhanden). Siehe Webhook-Ereignisse für Payload-Details, einschließlich der Feldreferenz für Sendungen.

Best Practices

Setzen Sie Bestellungen von waiting for pharmacy auf pending review, sobald Ihr Team mit der Prüfung beginnt. Dies schafft Transparenz für alle Beteiligten.
Halten Sie den Status aktuell. Eine genaue Statusverfolgung unterstützt die Kundenkommunikation, das Reporting und die Problemlösung.
Achten Sie auf pharmacy_order_updated-Webhooks mit dem Status cancelled. Wenn eine Stornierung eintrifft, während Sie eine Bestellung vorbereiten, stoppen Sie die Verarbeitung und aktualisieren Sie Ihre internen Systeme entsprechend.
Folgen Sie waiting for pharmacy zu pending review zu in-progress. Abholbestellungen gehen danach zu ready_for_pickup, bevor Sie complete_order aufrufen. Jede andere Lieferart überspringt ready_for_pickup und ruft complete_order direkt aus in-progress auf.