$questionnaire-packageOperasi FHIR untuk HealthLake

$questionnaire-packageOperasi mengambil bundel komprehensif yang berisi Kuesioner FHIR dan semua dependensinya yang diperlukan untuk membuat dan memproses kuesioner. Operasi ini mengimplementasikan Panduan Implementasi Template dan Aturan Dokumentasi Da Vinci (DTR), memungkinkan rendering formulir dinamis untuk persyaratan dokumentasi dalam alur kerja perawatan kesehatan.

Cara kerjanya

Kasus penggunaan

Titik akhir API

POST /datastore/{datastoreId}/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json

Permintaan parameter

Parameter input

Badan permintaan harus berisi sumber daya Parameter FHIR dengan parameter berikut:

Aturan validasi parameter

Setidaknya SATU dari berikut ini harus disediakan (selain yang diperlukancoverage):

Kombinasi Permintaan yang Valid:

Contoh permintaan

POST /datastore/example-datastore/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json  
Authorization: Bearer <your-token>  
  
{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": {  
        "resourceType": "Coverage",  
        "id": "example-coverage",  
        "status": "active",  
        "beneficiary": {  
          "reference": "Patient/example-patient"  
        },  
        "payor": [{  
          "reference": "Organization/example-payer"  
        }],  
        "class": [{  
          "type": {  
            "coding": [{  
              "system": "http://terminology.hl7.org/CodeSystem/coverage-class",  
              "code": "group"  
            }]  
          },  
          "value": "12345"  
        }]  
      }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0"  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "id": "example-service-request",  
        "status": "active",  
        "intent": "order",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660",  
            "display": "Continuous positive airway pressure ventilation (CPAP)"  
          }]  
        },  
        "subject": {  
          "reference": "Patient/example-patient"  
        }  
      }  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-01-01T00:00:00Z"  
    }  
  ]  
}

Format respons

Respon sukses (200 OK)

Operasi mengembalikan sumber daya Parameter FHIR yang berisi satu atau lebih Package Bundle. Setiap Package Bundle meliputi:

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "PackageBundle",  
      "resource": {  
        "resourceType": "Bundle",  
        "id": "questionnaire-package-example",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle"]  
        },  
        "type": "collection",  
        "timestamp": "2024-03-15T10:30:00Z",  
        "entry": [  
          {  
            "fullUrl": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
            "resource": {  
              "resourceType": "Questionnaire",  
              "id": "home-oxygen-therapy",  
              "url": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
              "version": "2.0",  
              "status": "active",  
              "title": "Home Oxygen Therapy Documentation",  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "type": "choice",  
                  "answerValueSet": "http://example.org/fhir/ValueSet/oxygen-diagnoses"  
                }  
              ]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/Library/oxygen-prepopulation",  
            "resource": {  
              "resourceType": "Library",  
              "id": "oxygen-prepopulation",  
              "url": "http://example.org/fhir/Library/oxygen-prepopulation",  
              "version": "1.0",  
              "type": {  
                "coding": [{  
                  "system": "http://terminology.hl7.org/CodeSystem/library-type",  
                  "code": "logic-library"  
                }]  
              },  
              "content": [{  
                "contentType": "text/cql",  
                "data": "bGlicmFyeSBPeHlnZW5QcmVwb3B1bGF0aW9u..."  
              }]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
            "resource": {  
              "resourceType": "ValueSet",  
              "id": "oxygen-diagnoses",  
              "url": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
              "status": "active",  
              "expansion": {  
                "timestamp": "2024-03-15T10:30:00Z",  
                "contains": [  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J44.0",  
                    "display": "COPD with acute lower respiratory infection"  
                  },  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J96.01",  
                    "display": "Acute respiratory failure with hypoxia"  
                  }  
                ]  
              }  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/QuestionnaireResponse/example-prepopulated",  
            "resource": {  
              "resourceType": "QuestionnaireResponse",  
              "id": "example-prepopulated",  
              "questionnaire": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0",  
              "status": "in-progress",  
              "subject": {  
                "reference": "Patient/example-patient"  
              },  
              "basedOn": [{  
                "reference": "ServiceRequest/example-service-request"  
              }],  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "answer": [{  
                    "valueCoding": {  
                      "system": "http://hl7.org/fhir/sid/icd-10",  
                      "code": "J44.0",  
                      "display": "COPD with acute lower respiratory infection"  
                    }  
                  }]  
                }  
              ]  
            }  
          }  
        ]  
      }  
    },  
    {  
      "name": "Outcome",  
      "resource": {  
        "resourceType": "OperationOutcome",  
        "issue": [{  
          "severity": "information",  
          "code": "informational",  
          "details": {  
            "text": "Successfully retrieved questionnaire package"  
          }  
        }]  
      }  
    }  
  ]  
}

Alur kerja operasi

Bagaimana HealthLake Memproses Permintaan Anda

Saat Anda menelepon $questionnaire-package HealthLake , lakukan langkah-langkah berikut:

Hasil: Paket lengkap dan mandiri yang siap untuk dirender.

Tanggapan kesalahan

400 Permintaan Buruk

Dikembalikan ketika validasi permintaan gagal.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "required",  
    "details": {  
      "text": "At least one of 'questionnaire' or 'order' must be provided along with 'coverage'"  
    }  
  }]  
}

424 Ketergantungan Gagal

Dikembalikan ketika sumber daya dependen tidak dapat diambil.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "warning",  
    "code": "not-found",  
    "details": {  
      "text": "Referenced Library 'http://example.org/fhir/Library/missing-library' could not be retrieved"  
    }  
  }]  
}

