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

# Patienten

> Patientenprofile über die Management API suchen und anzeigen

# Patienten

Suchen Sie Patienten anhand ihrer E-Mail-Adresse, zeigen Sie Patientenprofile an und prüfen Sie den Intent-Status von Patienten.

## Patient erstellen oder auflösen

Erstellen Sie ein Patientenprofil für einen Shop-Kunden oder erhalten Sie das bestehende Profil zurück, wenn die Kombination aus `shop_uid` und `shop_customer_id` bereits existiert. Dies ist der unterstützte Patientenerstellungs-Flow für API-Key-Integrationen, die anschließend Scheduling verwenden.

```bash theme={null}
POST /v1/management/patients
```

**Erforderliche Berechtigung:** `patient:write`

```bash theme={null}
curl -X POST "https://api.rxscale.com/v1/management/patients" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_uid": "shop_123",
    "shop_customer_id": "customer_456",
    "email": "max@example.com",
    "fields": [
      {
        "field": "first_name",
        "value": "Max",
        "source": "shop"
      }
    ]
  }'
```

<ParamField body="shop_uid" type="string" required>
  UID des Shops, zu dem der Kunde gehört
</ParamField>

<ParamField body="shop_customer_id" type="string" required>
  Kennung des Kunden im Shop
</ParamField>

<ParamField body="email" type="string">
  Optionale Patienten-E-Mail, die auf der Shop-Patienten-Zuordnung gespeichert und für Patientensuche verwendet wird.
</ParamField>

<ParamField body="fields" type="array">
  Optionale Patientenprofilfelder, die für den Shop-Kunden gesetzt werden.
</ParamField>

```json theme={null}
{
  "patient_profile_uid": "pp-abc123"
}
```

## Patient per E-Mail suchen

Finden Sie einen Patienten anhand seiner E-Mail-Adresse. Gibt den zuletzt erstellten Patienten zurück, dessen Shop-Patienten-E-Mail oder Bestell-E-Mail mit der angegebenen E-Mail übereinstimmt.

```bash theme={null}
GET /v1/management/patients?email={email}
```

<ParamField query="email" type="string" required>
  Die zu suchende E-Mail-Adresse
</ParamField>

**Erforderliche Berechtigung:** `patient:read`

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/patients?email=max@example.com" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "uid": "pp-abc123",
  "data": {
    "display_name": "Max Mustermann",
    "email": "max@example.com",
    "date_of_birth": "1990-01-15"
  }
}
```

### Fehlerantworten

| Statuscode | Beschreibung                                     |
| ---------- | ------------------------------------------------ |
| `400`      | Fehlender oder ungültiger E-Mail-Parameter       |
| `404`      | Kein Patient mit der angegebenen E-Mail gefunden |

## Patientenprofil abrufen

Rufen Sie ein Patientenprofil anhand der UID ab.

```bash theme={null}
GET /v1/management/patients/{patient_uid}
```

<ParamField path="patient_uid" type="string" required>
  Die Patienten-UID
</ParamField>

**Erforderliche Berechtigung:** `patient:read`

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/patients/pp-abc123" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "uid": "pp-abc123",
  "data": {
    "display_name": "Max Mustermann",
    "email": "max@example.com",
    "date_of_birth": "1990-01-15"
  }
}
```

## Patienten-Intent prüfen

Prüfen Sie den Intent-Rückgabecode für einen Patienten. Gibt einen Code zurück, der angibt, wann die letzte signierte Einreichung für diesen Intent erfolgte.

```bash theme={null}
GET /v1/management/patients/{patient_uid}/intent/{intent}
```

<ParamField path="patient_uid" type="string" required>
  Die Patienten-UID
</ParamField>

<ParamField path="intent" type="string" required>
  Der Intent-Bezeichner
</ParamField>

**Erforderliche Berechtigung:** `patient:read`

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/patients/pp-abc123/intent/consultation" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "return_code": "VALID"
}
```

### Rückgabecode-Werte

| Code        | Beschreibung                                                         |
| ----------- | -------------------------------------------------------------------- |
| `VALID`     | Der Patient hat eine gültige, aktuelle Einreichung für diesen Intent |
| `EXPIRED`   | Die letzte Einreichung des Patienten ist abgelaufen                  |
| `NOT_FOUND` | Keine Einreichung für diesen Intent gefunden                         |