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.

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):

{
  "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.

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"
  }'

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.

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.

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:

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

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.

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.

Erste Schritte

Externe Apotheken-API

Management-API

Scheduling API

Öffentliche API

Patienten-API

Anamnese-API

Webhooks

Anleitungen

Anamnese

Anamnese

Anamnese mit Patient verknüpfen

Patient identifizieren

Anamnese identifizieren

Fehlerantworten

Nach dem Verknüpfen

​Anamnese

​Anamnese mit Patient verknüpfen

​Patient identifizieren

​Anamnese identifizieren

​Fehlerantworten

​Nach dem Verknüpfen

Anamnese

Anamnese mit Patient verknüpfen

Patient identifizieren

Anamnese identifizieren

Fehlerantworten

Nach dem Verknüpfen