醫療保險理賠實作指引
0.1.3 - CI Build

This page is part of the 醫療保險理賠實作指引 (v0.1.3: Releases Ballot 2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

CapabilityStatement: 醫療保險理賠-伺服端

Official URL: https://claim.cgh.org.tw/iclaim/CapabilityStatement/CapabilityStatementiClaimServer Version: 0.1.3
Active as of 2023-08-31 Computable Name: CapabilityStatementiClaimServer

醫療保險理賠-伺服端(Server)之能力聲明

Raw OpenAPI-Swagger Definition file | Download

  • 實作指引版本:0.1.0
  • FHIR版本:4.0.1
  • 發佈日:2023-08-31
  • 發佈者:國泰金控

Server的FHIR RESTful功能要求

  • 醫療保險理賠-伺服端 必須(SHALL)
    1. 可透過FHIR RESTful API查詢的Resources
    2. 根據FHIR規範實作RESTful
    3. HTTP回傳狀態碼
      • (Status 400):無效參數(invalid parameter)
      • (Status 401/4xx):未經授權的請求(unauthorized request)
      • (Status 403):未充分授權的資料存取範圍(insufficient premission scope)
      • (Status 404):未知的resource(unknown resource)
    4. Server提供的API操作皆支援JSON格式
    5. Server提供的API操作皆支援XML格式
    6. 可識別每個新增到Server的實例(instance)之 meta.profile是否為iClaim Profiles Defining URL,並確認實例是否依循profile製作。【註:實例是指依據profile實作,將真實資料以JSON、XML或Turtle格式存放的檔案】
    7. 支援每個profile的查詢參數
    8. 使用醫療保險理賠-伺服端能力聲明中的查詢參數,支援讀取和查詢一個或多個Profile(s)。
  • 安全性
    1. Server必須(SHALL)透過回傳 HTTP 401「未授權」, HTTP 403「禁止」,或 HTTP 404 「未找到」,來拒絕任何未經授權的請求

Resources或Profiles的RESTful功能

Bundle

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 理賠用收據-診斷證明-檢驗紀錄(Bundle iClaim)
  • 支援的參照政策(Reference policy)resolves,Server會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Server仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdatereadvread
  • 查詢參數摘要
  • 符合性(Conformance)參數類型範例
    必須(SHALL)_idtokenGET [base]/Bundle?_id=[id],
    GET [base]/Bundle/[id]
    必須(SHALL)identifiertokenGET [base]/Bundle?identifier=[identifier]

Composition

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 理賠用收據-診斷證明-檢驗紀錄(Composition iClaim)
  • 支援的參照政策(Reference policy)resolves,Server會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Server仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdatereadvread
  • 查詢參數摘要
  • 符合性(Conformance)參數類型範例
    必須(SHALL)_idtokenGET [base]/Composition?_id=[id],
    GET [base]/Composition/[id]
    必須(SHALL)patientreferenceGET [base]/Composition?patient=[patient],
    實作請參考Composition-Notes
    必須(SHALL)entryreferenceGET [base]/Composition?entry=[encounter],
    實作請參考Composition-Notes

Claim

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 理賠申請書(Claim iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate

Patient

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 病人資料(Patient iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate
  • 查詢參數摘要
  • 符合性(Conformance)參數類型範例
    必須(SHALL)identifiertokenGET [base]/Patient?identifier=[identifier],
    實作請參考Composition-Notes

Organization

Coverage

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 保險(Coverage iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate

Condition

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 病情、問題或診斷(Condition iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate

DiagnosticReport

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 診斷報告(DiagnosticReport iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate

Observation

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 檢驗檢查(Observation iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate

Practitioner

Encounter

  • 預期的符合性(Conformance Expectation): 必須(SHALL)
  • Profiles: 就醫事件(Encounter iClaim)
  • 支援的參照政策(Reference policy)resolves,Client會嘗試將邏輯參照(logical reference)解析為文字參照,意即轉換Reference.identifier為Reference.reference(但如果解析失敗,Client仍然會接收這個resource,請參閱 logical)。
  • Profile
    • 必須(SHALL)支援 createupdate
  • 查詢參數摘要
  • 符合性(Conformance)參數類型範例
    必須(SHALL)identifiertokenGET [base]/Encounter?identifier=[identifier],
    實作請參考Composition-Notes