Zum Hauptinhalt springen

Apothekenbestellungen

Verwalten Sie Apothekenbestellungen — sehen Sie eingehende Rezeptbestellungen ein und aktualisieren Sie deren Status während der Bearbeitung.

Bestellungen auflisten

page
integer
Standard:"0"
Seitennummer (0-indiziert)
limit
integer
Standard:"50"
Anzahl der Einträge pro Seite (max. 200)
status
string
Nach Status filtern (z. B. open, processing, completed)
Nach Bestellname oder Patientenname suchen
pharmacy_uid
string
Erforderlich für gruppenweite API-Schlüssel
GET /v1/external-pharmacy-api-v1/pharmacy_orders/

Antwort

{
  "data": [
    {
      "uid": "po-abc123",
      "status": "open",
      "name": "#1001",
      "external_status": "OPEN",
      "pharmacy": {
        "uid": "ph-xyz",
        "display_name": "City Pharmacy"
      },
      "order": {
        "uid": "ord-123",
        "delivery_address": { ... },
        "invoice_address": { ... }
      },
      "order_items": [
        {
          "uid": "oi-789",
          "amount": 1,
          "sku": {
            "uid": "sku-456",
            "display_name": "Medication X 100mg",
            "pzn": "12345678"
          }
        }
      ]
    }
  ],
  "totalRegistries": 42,
  "totalPages": 1
}

Bestelldetails abrufen

GET /v1/external-pharmacy-api-v1/pharmacy_orders/{pharmacy_order_uid}
Gibt die vollständige Bestellung einschließlich Patientendaten, Arztdaten und Rezeptdatei (falls verfügbar) zurück.

Antwort (zusätzliche Felder)

{
  "uid": "po-abc123",
  "patient_data": {
    "uid": "pat-123",
    "display_name": "Max Mustermann",
    "email": "max@example.com",
    "date_of_birth": "1990-01-15"
  },
  "doctor_data": {
    "uid": "doc-456",
    "display_name": "Dr. Schmidt"
  },
  "prescription_file": {
    "filename": "prescription_001.pdf",
    "content_base64": "JVBERi0xLjQK..."
  }
}

Bestellstatus aktualisieren

PATCH /v1/external-pharmacy-api-v1/pharmacy_orders/{pharmacy_order_uid}/status

Anfragekörper

{
  "status": "processing"
}

Zulässige Statuswerte

StatusBeschreibung
openBestellung eingegangen, noch nicht begonnen
processingBestellung wird vorbereitet
shippedBestellung wurde versandt
cancelledBestellung wurde storniert
Das Setzen des Status auf completed ist über diesen Endpoint nicht verfügbar. Die Bestellungsabwicklung erfolgt über einen dedizierten Prozess, der die Bestandsreduzierung beinhaltet.