$member-removeoperasi untuk HealthLake - AWS HealthLake
PrasyaratDetail OperasiParameterContoh PermintaanResponsPerilakuPenanganan KesalahanPraktik Terbaik

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

$member-removeoperasi untuk HealthLake

$member-removeOperasi 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

  • AWS HealthLake Datasore FHIR

  • Izin IAM yang sesuai untuk operasi HealthLake

  • Daftar Atribusi Anggota (Sumber daya grup) dalam draf atau status terbuka

Detail Operasi

Titik akhir

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

Jenis Konten

application/fhir+json

Parameter

Operasi menerima sumber daya Parameter FHIR dengan parameter opsional berikut:

Parameter Kardinalitas Jenis 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

Kombinasi parameter berikut didukung:

  • memberIdonly - Menghapus semua atribusi untuk anggota yang ditentukan

  • memberId+ providerNpi - Menghapus atribusi untuk kombinasi member-provider tertentu

  • patientReferencehanya - Menghapus semua atribusi untuk pasien yang ditentukan

  • patientReference+ providerReference - Menghapus atribusi untuk kombinasi pasien-penyedia tertentu

  • patientReference+ providerReference + coverageReference - Menghapus atribusi spesifik berdasarkan pasien, penyedia, dan cakupan

Contoh Permintaan

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

Respons

Respon yang Berhasil

{
  "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

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

Tanggapan Kesalahan Umum

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

  • 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