401 Tidak Sah

Dikembalikan ketika kredensi otentikasi hilang atau tidak valid.

403 Dilarang

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

406 Tidak Dapat Diterima

Dikembalikan ketika jenis konten yang diminta tidak dapat disediakan.

409 Konflik

Dikembalikan ketika ada versi atau konflik konkurensi.

410 Hilang

Dikembalikan ketika sumber daya yang diminta telah dihapus secara permanen.

429 Terlalu Banyak Permintaan

Dikembalikan ketika batas tarif terlampaui.

500 Kesalahan Server Internal

Dikembalikan ketika terjadi kesalahan server yang tidak terduga.

501 Tidak Diimplementasikan

Dikembalikan ketika operasi yang diminta belum dilaksanakan.

Aturan validasi

Validasi masukan

QuestionnaireResponse validasi

Deduplikasi sumber daya

Spesifikasi kinerja

Izin yang diperlukan

Untuk menggunakan $questionnaire-package operasi, pastikan peran IAM Anda memiliki:

SMART pada Lingkup FHIR

Cakupan minimum yang diperlukan:

Catatan implementasi penting

Strategi pengambilan sumber daya

Prioritas Identifikasi Kuesioner:

Resolusi ketergantungan

Perpustakaan CQL:

ValueSets:

QuestionnaireResponse pra-populasi

Operasi dapat mengembalikan data yang telah QuestionnaireResponse diisi sebelumnya ketika:

Kriteria Pencarian untuk QuestionnaireResponse:

Pemfilteran sumber daya yang diubah

Ketika changedSince parameter disediakan:

Beberapa paket bundel

Operasi dapat mengembalikan beberapa Package Bundle ketika:

Setiap Package Bundle mandiri dengan semua dependensi yang diperlukan.

Kasus penggunaan umum

Kasus Penggunaan 1: Dokumentasi Otorisasi Sebelumnya

Skenario: Penyedia perlu mengumpulkan dokumentasi untuk terapi oksigen rumah sebelum otorisasi.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Patient's insurance coverage */ }  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660"  
          }]  
        }  
      }  
    }  
  ]  
}

Hasil: Mengembalikan paket dengan kuesioner terapi oksigen, diisi sebelumnya dengan tanda vital pasien dan kode diagnosis dari EHR.

Kasus Penggunaan 2: Ambil Versi Kuesioner Khusus

Skenario: Penyedia membutuhkan versi kuesioner tertentu untuk kepatuhan.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/dme-request|3.1.0"  
    }  
  ]  
}

Hasil: Mengembalikan persis versi 3.1.0 dari kuesioner permintaan DME dengan semua dependensi.

Kasus Penggunaan 3: Periksa Pembaruan

Skenario: Penyedia ingin memeriksa apakah ada sumber kuesioner yang telah diperbarui sejak pengambilan terakhir.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/medication-request"  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-03-01T00:00:00Z"  
    }  
  ]  
}

Hasil: Mengembalikan hanya sumber daya yang telah dimodifikasi setelah 1 Maret 2024, atau paket kosong jika tidak ada yang berubah.

Kasus Penggunaan 4: Beberapa Pesanan

Skenario: Penyedia mengirimkan beberapa permintaan layanan yang mungkin memerlukan kuesioner yang berbeda.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for imaging */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for DME */ }  
    }  
  ]  
}

Hasil: Mengembalikan beberapa Paket Paket, satu untuk setiap kuesioner yang berlaku.

Integrasi dengan Da Vinci Lainnya IGs

Penemuan Persyaratan Cakupan (CRD)

Integrasi Alur Kerja:

Prior Authorization Support (PAS)

Integrasi Alur Kerja:

Data Exchange Klinis (CDex)

Integrasi Alur Kerja:

Panduan pemecahan masalah

Masalah: Tidak Ada Kuesioner yang Dikembalikan

Kemungkinan Penyebab:

Solusi:

Masalah: Dependensi Hilang dalam Package

Kemungkinan Penyebab:

Solusi:

Masalah: Paket Kosong dengan ChangedSince

Kemungkinan Penyebab:

Solusi:

Masalah: QuestionnaireResponse Tidak Terisi

Kemungkinan Penyebab:

Solusi:

Praktik terbaik

1. Gunakan Canonical URLs dengan Versi

Selalu tentukan nomor versi saat meminta kuesioner tertentu:

{  
  "name": "questionnaire",  
  "valueCanonical": "http://example.org/fhir/Questionnaire/dme|2.1.0"  
}

Mengapa: Memastikan konsistensi dan mencegah perubahan tak terduga saat kuesioner diperbarui.

2. Leverage BerubahSejak untuk Kinerja

Untuk kuesioner yang sering diakses, gunakan changedSince untuk meminimalkan transfer data:

{  
  "name": "changedSince",  
  "valueDateTime": "2024-03-10T15:30:00Z"  
}

Mengapa: Mengurangi penggunaan latensi dan bandwidth dengan hanya mengambil sumber daya yang diperbarui.

3. Sertakan Informasi Cakupan Lengkap

Berikan detail cakupan yang komprehensif untuk memastikan pemilihan kuesioner yang benar:

{  
  "name": "coverage",  
  "resource": {  
    "resourceType": "Coverage",  
    "beneficiary": { "reference": "Patient/123" },  
    "payor": [{ "reference": "Organization/payer-abc" }],  
    "class": [{ /* Group/plan information */ }]  
  }  
}

Mengapa: Membantu HealthLake mengidentifikasi kuesioner dan persyaratan khusus pembayar.

Operasi terkait