Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# `$member-remove`operasi untuk HealthLake
<a name="reference-fhir-operations-member-remove"></a>

`$member-remove`Operasi ini memungkinkan Anda untuk menghapus anggota dari Daftar Atribusi Anggota FHIR (sumber daya Grup) di. AWS HealthLake Operasi ini merupakan bagian dari Panduan Implementasi Atribusi DaVinci Anggota dan mendukung proses rekonsiliasi untuk mengelola atribusi anggota.

## Prasyarat
<a name="member-remove-prerequisites"></a>
+ AWS HealthLake Datasore FHIR
+ Izin IAM yang sesuai untuk operasi HealthLake 
+ Daftar Atribusi Anggota (Sumber daya grup) dalam draf atau status terbuka

## Detail Operasi
<a name="member-remove-endpoint"></a>

Titik akhir  
`POST /Group/{id}/$member-remove`

Jenis Konten  
`application/fhir+json`

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

Operasi menerima sumber daya Parameter FHIR dengan parameter opsional berikut:


| Parameter | Kardinalitas | Tipe | Deskripsi | 
| --- | --- | --- | --- | 
| MemberID | 0.. 1 | Pengidentifikasi | Pengenal bisnis anggota yang akan dihapus | 
| ProviderNPI | 0.. 1 | Pengidentifikasi | NPI dari penyedia yang dikaitkan | 
| PatientReferensi | 0.. 1 | Referensi | Referensi langsung ke sumber daya Pasien | 
| Penyedia Referensi | 0.. 1 | Referensi | Referensi langsung ke sumber daya Penyedia (Praktisi, PractitionerRole, atau Organisasi) | 
| CoverageReference | 0.. 1 | Referensi | Referensi ke sumber daya Cakupan | 

### Kombinasi Parameter yang Didukung
<a name="member-remove-parameter-combinations"></a>

Kombinasi parameter berikut didukung:
+ `memberId`only - Menghapus semua atribusi untuk anggota yang ditentukan
+ `memberId`\$1 `providerNpi` - Menghapus atribusi untuk kombinasi member-provider tertentu
+ `patientReference`hanya - Menghapus semua atribusi untuk pasien yang ditentukan
+ `patientReference`\$1 `providerReference` - Menghapus atribusi untuk kombinasi pasien-penyedia tertentu
+ `patientReference`\$1 `providerReference` \$1 `coverageReference` - Menghapus atribusi spesifik berdasarkan pasien, penyedia, dan cakupan

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

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

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

### Respon yang Berhasil
<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"
    }
  ]
}
```

## Perilaku
<a name="member-remove-behavior"></a>

Persyaratan Status  
Operasi hanya berfungsi pada daftar atribusi dengan status `draft` atau `open`  
Daftar dengan `final` status akan menolak operasi dengan kesalahan 422

Proses Penghapusan Anggota  
*Daftar Status Draf*: Anggota ditandai sebagai tidak aktif (`inactive: true`) dan `changeType` ekstensi mereka diperbarui ke `changed`  
*Daftar Status Terbuka*: Perilaku serupa dengan status draf  
*Daftar Status Akhir*: Operasi ditolak

Validasi  
Referensi divalidasi untuk memastikan mereka ada di datastore HealthLake   
Jika pengenal dan referensi disediakan untuk jenis sumber daya yang sama, mereka harus sesuai dengan sumber daya yang sama  
Kombinasi parameter divalidasi sesuai dengan pola yang didukung

## Penanganan Kesalahan
<a name="member-remove-error-handling"></a>

### Tanggapan Kesalahan Umum
<a name="member-remove-common-errors"></a>

Sumber Daya Tidak Ditemukan (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"]
    }
  ]
}
```

Status Akhir Daftar Atribusi (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"]
    }
  ]
}
```

Operasi Tidak Valid (400)  
Dikembalikan ketika kombinasi parameter tidak valid atau cacat.

Ditemukan Beberapa Pertandingan (412)  
Dikembalikan ketika parameter yang disediakan cocok dengan beberapa anggota dalam daftar atribusi.  

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

## Praktik Terbaik
<a name="member-remove-best-practices"></a>
+ *Gunakan Parameter Spesifik*: Jika memungkinkan, gunakan kombinasi parameter yang paling spesifik untuk menghindari penghapusan yang tidak diinginkan
+ *Periksa Status Daftar*: Verifikasi status daftar atribusi sebelum mencoba menghapus
+ *Menangani Kesalahan dengan Anggun*: Menerapkan penanganan kesalahan yang tepat untuk semua kemungkinan kondisi kesalahan
+ *Validasi Referensi*: Pastikan semua sumber daya yang direferensikan ada sebelum membuat permintaan