$member-removeOperation für HealthLake - AWS HealthLake
VoraussetzungenEinzelheiten des VorgangsParametersAnforderungsbeispielAntwortBehaviorFehlerbehandlungBewährte Methoden

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-removeOperation für HealthLake

Mit $member-remove diesem Vorgang können Sie Mitglieder aus einer FHIR-Mitgliederzuordnungsliste (Gruppenressource) in entfernen. AWS HealthLake Dieser Vorgang ist Teil des Leitfadens zur Implementierung der DaVinci Mitgliederzuweisung und unterstützt den Abgleichprozess bei der Verwaltung von Mitgliederzuweisungen.

Voraussetzungen

  • AWS HealthLake FHIR-Datenspeicher

  • Entsprechende IAM-Berechtigungen für Operationen HealthLake

  • Zuordnungsliste für Mitglieder (Gruppenressource) im Status Entwurf oder offen

Einzelheiten des Vorgangs

Endpoint

POST /Group/{id}/$member-remove

Inhaltstyp

application/fhir+json

Parameters

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

Parameter Kardinalität Typ Description
memberId 0.. 1 Kennung Geschäfts-ID des zu entfernenden Mitglieds
Anbieter/NPI 0.. 1 Kennung NPI des zugewiesenen Anbieters
Referenz des Patienten 0.. 1 Referenz Direkter Verweis auf die Patientenressource
Referenz des Anbieters 0.. 1 Referenz Direkter Verweis auf die Anbieter-Ressource (Praktiker oder Organisation) PractitionerRole
Referenz zum Geltungsbereich 0.. 1 Referenz Verweis auf die Coverage-Ressource

Unterstützte Parameterkombinationen

Die folgenden Parameterkombinationen werden unterstützt:

  • memberIdnur — Entfernt alle Zuweisungen für das angegebene Mitglied

  • memberId+ providerNpi — Entfernt Zuweisungen für die spezifische Kombination aus Mitglied und Anbieter

  • patientReferencenur — Entfernt alle Zuordnungen für den angegebenen Patienten

  • patientReference+ providerReference — Entfernt Zuordnungen für die spezifische Kombination aus Patient und Anbieter

  • patientReference+ providerReference + coverageReference — Entfernt die spezifische Zuordnung auf der Grundlage von Patient, Anbieter und Versicherungsschutz

Anforderungsbeispiel

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/12345"
      }
    },
    {
      "name": "providerReference",
      "valueReference": {
        "reference": "Practitioner/67890"
      }
    }
  ]
}

Antwort

Erfolgreiche Antwort

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "effectiveDate",
      "valueDate": "2024-06-30"
    },
    {
      "name": "status",
      "valueCode": "inactive"
    },
    {
      "name": "message",
      "valueString": "Member successfully removed from attribution list"
    }
  ]
}

Behavior

Anforderungen an den Status

Die Operation funktioniert nur bei Attributionslisten mit Status oder draft open

Listen mit final Status lehnen den Vorgang mit einem 422-Fehler ab

Verfahren zur Entfernung von Mitgliedern

Entwürfe von Statuslisten: Mitglieder werden als inaktiv markiert (inactive: true) und ihre changeType Erweiterung wird aktualisiert auf changed

Statuslisten öffnen: Ähnliches Verhalten wie beim Entwurfsstatus

Endgültige Statuslisten: Der Vorgang wurde abgelehnt

Validierung

Verweise werden überprüft, um sicherzustellen, dass sie im HealthLake Datenspeicher vorhanden sind

Wenn sowohl der Bezeichner als auch der Verweis für denselben Ressourcentyp angegeben werden, müssen sie derselben Ressource entsprechen

Parameterkombinationen werden gemäß den unterstützten Mustern validiert

Fehlerbehandlung

Häufige Fehlerantworten

Ressource nicht gefunden (404)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "details": {
        "text": "Patient with identifier 'http://example.org/fhir/identifiers|99999' not found in system"
      },
      "diagnostics": "Cannot remove member from attribution list. Verify patient identifier and try again.",
      "expression": ["memberId"]
    }
  ]
}
Endgültiger Status der Attributionsliste (422)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "business-rule",
      "details": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/us/davinci-atr/CodeSystem/atr-error-codes",
            "code": "list-final",
            "display": "Attribution list is final and cannot be modified"
          }
        ]
      },
      "diagnostics": "Cannot modify attribution list with status 'final'. List modifications are not permitted after finalization.",
      "expression": ["Group.status"]
    }
  ]
}
Ungültiger Vorgang (400)

Wird zurückgegeben, wenn Parameterkombinationen ungültig oder falsch formatiert sind.

Es wurden mehrere Treffer gefunden (412)

Wird zurückgegeben, wenn die angegebenen Parameter mit mehreren Mitgliedern in der Attributionsliste übereinstimmen.

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "processing",
      "diagnostics": "Multiple members found matching the criteria"
    }
  ]
}

Bewährte Methoden

  • Spezifische Parameter verwenden: Verwenden Sie nach Möglichkeit die spezifischste Parameterkombination, um unbeabsichtigte Löschungen zu vermeiden

  • Status der Liste überprüfen: Überprüfen Sie den Status der Zuordnungsliste, bevor Sie versuchen, Dateien zu entfernen

  • Gehen Sie ordnungsgemäß mit Fehlern um: Implementieren Sie eine angemessene Fehlerbehandlung für alle möglichen Fehlerbedingungen

  • Referenzen validieren: Stellen Sie sicher, dass alle referenzierten Ressourcen vorhanden sind, bevor Sie die Anfrage stellen