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

# `$inquire`Operasi FHIR untuk HealthLake
<a name="reference-fhir-operations-inquire"></a>

`$inquire`Operasi ini memungkinkan Anda untuk memeriksa status permintaan otorisasi sebelumnya yang diajukan sebelumnya. Operasi ini mengimplementasikan Panduan [Implementasi Da Vinci Prior Authorization Support (PAS)](https://hl7.org/fhir/us/davinci-pas/), menyediakan alur kerja berbasis FHIR standar untuk mengambil keputusan otorisasi saat ini.

## Cara kerjanya
<a name="inquire-how-it-works"></a>
+ **Kirim Pertanyaan**: Anda mengirim Paket FHIR yang berisi Klaim yang ingin Anda periksa dan informasi pendukung
+ **Cari**: HealthLake mencari yang sesuai ClaimResponse di penyimpanan data Anda
+ **Ambil**: Status otorisasi terbaru diambil
+ **Tanggapan**: Anda menerima tanggapan langsung dengan status otorisasi saat ini (mengantri, disetujui, ditolak, dll.)

**catatan**  
`$inquire`adalah **operasi hanya-baca yang mengambil status** otorisasi yang ada. Itu tidak mengubah atau memperbarui sumber daya apa pun di penyimpanan data Anda.

## Titik akhir API
<a name="inquire-api-endpoint"></a>

```
POST /datastore/{datastoreId}/r4/Claim/$inquire  
Content-Type: application/fhir+json
```

## Struktur permintaan
<a name="inquire-request-structure"></a>

### Persyaratan bundel
<a name="inquire-bundle-requirements"></a>

Permintaan Anda harus berupa sumber daya Bundel FHIR dengan:
+ **Bundle.type**: Harus `"collection"`
+ **Bundle.entry**: Harus berisi tepat **satu** sumber Klaim dengan:
  + `use = "preauthorization"`
  + `status = "active"`
+ **Sumber Daya yang Direferensikan**: Semua sumber daya yang direferensikan oleh Klaim harus disertakan dalam Bundel

**Kueri demi contoh**  
Sumber daya dalam Bundle masukan Anda berfungsi sebagai template pencarian. HealthLake menggunakan informasi yang diberikan untuk menemukan yang sesuai ClaimResponse.

### Sumber daya yang dibutuhkan
<a name="inquire-required-resources"></a>


| Sumber daya | Kardinalitas | Profil | Deskripsi | 
| --- | --- | --- | --- | 
| Klaim | 1 | Permintaan Klaim PAS | Otorisasi sebelumnya yang Anda tanyakan | 
| Pasien | 1 | Pasien Penerima PAS | Informasi demografis pasien | 
| Organisasi (Penanggung) | 1 | Organisasi Penanggung PAS | Perusahaan asuransi | 
| Organisasi (Penyedia) | 1 | Organisasi Permintaan PAS | Penyedia layanan kesehatan yang mengajukan permintaan | 

### Kriteria pencarian penting
<a name="inquire-search-criteria"></a>

HealthLake pencarian untuk ClaimResponse menggunakan:
+ **Referensi pasien** dari Klaim
+ **Referensi Penanggung dari Klaim**
+ **Referensi penyedia** dari Klaim
+ **Tanggal dibuat** dari Klaim (sebagai filter waktu)

**Hanya Pertanyaan Khusus Pasien**  
Semua pertanyaan harus dikaitkan dengan pasien tertentu. Pertanyaan di seluruh sistem tanpa identifikasi pasien tidak diizinkan.

## Contoh permintaan
<a name="inquire-example-request"></a>

```
POST /datastore/example-datastore/r4/Claim/$inquire  
Content-Type: application/fhir+json  
Authorization: Bearer <your-token>  
  
{  
  "resourceType": "Bundle",  
  "id": "PASClaimInquiryBundleExample",  
  "meta": {  
    "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-pas-inquiry-request-bundle"]  
  },  
  "identifier": {  
    "system": "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER",  
    "value": "5269368"  
  },  
  "type": "collection",  
  "timestamp": "2005-05-02T14:30:00+05:00",  
  "entry": [  
    {  
      "fullUrl": "http://example.org/fhir/Claim/MedicalServicesAuthorizationExample",  
      "resource": {  
        "resourceType": "Claim",  
        "id": "MedicalServicesAuthorizationExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:01:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "provider": {  
          "reference": "Organization/UMOExample"  
        }  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Patient/SubscriberExample",  
      "resource": {  
        "resourceType": "Patient",  
        "id": "SubscriberExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary"]  
        },  
        "name": [{  
          "family": "SMITH",  
          "given": ["JOE"]  
        }],  
        "gender": "male"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/UMOExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "UMOExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor"]  
        },  
        "name": "Provider Organization"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/InsurerExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "InsurerExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer"]  
        },  
        "name": "Insurance Company"  
      }  
    }  
  ]  
}
```

## Format respons
<a name="inquire-response-format"></a>

### Respon sukses (200 OK)
<a name="inquire-success-response"></a>

Anda akan menerima Paket Respons Pertanyaan PAS yang berisi:
+ **ClaimResponse**dengan status otorisasi saat ini; beberapa **ClaimResponse**jika cocok dengan kriteria pencarian
+ Semua sumber daya asli dari permintaan Anda (bergema kembali)
+ Stempel waktu saat respons dirakit

**Kemungkinan ClaimResponse Hasil**  



| Hasil | Deskripsi | 
| --- | --- | 
| queued | Permintaan otorisasi masih menunggu peninjauan | 
| complete | Keputusan otorisasi telah dibuat (periksa disposition untuk disetujui/ditolak) | 
| error | Terjadi kesalahan selama pemrosesan | 
| partial | Otorisasi sebagian diberikan | 

```
{  
  "resourceType": "Bundle",  
  "identifier": {  
        "system": "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER",  
        "value": "5269367"  
  },  
  "type": "collection",  
  "timestamp": "2005-05-02T14:30:15+05:00",  
  "entry": [  
    {  
      "fullUrl": "http://example.org/fhir/ClaimResponse/InquiryResponseExample",  
      "resource": {  
        "resourceType": "ClaimResponse",  
        "id": "InquiryResponseExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claimresponse-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:05:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "request": {  
          "reference": "Claim/MedicalServicesAuthorizationExample"  
        },  
        "outcome": "complete",  
        "disposition": "Approved",  
        "preAuthRef": "AUTH12345"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Claim/MedicalServicesAuthorizationExample",  
      "resource": {  
        "resourceType": "Claim",  
        "id": "MedicalServicesAuthorizationExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:01:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "provider": {  
          "reference": "Organization/UMOExample"  
        }  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Patient/SubscriberExample",  
      "resource": {  
        "resourceType": "Patient",  
        "id": "SubscriberExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary"]  
        },  
        "name": [{  
          "family": "SMITH",  
          "given": ["JOE"]  
        }],  
        "gender": "male"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/UMOExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "UMOExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor"]  
        },  
        "name": "Provider Organization"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/InsurerExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "InsurerExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer"]  
        },  
        "name": "Insurance Company"  
      }  
    }  
  ]  
}
```

## Tanggapan kesalahan
<a name="inquire-error-responses"></a>

### 400 Permintaan Buruk
<a name="inquire-400-error"></a>

Dikembalikan ketika format permintaan tidak valid atau validasi gagal.

```
{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "required",  
            "diagnostics": "Reference 'Patient/SubscriberExample' at path 'patient' for 'CLAIM' resource not found(at Bundle.entry[0].resource)"  
        }  
    ]  
}
```

### 401 Tidak Sah
<a name="inquire-401-error"></a>

Dikembalikan ketika kredensi otentikasi hilang atau tidak valid.

```
{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "forbidden",  
            "diagnostics": "Invalid authorization header"  
        }  
    ]  
}
```

### 403 Dilarang
<a name="inquire-403-error"></a>

Dikembalikan ketika pengguna yang diautentikasi tidak memiliki izin untuk mengakses sumber daya yang diminta.

```
{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "exception",  
            "diagnostics": "Insufficient SMART scope permissions."  
        }  
    ]  
}
```

### 400 Ketika tidak ada yang ditemukan
<a name="inquire-400-none-found"></a>

Dikembalikan ketika tidak ClaimResponse ada kecocokan yang ditemukan untuk penyelidikan.

```
{  
  "resourceType": "OperationOutcome",
  "issue": [{
    "severity": "error",
    "code": "not-found",
    "diagnostics": "Resource not found. No ClaimResponse found from the input Claim that matches the specified Claim properties patient, insurer, provider, and created(at Bundle.entry[0].resource)"
  }]
}
```

### 415 Jenis Media yang Tidak Didukung
<a name="inquire-415-error"></a>

Dikembalikan ketika header Content-Type bukan application/fhir\$1json.

```
{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "value",  
    "diagnostics": "Incorrect MIME-type. Update request Content-Type header."  
  }]  
}
```

### 429 Terlalu Banyak Permintaan
<a name="inquire-429-error"></a>

Dikembalikan ketika batas tarif terlampaui.

```
{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "throttled",  
    "diagnostics": "Rate limit exceeded. Please retry after some time."  
  }]  
}
```

## Aturan validasi
<a name="inquire-validation-rules"></a>

HealthLake melakukan validasi komprehensif atas pertanyaan Anda:

### Validasi bundel
<a name="inquire-bundle-validation"></a>
+ Harus sesuai dengan profil Paket Permintaan Pertanyaan PAS
+ `Bundle.type`harus `"collection"`
+ Harus berisi persis satu sumber Klaim
+ Semua sumber daya yang direferensikan harus disertakan dalam Bundel

### Validasi klaim
<a name="inquire-claim-validation"></a>
+ Harus sesuai dengan profil Permintaan Klaim PAS
+ `Claim.use`harus `"preauthorization"`
+ `Claim.status`harus `"active"`
+ Bidang yang diperlukan:`patient`,`insurer`,`provider`, `created`

### Validasi sumber daya
<a name="inquire-resource-validation"></a>
+ Semua sumber daya harus sesuai dengan profil Penyelidikan PAS masing-masing
+ Sumber daya pendukung yang diperlukan harus ada (Pasien, Organisasi Penanggung, Organisasi Penyedia)
+ Referensi silang harus valid dan dapat diselesaikan dalam Bundel

## Spesifikasi kinerja
<a name="inquire-performance-specs"></a>


| Metrik | Spesifikasi | 
| --- | --- | 
| Batas Hitungan Sumber Daya | 500 sumber daya per Bundel | 
| Batas Ukuran Bundel | Maksimum 5 MB | 

## Izin yang diperlukan
<a name="inquire-required-permissions"></a>

Untuk menggunakan `$inquire` operasi, pastikan peran IAM Anda memiliki:
+ `healthlake:InquirePreAuthClaim`- Untuk memanggil operasi

**SMART pada Lingkup FHIR**  
**Cakupan minimum yang diperlukan:**
+ **SMART v1:** `user/ClaimResponse.read`
+ **SMART v2**: `user/ClaimResponse.s`

## Catatan implementasi penting
<a name="inquire-implementation-notes"></a>

### Perilaku pencarian
<a name="inquire-search-behavior"></a>

Saat Anda mengirimkan pertanyaan, HealthLake cari penggunaan: ClaimResponse 
+ **Referensi pasien** dari klaim masukan
+ **Referensi Penanggung dari Masukan** Klaim
+ **Referensi penyedia** dari Klaim masukan
+ **Tanggal dibuat** dari Klaim masukan (sebagai filter waktu)

**Beberapa Kecocokan**: Jika beberapa ClaimResponses cocok dengan kriteria pencarian Anda, HealthLake mengembalikan semua hasil yang cocok. Anda harus menggunakan `ClaimResponse.created` stempel waktu terbaru untuk mengidentifikasi status terbaru.

### Klaim yang diperbarui
<a name="inquire-updated-claims"></a>

Jika Anda telah mengirimkan beberapa pembaruan ke otorisasi sebelumnya yang sama (misalnya, Klaim v1.1, v1.2, v1.3), `$inquire` operasi akan mengambil yang ClaimResponse terkait dengan **versi terbaru** berdasarkan kriteria pencarian yang disediakan.

### Operasi hanya-baca
<a name="inquire-read-only"></a>

`$inquire`Operasi:
+ **Apakah** mengambil status otorisasi yang ada
+ **Apakah** mengembalikan yang terbaru ClaimResponse
+ **Tidak** mengubah atau memperbarui sumber daya apa pun
+ **Tidak** membuat sumber daya baru
+ **Tidak** memicu pemrosesan otorisasi baru

## Contoh alur kerja
<a name="inquire-workflow-example"></a>

**Alur Kerja Permintaan Otorisasi Sebelumnya yang Khas**  


```
1. Provider submits PA request  
   POST /Claim/$submit  
   → Returns ClaimResponse with outcome="queued"  
  
2. Payer reviews request (asynchronous)  
   → Updates ClaimResponse status internally  
  
3. Provider checks status  
   POST /Claim/$inquire  
   → Returns ClaimResponse with outcome="queued" (still pending)  
  
4. Provider checks status again later  
   POST /Claim/$inquire  
   → Returns ClaimResponse with outcome="complete", disposition="Approved"
```

## Operasi terkait
<a name="inquire-related-operations"></a>
+ `Claim/$submit`- Kirim permintaan otorisasi sebelumnya yang baru atau perbarui yang sudah ada
+ `Patient/$everything`- Ambil data pasien yang komprehensif untuk konteks otorisasi sebelumnya