> ## 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.

# Bestellungen

> Bestellstatus über die Public API abfragen

# 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.

```bash theme={null}
GET /v2/public-api/orders/{shop_identifier}
```

<ParamField path="shop_identifier" type="string" required>
  Eindeutiger Bezeichner für den Shop
</ParamField>

<ParamField query="prescription_uids" type="string" required>
  Kommagetrennte Liste von Rezept-UIDs (max. 50)
</ParamField>

**Erforderliche Berechtigung:** `order:read`

### Beispielanfrage

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

### Antwort

```json theme={null}
{
  "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

| Feld                 | Typ              | Beschreibung                                                         |
| -------------------- | ---------------- | -------------------------------------------------------------------- |
| `prescription_uid`   | string           | Die abgefragte Rezept-UID                                            |
| `order_status`       | string           | Aktueller Bestellstatus                                              |
| `fulfillment_status` | string           | Erfüllungsstatus (`fulfilled`, `unfulfilled`, `partially_fulfilled`) |
| `tracking_number`    | string oder null | Sendungsverfolgungsnummer (falls verfügbar)                          |
| `tracking_url`       | string oder null | Sendungsverfolgungs-URL (falls verfügbar)                            |
| `created_at`         | string           | Zeitstempel der Bestellerstellung (ISO 8601)                         |
| `fulfilled_at`       | string oder null | Zeitstempel der Erfüllung (ISO 8601, falls erfüllt)                  |
| `line_items`         | array            | Positionen in der Bestellung                                         |

### Fehlerantworten

| Statuscode | Beschreibung                                                            |
| ---------- | ----------------------------------------------------------------------- |
| `400`      | Fehlender `prescription_uids`-Parameter oder mehr als 50 UIDs angegeben |
| `404`      | Shop nicht gefunden                                                     |