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

> Eine Anamnese mit einer Patientin oder einem Patienten verknüpfen

# Anamnese

Eine Anamnese ist ein ausgefüllter Fragebogen. Sie wird häufig erhoben, bevor feststeht, zu
welcher Kundin oder welchem Kunden sie gehört -- etwa wenn ein Formular ausgefüllt wird,
bevor eine Bestellung existiert. Dieser Endpoint verknüpft sie mit einer Patientin oder
einem Patienten.

## Anamnese mit Patient verknüpfen

Erfordert einen API-Schlüssel mit der Berechtigung `anamnesis:connect_patient`.

```bash theme={null}
curl -X POST "https://api.rxscale.com/v1/management/anamnesis/patient-connections" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_identifier": "mein-shop",
    "shop_customer_id": "kunden-123",
    "anamnesis_uid": "an-abc123"
  }'
```

**Antwort** (`200 OK`):

```json theme={null}
{
  "status": "success"
}
```

### Patient identifizieren

`shop_identifier` und `shop_customer_id` sind immer erforderlich. Gemeinsam benennen sie die
Kundin oder den Kunden in Ihrem Shop -- dasselbe Paar, das auch die Wallet-Pass- und
Patienten-Endpoints verwenden. Der Shop muss zu Ihrer Organisation gehören.

### Anamnese identifizieren

Geben Sie **genau eine** der drei folgenden Adressierungsarten an. Die letzte ist ein Paar:
Beide Hälften gehören zusammen, und nur eine davon anzugeben ist ein Fehler und keine dritte
Variante.

| Variante               | Felder                                              | Wann verwenden                                                    |
| ---------------------- | --------------------------------------------------- | ----------------------------------------------------------------- |
| Intern                 | `anamnesis_uid`                                     | Sie haben die Anamnese-UID bereits von RxScale                    |
| Extern über UID        | `external_submission_uid`                           | Sie haben über die Anamnesis API eingereicht und die UID behalten |
| Extern über Identifier | `external_identifier` **und** `provider_identifier` | Sie führen Einreichungen unter Ihrem eigenen Identifier           |

Beide externen Varianten wandeln die Einreichung zunächst in eine interne Anamnese um und
verknüpfen dann die Patientin oder den Patienten damit. Die Umwandlung ist wiederholbar: Ein
erneuter Aufruf verwendet die beim ersten Mal erzeugte Anamnese weiter, statt eine zweite
anzulegen.

```bash theme={null}
curl -X POST "https://api.rxscale.com/v1/management/anamnesis/patient-connections" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_identifier": "mein-shop",
    "shop_customer_id": "kunden-123",
    "external_identifier": "ihre-einreichungs-id",
    "provider_identifier": "ihre-provider-id"
  }'
```

<Info>
  Wird **dieselbe** Patientin oder derselbe Patient erneut verknüpft, liefert der Endpoint
  `200` und ändert nichts. Eine Anfrage, deren Antwort Sie nicht erhalten haben, können Sie
  daher gefahrlos wiederholen.
</Info>

<Warning>
  Eine Anamnese kann nur einmal verknüpft werden. Wird eine **andere** Patientin oder ein
  anderer Patient mit einer bereits verknüpften Anamnese verbunden, liefert der Endpoint `409`
  und die bestehende Verknüpfung bleibt unverändert.
</Warning>

### Fehlerantworten

| Code  | Bedeutung                                                                                                                                                |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Validierungsfehler -- auch bei fehlender Adressierungsart, mehr als einer, oder nur einer Hälfte des Paars `external_identifier` / `provider_identifier` |
| `401` | Fehlender oder ungültiger API-Schlüssel                                                                                                                  |
| `403` | Dem API-Schlüssel fehlt `anamnesis:connect_patient`                                                                                                      |
| `404` | Shop, Patient, Anamnese, externe Einreichung oder Provider nicht gefunden oder nicht Teil Ihrer Organisation                                             |
| `409` | Die Anamnese ist bereits mit einer anderen Patientin oder einem anderen Patienten verknüpft                                                              |

Ein `400` benennt die betroffenen Felder:

```json theme={null}
{
  "error": {
    "_schema": [
      "Supply exactly one of: anamnesis_uid, external_submission_uid, or external_identifier together with provider_identifier."
    ]
  }
}
```

<Note>
  Alles, was zu einer anderen Organisation gehört, liefert `404` -- genau wie etwas, das nicht
  existiert. Die Antwort bestätigt also nie, ob ein Datensatz real ist.
</Note>

### Nach dem Verknüpfen

Nach der Verknüpfung werden die Antworten des Fragebogens in die Profilfelder der Patientin
oder des Patienten übernommen. Die Anamnese erscheint zudem in der RxScale-Oberfläche bei der
Patientin oder dem Patienten.