$member-addOperation für HealthLake - AWS HealthLake
Endpunkt des VorgangsParametersBeispiele anfordernReaktion-FormatGeschäftsregelnAuthentifizierung und AutorisierungBetriebsverhaltenEinschränkungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

$member-addOperation für HealthLake

Die $member-add FHIR-Operation fügt einer Gruppenressource, insbesondere einer Mitgliedsattributionsliste, ein Mitglied (Patient) hinzu. Dieser Vorgang ist Teil des Leitfadens zur Implementierung der DaVinci Mitgliederzuweisung und unterstützt den Abgleichprozess bei der Verwaltung von Mitgliederzuordnungen.

Endpunkt des Vorgangs

POST [base]/datastore/{datastoreId}/r4/Group/{groupId}/$member-add
Content-Type: application/json

Parameters

Der Vorgang akzeptiert eine FHIR-Parameter-Ressource mit den folgenden Parameterkombinationen:

Parameter-Optionen

Sie können eine der folgenden Parameterkombinationen verwenden:

Option 1: Mitglieds-ID + Anbieter-NPI

memberId + providerNpi

memberId + providerNpi + attributionPeriod

Option 2: Patientenreferenz + Anbieterreferenz

patientReference + providerReference

patientReference + providerReference + attributionPeriod

Einzelheiten zu den Parametern

Mitglieds-ID (optional)

Die ID des Mitglieds, das der Gruppe hinzugefügt werden soll.

Typ: Bezeichner

System: Patientenidentifizierungssystem

{
  "name": "memberId",
  "valueIdentifier": {
    "system": "http://example.org/patient-id",
    "value": "patient-new"
  }
}
Anbieter NPI (fakultativ)

Der National Provider Identifier (NPI) des zugewiesenen Anbieters.

Typ: Identifier

System: http://terminology.hl7. org/CodeSystem/NPI

{
  "name": "providerNpi",
  "valueIdentifier": {
    "system": "http://terminology.hl7.org/CodeSystem/NPI",
    "value": "1234567890"
  }
}
Patientenreferenz (optional)

Direkter Verweis auf die Patientenressource, die hinzugefügt werden soll.

Typ: Referenz

{
  "name": "patientReference",
  "valueReference": {
    "reference": "Patient/patient-123"
  }
}
Anbieterreferenz (optional)

Direkter Verweis auf die Provider-Ressource.

Typ: Referenz

{
  "name": "providerReference",
  "valueReference": {
    "reference": "Practitioner/provider-456"
  }
}
Zeitraum der Zuordnung (optional)

Der Zeitraum, über den der Patient dem Anbieter zugeordnet wird.

Typ: Zeitraum

{
  "name": "attributionPeriod",
  "valuePeriod": {
    "start": "2024-07-15",
    "end": "2025-07-14"
  }
}

Beispiele anfordern

Verwenden der Mitglieds-ID und des Anbieter-NPI

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "memberId",
      "valueIdentifier": {
        "system": "http://example.org/patient-id",
        "value": "patient-new"
      }
    },
    {
      "name": "providerNpi",
      "valueIdentifier": {
        "system": "http://terminology.hl7.org/CodeSystem/NPI",
        "value": "1234567890"
      }
    },
    {
      "name": "attributionPeriod",
      "valuePeriod": {
        "start": "2024-07-15",
        "end": "2025-07-14"
      }
    }
  ]
}

Verwendung von Patienten- und Anbieterreferenzen

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/patient-123"
      }
    },
    {
      "name": "providerReference",
      "valueReference": {
        "reference": "Practitioner/provider-456"
      }
    },
    {
      "name": "attributionPeriod",
      "valuePeriod": {
        "start": "2024-07-15",
        "end": "2025-07-14"
      }
    }
  ]
}

Reaktion-Format

Erfolgreiche Antwort auf den Zusatz

HTTP Status: 200 OK
Content-Type: application/fhir+json

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "success",
      "code": "informational",
      "details": {
        "text": "Member Patient/patient-new successfully added to the Member Attribution List."
      }
    }
  ]
}

Fehlermeldungen

