HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Ví dụ (Edge Case): Thẻ BHYT hết hạn — đối tượng hộ nghèo

Bản thô ttl | Tải xuống


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/Coverage/ExampleCoverageBHYTExpired> a fhir:Coverage ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "ExampleCoverageBHYTExpired"] ;
  fhir:Resource.meta [
     fhir:Meta.profile [
       fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage" ;
       fhir:index -1 ;
       fhir:link <http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage>
     ]
  ] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "extensions" ] ;
     fhir:Narrative.div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Coverage ExampleCoverageBHYTExpired</b></p><a name=\"ExampleCoverageBHYTExpired\"> </a><a name=\"hcExampleCoverageBHYTExpired\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-vn-core-coverage.html\">Thẻ BHYT VN Core — VN Core Coverage Profile</a></p></div><p><b>Loại đối tượng BHYT — Vietnam BHYT Card Type Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-card-type-cs HN}\">Người thuộc hộ gia đình nghèo</span></p><p><b>Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension</b>: Trạm Y tế xã Tân Phú (Identifier: <a href=\"NamingSystem-vn-ma-cskcb-ns.html\" title=\"Hệ thống mã cơ sở khám chữa bệnh (5 chữ số), do BHXH Việt Nam cấp.#xA;Dùng để định danh các cơ sở y tế trong hệ thống thanh toán BHYT.#xA;Căn cứ: Luật KCB 2023 (15/2023/QH15), BHXH Việt Nam.\">VNCSKCB</a>/79088)</p><p><b>identifier</b>: <a href=\"NamingSystem-vn-bhyt-ns.html\" title=\"Hệ thống định danh MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp.#xA;Namespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):#xA;- Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH#xA;- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)#xA;CCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột#xA;'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHÓA TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,#xA;biểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ#xA;matching sai giữa hai trục định danh.#xA;QUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace#xA;tồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;#xA;sổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều#xA;khi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP).#xA;Căn cứ:#xA;- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025#xA;- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; Mẫu số 3 tách cột Mã số BHYT / Số CCCD#xA;- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD#xA;- **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH#xA;- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.\">VNBHYT</a>/9188045678</p><p><b>status</b>: Cancelled</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/insurance-coverage-type medical}\">Bảo hiểm y tế (HẾT HẠN)</span></p><p><b>beneficiary</b>: Lê Văn Tùng</p><p><b>period</b>: 2025-01-01 --&gt; 2026-01-31</p><p><b>payor</b>: Bảo hiểm Xã hội Việt Nam</p></div>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type" ] ;
     fhir:Extension.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-card-type-cs" ] ;
         fhir:Coding.code [ fhir:value "HN" ] ;
         fhir:Coding.display [ fhir:value "Người thuộc hộ gia đình nghèo" ]
       ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility" ] ;
     fhir:Extension.valueReference [
       fhir:Reference.identifier [
         fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/ma-cskcb" ] ;
         fhir:Identifier.value [ fhir:value "79088" ]
       ] ;
       fhir:Reference.display [ fhir:value "Trạm Y tế xã Tân Phú" ]
     ]
  ] ;
  fhir:Coverage.identifier [
     fhir:index -1 ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/bhyt" ] ;
     fhir:Identifier.value [ fhir:value "9188045678" ]
  ] ;
  fhir:Coverage.status [ fhir:value "cancelled"] ;
  fhir:Coverage.type [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/insurance-coverage-type" ] ;
       fhir:Coding.code [ fhir:value "medical" ] ;
       fhir:Coding.display [ fhir:value "Medical" ]
     ] ;
     fhir:CodeableConcept.text [ fhir:value "Bảo hiểm y tế (HẾT HẠN)" ]
  ] ;
  fhir:Coverage.beneficiary [
     fhir:Reference.display [ fhir:value "Lê Văn Tùng" ]
  ] ;
  fhir:Coverage.period [
     fhir:Period.start [ fhir:value "2025-01-01"^^xsd:date ] ;
     fhir:Period.end [ fhir:value "2026-01-31"^^xsd:date ]
  ] ;
  fhir:Coverage.payor [
     fhir:index -1 ;
     fhir:Reference.display [ fhir:value "Bảo hiểm Xã hội Việt Nam" ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/Coverage/ExampleCoverageBHYTExpired.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/Coverage/ExampleCoverageBHYTExpired.ttl> .