Zum Hauptinhalt springen

Bestellungen

Fragen Sie den Erfüllungsstatus von Bestellungen anhand der zugehörigen Rezept-UIDs ab.

Bestellstatus abfragen

Rufen Sie den Bestell- und Erfüllungsstatus für ein oder mehrere Rezepte ab.
GET /v2/public/orders/{shop_identifier}
shop_identifier
string
erforderlich
Eindeutiger Bezeichner für den Shop
prescription_uids
string
erforderlich
Kommagetrennte Liste von Rezept-UIDs (max. 50)
Erforderliche Berechtigung: order:read

Beispielanfrage

curl -X GET "https://api.rxscale.com/v2/public/orders/my-shop?prescription_uids=px-abc123,px-def456" \
  -H "X-API-Key: your-api-key-here"

Antwort

{
  "data": [
    {
      "prescription_uid": "px-abc123",
      "order_status": "completed",
      "fulfillment_status": "fulfilled",
      "tracking_number": "1Z999AA10123456784",
      "tracking_url": "https://tracking.example.com/1Z999AA10123456784",
      "created_at": "2025-03-15T10:30:00Z",
      "fulfilled_at": "2025-03-17T14:00:00Z",
      "line_items": [
        {
          "sku_uid": "sku-456",
          "display_name": "Medication X 100mg",
          "quantity": 1
        }
      ]
    },
    {
      "prescription_uid": "px-def456",
      "order_status": "processing",
      "fulfillment_status": "unfulfilled",
      "tracking_number": null,
      "tracking_url": null,
      "created_at": "2025-03-16T09:00:00Z",
      "fulfilled_at": null,
      "line_items": [
        {
          "sku_uid": "sku-789",
          "display_name": "Medication Y 50mg",
          "quantity": 2
        }
      ]
    }
  ]
}

Antwortfelder

FeldTypBeschreibung
prescription_uidstringDie abgefragte Rezept-UID
order_statusstringAktueller Bestellstatus
fulfillment_statusstringErfüllungsstatus (fulfilled, unfulfilled, partially_fulfilled)
tracking_numberstring oder nullSendungsverfolgungsnummer (falls verfügbar)
tracking_urlstring oder nullSendungsverfolgungs-URL (falls verfügbar)
created_atstringZeitstempel der Bestellerstellung (ISO 8601)
fulfilled_atstring oder nullZeitstempel der Erfüllung (ISO 8601, falls erfüllt)
line_itemsarrayPositionen in der Bestellung

Fehlerantworten

StatuscodeBeschreibung
400Fehlender prescription_uids-Parameter oder mehr als 50 UIDs angegeben
404Shop nicht gefunden