Ungültige Anforderungssyntax

HTTP-Status: 400 Ungültige Anfrage

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "details": {
        "text": "Invalid parameter combination provided"
      }
    }
  ]
}
Ressource nicht gefunden

HTTP-Status: 404 nicht gefunden

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "details": {
        "text": "Resource not found."
      }
    }
  ]
}
Versionskonflikt

HTTP-Status: 409-Konflikt

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "conflict",
      "details": {
        "text": "Resource version conflict detected"
      }
    }
  ]
}
Ungültiger Zuordnungsstatus

HTTP-Status: 422 Unverarbeitbare Entität

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "business-rule",
      "details": {
        "text": "Cannot add member to Attribution List with status 'final'. Status must be 'draft' or 'open'."
      }
    }
  ]
}

Geschäftsregeln

Überprüfung des Zuordnungsstatus

Der Vorgang kann nur ausgeführt werden, wenn der Zuordnungsstatus der Gruppe wie folgt lautet:

  • draft

  • open

Operationen sind nicht zulässig, wenn der Status lautetfinal.

Verhinderung doppelter Mitglieder

Das System verhindert das Hinzufügen doppelter Mitglieder auf der Grundlage der einzigartigen Kombination von:

  • Mitglieds-ID

  • Kennung des Zahlers

  • Kennung des Versicherungsschutzes

Validierung des Deckungszeitraums

Wenn eine bereitgestellt attributionPeriod wird, muss sie innerhalb der Grenzen des Versicherungszeitraums des Mitglieds liegen. Das System wird:

  • Suchen Sie nach der Ressource für den Versicherungsschutz des Mitglieds

  • Verwenden Sie das neueste Coverage (höchste versionId), falls mehrere existieren

  • Stellen Sie sicher, dass der Zuweisungszeitraum den Deckungszeitraum nicht überschreitet

Validierung von Referenzen

Wenn sowohl die ID als auch die Referenz für dieselbe Ressource (Patient oder Anbieter) angegeben werden, überprüft das System, ob sie derselben Ressource entsprechen.

Wenn sowohl die Felder ID als auch reference.identifier für dieselbe Ressource (Patient oder Anbieter) angegeben werden, wird ein Fehler ausgegeben.

Authentifizierung und Autorisierung

Für den Vorgang ist eine SMART-On-FHIR-Autorisierung erforderlich für:

  • Leseberechtigungen — Um die Ressourcen von Patienten, Anbietern und Gruppen zu validieren

  • Suchberechtigungen — Um Ressourcen anhand ihrer ID zu finden

  • Berechtigungen aktualisieren — Um die Gruppenressource zu ändern

Betriebsverhalten

Aktualisierungen der Ressourcen

  • Aktualisiert die Versions-ID der Gruppenressource

  • Erstellt einen Verlaufseintrag mit dem ursprünglichen Ressourcenstatus vor dem Vorgang

  • Fügt dem Group.Member-Array Mitgliedsinformationen hinzu mit:

    • Patientenreferenz in entity.reference

    • Zuordnungszeitraum im Zeitraum

    • Reichweite und Anbieterinformationen in Erweiterungsfeldern

Schritte zur Validierung

  • Parametervalidierung — Stellt gültige Parameterkombinationen sicher

  • Vorhandensein von Ressourcen — Überprüft, ob Patienten-, Anbieter- und Gruppenressourcen vorhanden sind

  • Zuordnungsstatus — Bestätigt, dass der Gruppenstatus Änderungen zulässt

  • Doppelte Prüfung — Verhindert das Hinzufügen vorhandener Mitglieder

  • Deckungsüberprüfung — Stellt sicher, dass der Zuweisungszeitraum innerhalb der Deckungsgrenzen liegt

Einschränkungen

  • Alle Ressourcen, auf die verwiesen wird, müssen sich im selben Datenspeicher befinden

  • Der Vorgang funktioniert nur mit Ressourcen der Member Attribution List Group

  • Die Zuordnungszeiträume müssen innerhalb der Deckungsgrenzen liegen

  • Gruppen mit dem Status „Endgültig“ können nicht geändert werden