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

  created
     |
     v
   open ---------> cancelled
     |
     v
 processing -----> cancelled
     |
     v
  shipped
     |
     v
 completed

​
Statusbeschreibungen

StatusBeschreibungWer setzt ihn
createdBestellung wurde im System erstellt, ist aber noch keiner Apotheke zugewiesenSystem
openBestellung ist einer Apotheke zugewiesen und bereit zur VerarbeitungSystem
processingApotheke hat die Bestellung bestätigt und mit der Vorbereitung begonnenApotheke (über API)
shippedBestellung wurde an den Patienten versendetApotheke (über API)
completedBestellung wurde zugestellt und abgeschlossen (einschließlich Bestandsreduzierung)System
cancelledBestellung wurde vor Abschluss storniertSystem oder Apotheke

​
Übergänge

​
Open zu Processing

Wenn Ihre Apotheke eine neue Bestellung erhält (Status: open), bestätigen Sie diese, indem Sie den Status auf processing aktualisieren: 
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "processing"}'

​
Processing zu Shipped

Sobald die Bestellung verpackt und dem Versanddienstleister übergeben wurde, aktualisieren Sie den Status auf shipped: 
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/pharmacy_orders/po-abc123/status" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"status": "shipped"}'

​
Shipped zu Completed

Der Übergang von shipped zu completed wird automatisch vom RxScale-System durchgeführt. Dieser Schritt umfasst die Bestandsreduzierung und den Bestellabschluss.
Das Setzen des Status auf completed ist über die API nicht möglich. Der Bestellabschluss wird über einen dedizierten internen Prozess abgewickelt.

​
Stornierung

Eine Bestellung kann aus dem Status open oder processing storniert werden: 
curl -X PATCH "https://api.rxscale.com/v1/external-pharmacy-api-v1/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

Setzen Sie Bestellungen von open auf processing, sobald Ihr Team mit der Bearbeitung 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 immer der Reihenfolge: open zu processing zu shipped. Springen Sie nicht direkt von open zu shipped.