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

# Fitur kepatuhan CMS
<a name="reference-compliance-cms"></a>

AWS HealthLake menyediakan fitur untuk membantu Anda memenuhi persyaratan interoperabilitas dan kepatuhan CMS (Pusat Layanan Medicare & Medicaid). Fitur-fitur ini memungkinkan Anda melacak penggunaan API menurut kategori CMS dan selanjutnya melaporkan metrik penggunaan untuk tujuan kepatuhan.

**Topics**
+ [Titik akhir interoperabilitas CMS](#cms-interoperability-endpoints)
+ [CloudWatch Metrik yang disempurnakan untuk kepatuhan CMS](#cms-cloudwatch-metrics)

## Titik akhir interoperabilitas CMS
<a name="cms-interoperability-endpoints"></a>

### Ikhtisar
<a name="cms-endpoints-overview"></a>

HealthLake menyediakan empat titik akhir interoperabilitas CMS yang sesuai dengan kategori API yang diamanatkan CMS. URL dasar yang mendasari penyimpanan HealthLake data Anda tidak berubah. Titik akhir ini hanya menyediakan cara untuk mengkategorikan dan melacak panggilan API Anda untuk tujuan pelaporan CMS.

### Tujuan
<a name="cms-endpoints-purpose"></a>

Tujuan utama dari titik akhir interoperabilitas ini adalah untuk memungkinkan pelanggan untuk:
+ **Melacak transaksi API dengan mudah** berdasarkan kategori CMS
+ **Secara otomatis melaporkan** metrik penggunaan untuk kepatuhan CMS
+ **Pertahankan** alur kerja FHIR yang ada dengan perubahan minimal

Semua panggilan API berfungsi secara identik apakah Anda menggunakan titik akhir interoperabilitas atau titik akhir FHIR standar—satu-satunya perbedaan adalah bagaimana transaksi dikategorikan dalam metrik. CloudWatch 

### Titik akhir interoperabilitas CMS yang didukung
<a name="cms-supported-endpoints"></a>


| Kategori CMS | Titik Akhir Interoperabilitas | Contoh Penggunaan | 
| --- | --- | --- | 
| Akses Pasien | /patientaccess/v2/r4 | baseURL/patientaccess/v2/r4/Patient/123 | 
| Akses Penyedia | /​provideraccess/v2/r4 | baseURL/​provideraccess/v2/r4/Observation?patient=123 | 
| Pembayar ke Pembayar | /payertopayerdx/v2/r4 | baseURL/payertopayerdx/v2/r4/Practitioner/456 | 
| Layanan Auth Sebelumnya | /priorauthservice/v2/r4 | baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 | 

### Bagaimana titik akhir interoperabilitas bekerja
<a name="cms-endpoints-how-it-works"></a>

**Panggilan HealthLake API Standar:**

```
baseURL/resourceType/[id]
baseURL/resourceType?[parameters]
```

**Dengan Titik Akhir Interoperabilitas CMS:**

```
baseURL/interoperability-endpoint/resourceType/[id]
baseURL/interoperability-endpoint/resourceType?[parameters]
```

Jalur titik akhir interoperabilitas hanya disisipkan antara URL dasar Anda dan jenis sumber daya. Segala sesuatu setelah jalur titik akhir interoperabilitas tetap sama persis dengan panggilan API Anda saat ini.

### Contoh penggunaan
<a name="cms-endpoints-examples"></a>

#### Contoh 1: API Akses Pasien
<a name="cms-example-patient-access"></a>

**Panggilan API saat ini (masih berfungsi):**

```
curl -X GET \
  https://healthlake.us-east-1.amazonaws.com/datastore/abc123/r4/Patient/123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/fhir+json"
```

**Dengan titik akhir interoperabilitas Akses Pasien (untuk pelacakan CMS):**

```
curl -X GET \
  https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/fhir+json"
```

**Poin Utama:**
+ URL dasar tetap: `https://healthlake.us-east-1.amazonaws.com/datastore/abc123`
+ Titik akhir interoperabilitas dimasukkan: `/patientaccess/v2/r4`
+ Jalur sumber daya tidak berubah: `/Patient/123`
+ **Kedua panggilan mengembalikan respons yang identik**
+ Panggilan titik akhir interoperabilitas secara otomatis dilacak di bawah `URIType=patient-access` CloudWatch
+ Operasi POST, PUT, PATCH, DELETE bekerja secara identik.
+ Badan permintaan tetap tidak berubah.

### Referensi terjemahan titik akhir
<a name="cms-endpoint-translation"></a>


| Titik Akhir Interoperabilitas | Menerjemahkan Ke | Kategori CMS | 
| --- | --- | --- | 
| baseURL/patientaccess/v2/r4/Patient | baseURL/r4/Patient | Akses Pasien | 
| baseURL/​provideraccess/v2/r4/Observation | baseURL/r4/Observation | Akses Penyedia | 
| baseURL/payertopayerdx/v2/r4/Practitioner/456 | baseURL/r4/Practitioner/456 | Pembayar ke Pembayar Data Exchange | 
| baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 | baseURL/r4/ExplanationOfBenefit?patient=789 | Otorisasi Sebelumnya | 

### Catatan penting
<a name="cms-endpoints-important-notes"></a>
+ **Tidak Ada Perbedaan Fungsional**: Titik akhir interoperabilitas dan titik akhir FHIR standar mengembalikan respons yang identik dan mendukung operasi yang identik
+ **URL Dasar Tidak Berubah**: Titik akhir penyimpanan HealthLake data Anda tetap sama
+ **Integrasi Sederhana**: Masukkan jalur titik akhir interoperabilitas antara URL dasar dan tipe sumber daya Anda
+ **Pelacakan Otomatis**: CloudWatch metrik secara otomatis mengkategorikan panggilan berdasarkan titik akhir interoperabilitas yang digunakan
+ **Kompatibel Mundur**: Panggilan API yang ada tanpa titik akhir interoperabilitas terus bekerja secara normal

## CloudWatch Metrik yang disempurnakan untuk kepatuhan CMS
<a name="cms-cloudwatch-metrics"></a>

### Ikhtisar
<a name="cms-metrics-overview"></a>

Saat Anda menggunakan titik akhir interoperabilitas CMS, HealthLake secara otomatis memancarkan CloudWatch metrik yang disempurnakan dengan dimensi tambahan untuk mendukung persyaratan pelaporan CMS. Metrik ini melacak penggunaan API berdasarkan identitas pemanggil, aplikasi, dan jenis URI khusus CMS **tanpa** memerlukan konfigurasi tambahan.

### Cara kerjanya
<a name="cms-metrics-how-it-works"></a>

Saat Anda melakukan panggilan API menggunakan titik akhir interoperabilitas:

```
# This call...
curl https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123

# Automatically generates metrics with:
# - URIType: "patient-access"
# - Sub: extracted from your bearer token (SMART on FHIR datastores only)
# - ClientId: extracted from your bearer token (SMART on FHIR datastores only)
# - Plus all standard dimensions (DatastoreId, Operation, etc.)
```

**Tidak diperlukan kode atau konfigurasi tambahan.** Cukup gunakan titik akhir interoperabilitas, dan metrik yang disempurnakan akan ditangkap secara otomatis.

**catatan**  
Untuk penyimpanan data non-SMART di FHIR, `URIType` dimensi masih ditangkap, memungkinkan Anda melacak penggunaan API menurut kategori CMS. `ClientId`Dimensi `Sub` dan hanya tersedia saat menggunakan SMART pada otentikasi FHIR dengan token pembawa yang berisi klaim ini.

### Dimensi metrik baru
<a name="cms-metrics-dimensions"></a>

Selain dimensi yang ada (`DatastoreId`,,`Operation`)`DatastoreType`, dimensi berikut secara otomatis ditambahkan saat menggunakan titik akhir interoperabilitas:


| Dimensi | Deskripsi | Nilai contoh | Sumber | 
| --- | --- | --- | --- | 
| URIType | Kategori kepatuhan CMS | patient-access, provider-access, payer-to-payer, prior-authorization | Secara otomatis ditentukan dari jalur titik akhir interoperabilitas | 
| Sub | Identitas penelepon | Pengidentifikasi pengguna/entitas | Diekstrak dari klaim token pembawa sub | 
| ClientId | Pengidentifikasi aplikasi | portal\$1app, ehr\$1system | Diekstrak dari klaim token pembawa client\$1id | 

### Metrik yang tersedia
<a name="cms-available-metrics"></a>

Semua HealthLake metrik yang ada sekarang menyertakan dimensi tambahan saat menggunakan titik akhir interoperabilitas:
+ **CallCount**- Jumlah total panggilan API
+ **Latensi** - Waktu respons API dalam milidetik
+ **UserErrors**- Hitungan kesalahan klien 4xx
+ **SystemErrors**- Hitungan kesalahan server 5xx
+ **Throttles** - Hitungan permintaan yang dibatasi
+ **SuccessfulRequests**- Hitungan panggilan API yang berhasil

### Kueri metrik di CloudWatch
<a name="cms-querying-metrics"></a>

#### CloudWatch Contoh kueri wawasan
<a name="cms-cloudwatch-insights-example"></a>

**Kueri semua panggilan API Akses Pasien berdasarkan aplikasi:**

```
SELECT SUM(CallCount)
FROM "AWS/HealthLake"
WHERE DatastoreId = '75c1cf9b0d71cd38fec8f7fb317c4c1a'
    AND URIType = 'patient-access'
GROUP BY ClientId
```