Zum Hauptinhalt springen

Patienten

Einen Patienten verknüpfen​

Sobald die Ärzte Legit.Health nutzen, ist es an der Zeit, auch die Patienten einzubinden, damit sie ebenfalls von der Technologie profitieren können.

Um Patienten verknüpfen zu können, müssen Sie den Endpunkt createPatient verwenden. Wenn Sie die Daten an diesen Endpunkt senden, verbindet Ihre Software die Daten eines Patienten mit Legit.Health.

Der Patient muss sein Konto bestätigen. Dazu müssen Sie die Kontaktinformationen des Patienten angeben.

  • Wenn Sie eine E-Mail-Adresse angeben, wird eine E-Mail an den Patienten gesendet, damit er sein Konto bestätigen kann.
  • Wenn Sie eine Telefonnummer angeben, wird eine SMS an den Patienten geschickt, damit er sein Konto bestätigen kann.

Es ist nicht erforderlich, aber wenn möglich, sollten Sie auch das Krankeitsbild des Patienten in der Anfrage angeben, indem Sie die Eigenschaft Krankheitsbild auswählen. Dieses Feld zeigt eine Liste von Einträgen, die den Code der Pathologie und die Körperstelle enthalten. Die vollständige Liste der Codes finden Sie in der Swagger-Dokumentation.

Wenn Sie einen Patienten hinzufügen, bei dem mehrere Krankheitsbilder diagnostiziert wurden, wird automatisch eine aktive Behandlungsepisode für jedes Krankheitsbild erstellt.

Anmeldedaten erstellen​

Der Patient wird die Legit.Health-Technologie nutzen können, ohne sich in ein anderes System einloggen zu müssen. Mit anderen Worten: Ihre Software zeigt eine Schaltfläche, die Patienten, wenn sie darauf klicken, automatisch zur Legit.Health-Schnittstelle weiterleitet, als ob es sich um dieselbe Umgebung handeln würde – ohne dass sie sich anmelden oder zusätzliche Klicks ausführen müssen.

Damit dies funktioniert, müssen Sie den Endpunkt getPatientsAuthTokens verwenden, um die entsprechenden Token zu erzeugen, damit sich ein Patient direkt anmelden kann.

Sie können Ihre Software auch so programmieren, dass der Patient eine E-Mail mit dem Anmeldelink erhält. Wenn Sie den Parameter sendLinkToPatientByEmail an die Anfrage anhängen, erhält der Patient eine E-Mail mit einem Link zur Anmeldung bei der Legit.Health-Schnittstelle.

Die Anmeldelinks sind folgendermaßen aufgebaut:

https://app.legit.health/u/home?token=token&refresh_token=refresh_token

Erstellen einer Behandlungsepisode für einen Patienten​

Um eine neue Behandlungsepisode für das Krankheitsbild eines Patienten zu erstellen, können Sie den Endpunkt createEpisodeOfCare verwenden.

Sie können keine aktive Behandlungsepisode erstellen, wenn das Krankheitsbild bereits eine aktive Behandlungsepisode hat.

Erstellen Sie eine Sitzung für einen Patienten​

Sie können eine Sitzung mit dem Endpunkt createEncounter erstellen.

Wenn das Feld planned_for in der Zukunft liegt, erhält die Sitzung den Status geplant.

Wenn das Feld planned_for in der Zukunft liegt, erhält die Sitzung den Status bereit, so dass sie vom Patienten sofort durchgeführt werden kann.

Patientendaten abfragen​

Die Verbindung mit den Patienten funktioniert in beide Richtungen. Nachdem Sie die Patientendaten gesendet haben, werden Sie die Daten eines Patienten abfragen wollen, um diese in Ihr HRM aufzunehmen.

Um Patientendaten zu erhalten, müssen Sie den Endpunkt getPatients verwenden.

Sie müssen die IDs der einzelnen Patienten in Ihrer Plattform in dem URL-Parameter externalIds angeben. Zum Beispiel:

​​?externalIds[]=a449666c710c&externalIds[]=baa3cf93-6f1c

Behandlungsepisode des Patienten abfragen​

Es ist möglich, dass mehrere Behandlungsepisoden auf der Legit.Health-Plattform erstellt werden, und zwar vom Patienten selbst oder sogar vom Arzt, wenn er Bilder hochlädt. In diesem Fall möchten Sie diese Daten evtl. abrufen, um sie in Ihrem HRM zu speichern.

Zum Abrufen der Behandlungsepisode des Patienten müssen Sie den Endpunkt _getEpisodesOfCare_ verwenden.

Sie müssen die ID des Krankheitsbildes angeben. Diese ID wird vom Endpunkt getPatients innerhalb der Eigenschaft Krankheitsbild zurückgegeben.

Patient korrigieren​

Unter Umständen möchten Sie die Daten eines bereits mit Legit.Health verknüpften Patienten bearbeiten.

Um die Daten eines Patienten zu korrigieren, können Sie den Endpunkt patchPatient verwenden.

Dieser Endpunkt ist nützlich, wenn Sie bestimmte Daten über einen verknüpften Patienten aktualisieren möchten, beispielsweise:

  • Ein neues Krankheitsbild hinzufügen. Dies bedeutet, dass im System eine neue Behandlungsepisode mit dem Status "aktiv" für dieses Krankheitsbild erzeugt wird.
  • Ein bestehendes Krankheitsbild pausieren. Dies bedeutet, dass die aktive Behandlungsepisode für das Krankheitsbild in den Status "beendet" versetzt wird.
  • Überwachung eines bestehenden Krankheitsbildes. Dies bedeutet, dass im System eine neue Behandlungsepisode mit dem Status "aktiv" für dieses Krankheitsbild erzeugt wird. Sitzungen werden automatisch mit der angegebenen Häufigkeit erstellt, damit der Arzt das Krankheitsbild überwachen kann.
  • Bearbeitung der wichtigsten Daten des Patienten.

Sie können verschiedene Beispiele für die Verwendung dieses Endpunkts im entsprechenden Abschnitt der Swagger-Dokumentation einsehen.

Behandlungsepisode der Patienten korrigieren​

Sie können die Behandlungsepisode, wie sie in Ihrem HRM identifiziert sind, mit den Behandlungsepisoden in Legit.Health abgleichen.

Um die Daten der Behandlungsepisoden eines Patienten zu korrigieren, können Sie den Endpunkt patchEpisodeOfCare verwenden.

Dieser Endpunkt ist nützlich, wenn Sie Ihre Behandlungsepisoden mit den in Legit.Health erstellten Behandlungsepisoden abgleichen möchten. Damit dies funktioniert, verwendet der Endpunkt die interne ID, die für die Behandlungsepisode in der Legit.Health-Anwendung generiert wird.

Der empfohlene Ablauf für die Korrektur einer Behandlungsepisode ist folgender:

  • Ermitteln Sie zunächst die Behandlungsepisode für das Krankheitsbild des Patienten mithilfe des Endpunkts getEpisodesOfCare.
  • Verwenden Sie dann die interne ID der Behandlungsepisode für die Erstellung der Patch-URL.