Cara kerjanya Titik akhir API Struktur permintaan Contoh permintaan Format respons Tanggapan kesalahan Aturan validasi Spesifikasi kinerja Izin yang diperlukan Catatan implementasi penting Contoh alur kerja Operasi terkait

`$inquire`Operasi FHIR untuk HealthLake

$inquireOperasi ini memungkinkan Anda untuk memeriksa status permintaan otorisasi sebelumnya yang diajukan sebelumnya. Operasi ini mengimplementasikan Panduan Implementasi Da Vinci Prior Authorization Support (PAS), menyediakan alur kerja berbasis FHIR standar untuk mengambil keputusan otorisasi saat ini.

Cara kerjanya

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

$inquireadalah 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


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

Struktur permintaan

Persyaratan bundel

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

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

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


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

Respon sukses (200 OK)

Anda akan menerima Paket Respons Pertanyaan PAS yang berisi:

ClaimResponsedengan status otorisasi saat ini; beberapa ClaimResponsejika 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

400 Permintaan Buruk

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

Dikembalikan ketika kredensi otentikasi hilang atau tidak valid.


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

403 Dilarang

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

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

Dikembalikan ketika header Content-Type bukan application/fhir+json.


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

429 Terlalu Banyak Permintaan

Dikembalikan ketika batas tarif terlampaui.


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

Aturan validasi

HealthLake melakukan validasi komprehensif atas pertanyaan Anda:

Validasi bundel

Harus sesuai dengan profil Paket Permintaan Pertanyaan PAS
Bundle.typeharus "collection"
Harus berisi persis satu sumber Klaim
Semua sumber daya yang direferensikan harus disertakan dalam Bundel

Validasi klaim

Harus sesuai dengan profil Permintaan Klaim PAS
Claim.useharus "preauthorization"
Claim.statusharus "active"
Bidang yang diperlukan:patient,insurer,provider, created

Validasi sumber daya

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

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

Izin yang diperlukan

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

Perilaku pencarian

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

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

$inquireOperasi:

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

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"

Claim/$submit- Kirim permintaan otorisasi sebelumnya yang baru atau perbarui yang sudah ada
Patient/$everything- Ambil data pasien yang komprehensif untuk konteks otorisasi sebelumnya

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

$ ekspor

$lookup

$inquireOperasi FHIR untuk HealthLake