Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

StatusBeschreibungWer setzt ihn
initBestellung wurde im System erstellt, ist aber noch keiner Apotheke zugewiesenSystem
waiting for pharmacyBestellung ist einer Apotheke zugewiesen und bereit zur VerarbeitungSystem
pending reviewApotheke prüft die Bestellung und die VerfügbarkeitApotheke (über API)
in-progressApotheke hat mit der Vorbereitung begonnenApotheke (über API)
ready_for_pickupBestellung ist verpackt und bereit zur Abholung oder zum VersandApotheke (über API)
completedBestellung wurde zugestellt und abgeschlossen (einschließlich Bestandsreduzierung)Apotheke (über Complete-Endpoint)
cancelledBestellung wurde vor Abschluss storniertSystem 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-v1/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-v1/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-v1/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-v1/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-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 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 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.