Bestelllebenszyklus

Statusübergänge von Bestellungen in RxScale verstehen

​

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

  init
     |
     v
waiting for pharmacy -----> cancelled
     |
     v
 pending review ----------> cancelled
     |
     v
 in-progress
     |
     v
ready_for_pickup
     |
     v
 completed

​

Statusbeschreibungen

Status	Beschreibung	Wer setzt ihn
init	Bestellung wurde im System erstellt, ist aber noch keiner Apotheke zugewiesen	System
waiting for pharmacy	Bestellung ist einer Apotheke zugewiesen und bereit zur Verarbeitung	System
pending review	Apotheke prüft die Bestellung und die Verfügbarkeit	Apotheke (über API)
in-progress	Apotheke hat mit der Vorbereitung begonnen	Apotheke (über API)
ready_for_pickup	Bestellung ist verpackt und bereit zur Abholung oder zum Versand	Apotheke (über API)
completed	Bestellung wurde zugestellt und abgeschlossen (einschließlich Bestandsreduzierung)	Apotheke (über Complete-Endpoint)
cancelled	Bestellung wurde vor Abschluss storniert	System oder Apotheke

​

Übergänge

​

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:

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": "pending review"}'

​

Pending Review zu In Progress

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

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"}'

​

In Progress zu Ready for Pickup

Sobald die Bestellung verpackt und zur Abholung oder zum Versand bereit ist, aktualisieren Sie den Status auf ready_for_pickup:

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"}'

​

Ready for Pickup zu Completed

Wenn die Bestellung zugestellt oder anderweitig erfüllt wurde, schließen Sie sie über den dedizierten Complete-Order-Endpoint ab. Dieser Schritt umfasst die Bestandsreduzierung und den Bestellabschluss.

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"
      }
    ]
  }'

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:

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": "cancelled"}'

​

Webhook-Benachrichtigungen

Sie erhalten Webhook-Benachrichtigungen bei Statusänderungen, wenn Sie den Ereignistyp pharmacy_order_updated abonniert haben. Jede Benachrichtigung enthält die vollständigen Bestelldaten mit dem neuen Status.

Siehe Webhook-Ereignisse für Payload-Details.

​

Best Practices

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

Halten Sie den Status aktuell. Eine genaue Statusverfolgung unterstützt die Kundenkommunikation, das Reporting und die Problemlösung.

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

Folgen Sie immer der Reihenfolge: waiting for pharmacy zu pending review zu in-progress zu ready_for_pickup. Verwenden Sie complete_order erst, wenn die Bestellung erfüllt ist.