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-remove`Operation für HealthLake
<a name="reference-fhir-operations-member-remove"></a>

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
<a name="member-remove-prerequisites"></a>
+ AWS HealthLake FHIR-Datenspeicher
+ Entsprechende IAM-Berechtigungen für Operationen HealthLake 
+ Zuordnungsliste für Mitglieder (Gruppenressource) im Status Entwurf oder offen

## Einzelheiten des Vorgangs
<a name="member-remove-endpoint"></a>

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

Inhaltstyp  
`application/fhir+json`

## Parameters
<a name="member-remove-parameters"></a>

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
<a name="member-remove-parameter-combinations"></a>

Die folgenden Parameterkombinationen werden unterstützt:
+ `memberId`nur — Entfernt alle Zuweisungen für das angegebene Mitglied
+ `memberId`\$1 `providerNpi` — Entfernt Zuweisungen für die spezifische Kombination aus Mitglied und Anbieter
+ `patientReference`nur — Entfernt alle Zuordnungen für den angegebenen Patienten
+ `patientReference`\$1 `providerReference` — Entfernt Zuordnungen für die spezifische Kombination aus Patient und Anbieter
+ `patientReference`\$1 `providerReference` \$1 `coverageReference` — Entfernt die spezifische Zuordnung auf der Grundlage von Patient, Anbieter und Versicherungsschutz

## Anforderungsbeispiel
<a name="member-remove-examples"></a>

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

## Antwort
<a name="member-remove-response"></a>

### Erfolgreiche Antwort
<a name="member-remove-success-response"></a>

```
{
  "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
<a name="member-remove-behavior"></a>

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
<a name="member-remove-error-handling"></a>

### Häufige Fehlerantworten
<a name="member-remove-common-errors"></a>

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
<a name="member-remove-best-practices"></a>
+ *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