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 Fehlt Eine
?pharmacy_uid=<Apotheken-UID> an jede URL unten an. Ein Schlüssel für eine einzelne Apotheke lässt den Parameter weg.pharmacy_uid bei einem gruppenweiten Schlüssel, antwortet die API mit 400: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 aufin-progress:
In Progress zu Ready for Pickup (nur Abholung)
Sobald eine Abholbestellung verpackt ist und auf den Patienten wartet, setzen Sieready_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 Siecomplete_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 Ereignistyppharmacy_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
Bestellungen zeitnah verarbeiten
Bestellungen zeitnah verarbeiten
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.Status bei jedem Schritt aktualisieren
Status bei jedem Schritt aktualisieren
Halten Sie den Status aktuell. Eine genaue Statusverfolgung unterstützt die Kundenkommunikation, das Reporting und die Problemlösung.
Stornierungen ordnungsgemäß behandeln
Stornierungen ordnungsgemäß behandeln
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.Status nicht überspringen
Status nicht überspringen
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.