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

# Anamnese

> Externe Anamnesedaten übermitteln und mit Patienten verknüpfen

# Anamnese

Die Anamnese-API ermöglicht es externen Anbietern, medizinische Fragebogenantworten (Anamnesedaten) zu übermitteln und mit Patienten im RxScale-System zu verknüpfen.

## Basispfad

```
/api/v3-1/anamnesis
```

## Authentifizierung

Alle Endpoints erfordern einen API-Schlüssel über den `X-API-Key`-Header. Siehe [Authentifizierung](/de/authentication) für Details.

<Note>
  Der veraltete `X-RxScale-Authorization`-Header wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt, jedoch wird `X-API-Key` für neue Integrationen empfohlen.
</Note>

## Externe Anamnese übermitteln

Übermitteln Sie Anamnesedaten eines externen Anbieters für einen bestimmten Fragebogen.

```bash theme={null}
POST /api/v3-1/anamnesis/questionnaires/{questionnaire_uid}/external/submissions
```

<ParamField path="questionnaire_uid" type="string" required>
  Die UID des Fragebogens, für den die Anamnese übermittelt werden soll
</ParamField>

### Anfragekörper

```json theme={null}
{
  "data": {
    "lastName": "Müller",
    "dob": "1990-05-15"
  },
  "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
  "external_identifier": "ext-submission-001"
}
```

| Feld                     | Typ    | Erforderlich | Beschreibung                                                                  |
| ------------------------ | ------ | ------------ | ----------------------------------------------------------------------------- |
| `data`                   | object | Ja           | Die Anamnese-Antwortdaten. Die Struktur hängt von der Fragebogendefinition ab |
| `anamnesis_provider_uid` | string | Ja           | Ihre Anamnese-Anbieter-UID (von RxScale bereitgestellt)                       |
| `external_identifier`    | string | Ja           | Ihr externer Bezeichner für diese Übermittlung (zur Nachverfolgung)           |

### Beispielanfrage

```bash theme={null}
curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/questionnaires/abc123-def456/external/submissions" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {"lastName": "Müller", "dob": "1990-05-15"},
    "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
    "external_identifier": "ext-submission-001"
  }'
```

<Note>
  Die Struktur des `data`-Objekts muss mit den im Fragebogen definierten Feldern übereinstimmen. Kontaktieren Sie Ihren RxScale-Ansprechpartner, um das Fragebogenschema zu erhalten.
</Note>

## Anamnese mit Patient verknüpfen

Verknüpfen Sie eine übermittelte Anamnese mit einem Patientenprofil anhand der Shop-Kunden-ID.

```bash theme={null}
POST /api/v3-1/anamnesis/{anamnesis_uid}/patient
```

<ParamField path="anamnesis_uid" type="string" required>
  Die UID der zu verknüpfenden Anamnese-Übermittlung
</ParamField>

### Anfragekörper

```json theme={null}
{
  "shop_identifier": "my-store.myshopify.com",
  "shop_patient_id": "CUST123"
}
```

| Feld              | Typ    | Erforderlich | Beschreibung                        |
| ----------------- | ------ | ------------ | ----------------------------------- |
| `shop_identifier` | string | Ja           | Ihr Shop-Bezeichner                 |
| `shop_patient_id` | string | Ja           | Die Kunden-ID aus Ihrem Shop-System |

### Beispielanfrage

```bash theme={null}
curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/xyz789/patient" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_identifier": "my-store.myshopify.com",
    "shop_patient_id": "CUST123"
  }'
```

<Warning>
  Jede Anamnese-Übermittlung kann nur mit einem Patienten verknüpft werden. Der Versuch, eine bereits verknüpfte Anamnese erneut zuzuordnen, führt zu einem Fehler.
</Warning>

## Typischer Integrationsablauf

<Steps>
  <Step title="Anamnese übermitteln">
    Ihr externes System erfasst die Fragebogenantworten des Patienten und übermittelt diese über den Endpoint für externe Übermittlungen.
  </Step>

  <Step title="Anamnese-UID erhalten">
    Die API gibt eine Anamnese-UID zurück, die Sie zusammen mit der Übermittlung in Ihrem System speichern.
  </Step>

  <Step title="Mit Patient verknüpfen">
    Wenn der Patient in Ihrem Shop identifiziert wird (z. B. beim Checkout), verknüpfen Sie die Anamnese mit seinem Patientenprofil.
  </Step>

  <Step title="Ärztliche Prüfung">
    Die verknüpfte Anamnese steht zur ärztlichen Prüfung im RxScale-Arztportal zur Verfügung.
  </Step>
</Steps>