Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review
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
{
"resourceType" : "Bundle",
"id" : "ExampleBHYTSubmissionHIV",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"
]
},
"language" : "vi",
"identifier" : {
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "MA_LK",
"display" : "Mã liên kết hồ sơ BHYT"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/ma-lk",
"value" : "LK-2026-HIV-000021"
},
"type" : "collection",
"timestamp" : "2026-04-18T10:00:00+07:00",
"entry" : [
{
"fullUrl" : "http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn",
"resource" : {
"resourceType" : "Patient",
"id" : "ExamplePatientNguyenVanAn",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"
]
},
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Patient_ExamplePatientNguyenVanAn\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Patient ExamplePatientNguyenVanAn</b></p><a name=\"ExamplePatientNguyenVanAn\"> </a><a name=\"hcExamplePatientNguyenVanAn\"> </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-patient.html\">Bệnh nhân VN Core — VN Core Patient Profile</a></p></div><p style=\"border: 1px #661aff solid; background-color: #e6e6ff; padding: 10px;\">Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)</p><hr/><table class=\"grid\"><tr><td style=\"background-color: #f3f5da\" title=\"Other Ids (see the one above)\">Other Ids:</td><td colspan=\"3\"><ul><li>Thẻ bảo hiểm y tế/0791234567</li><li>Mã bệnh nhân nội bộ/BV-CR-2026-001234</li><li>Mã số bảo hiểm xã hội/0791234567</li></ul></td></tr><tr><td style=\"background-color: #f3f5da\" title=\"Ways to contact the Patient\">Contact Detail</td><td colspan=\"3\"><ul><li>ph: 0901234567(Mobile)</li><li><a href=\"mailto:an.nguyen@email.vn\">an.nguyen@email.vn</a></li><li>Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh</li></ul></td></tr><tr><td style=\"background-color: #f3f5da\" title=\"Mở rộng ghi nhận dân tộc của bệnh nhân theo danh mục 54 dân tộc Việt Nam\n(Tổng cục Thống kê). FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam.\nCăn cứ: Hiến pháp 2013 Điều 5, Luật Căn cước 2023.\"><a href=\"StructureDefinition-vn-ext-ethnicity.html\">Dân tộc — Vietnam Ethnicity Extension</a></td><td colspan=\"3\"><span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-ethnicity-cs 01}\">Kinh</span></td></tr><tr><td style=\"background-color: #f3f5da\" title=\"The registered place of birth of the patient. A sytem may use the address.text if they don't store the birthPlace address in discrete elements.\"><a href=\"http://hl7.org/fhir/extensions/5.3.0/StructureDefinition-patient-birthPlace.html\">Patient Birth Place</a></td><td colspan=\"3\">Phường Ngọc Hà, Hà Nội</td></tr><tr><td style=\"background-color: #f3f5da\" title=\"Mở rộng ghi nhận nghề nghiệp của bệnh nhân theo Danh mục Nghề nghiệp Việt Nam (VSCO 2020).\nCăn cứ: QĐ 34/2020/QĐ-TTg (26/11/2020) — Ban hành Danh mục nghề nghiệp Việt Nam.\n1.516 mã, 5 cấp phân loại, tương thích ISCO-08 (ILO).\nFHIR base Patient không có element nghề nghiệp chuẩn — cần extension.\nNghề nghiệp ảnh hưởng đánh giá nguy cơ sức khỏe nghề nghiệp (TT 28/2016/TT-BYT).\"><a href=\"StructureDefinition-vn-ext-occupation.html\">Nghề nghiệp — Vietnam Occupation Extension</a></td><td colspan=\"3\"><span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-occupation-cs 2511}\">Nhà phân tích hệ thống</span></td></tr><tr><td style=\"background-color: #f3f5da\" title=\"The patient's professed religious affiliations.\"><a href=\"http://hl7.org/fhir/extensions/5.3.0/StructureDefinition-patient-religion.html\">Patient Religion</a></td><td colspan=\"3\"><span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-religion-cs 02}, {http://terminology.hl7.org/CodeSystem/v3-ReligiousAffiliation 1041}\">Công giáo</span></td></tr><tr><td style=\"background-color: #f3f5da\" title=\"The patient's legal status as citizen of a country.\">Patient Citizenship:</td><td colspan=\"3\"><ul><li>code: <span title=\"Codes:{urn:iso:std:iso:3166 VN}\">Viet Nam</span></li></ul></td></tr></table></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-ethnicity-cs",
"code" : "01",
"display" : "Kinh"
}
]
}
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/patient-religion",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-religion-cs",
"code" : "02",
"display" : "Công giáo"
},
{
"system" : "http://terminology.hl7.org/CodeSystem/v3-ReligiousAffiliation",
"code" : "1041",
"display" : "Roman Catholic Church"
}
],
"text" : "Công giáo"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-occupation-cs",
"code" : "2511",
"display" : "Nhà phân tích hệ thống"
}
]
}
},
{
"extension" : [
{
"url" : "code",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
}
],
"url" : "http://hl7.org/fhir/StructureDefinition/patient-citizenship"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/patient-birthPlace",
"valueAddress" : {
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"code" : "01",
"display" : "Thành phố Hà Nội"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs",
"code" : "00008",
"display" : "Phường Ngọc Hà"
}
}
],
"text" : "Phường Ngọc Hà, Hà Nội",
"state" : "Hà Nội",
"country" : "VN"
}
}
],
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "CCCD",
"display" : "Căn cước công dân"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/cccd",
"value" : "001085012345"
},
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "BHYT",
"display" : "Thẻ bảo hiểm y tế"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/bhyt",
"value" : "0791234567"
},
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "MRN",
"display" : "Mã bệnh nhân nội bộ"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/mrn",
"value" : "BV-CR-2026-001234",
"assigner" : {
"display" : "Bệnh viện Chợ Rẫy — cơ sở cấp mã bệnh nhân"
}
},
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "BHXH",
"display" : "Mã số bảo hiểm xã hội"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/bhxh",
"value" : "0791234567"
}
],
"name" : [
{
"text" : "Nguyễn Văn An",
"family" : "Nguyễn",
"given" : [
"Văn",
"An"
]
}
],
"telecom" : [
{
"system" : "phone",
"value" : "0901234567",
"use" : "mobile"
},
{
"system" : "email",
"value" : "an.nguyen@email.vn"
}
],
"gender" : "male",
"birthDate" : "1985-03-15",
"address" : [
{
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"code" : "79",
"display" : "Thành phố Hồ Chí Minh"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs",
"code" : "26743",
"display" : "Phường Bến Thành"
}
}
],
"text" : "Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh",
"line" : [
"Số 123 Nguyễn Huệ"
],
"state" : "Thành phố Hồ Chí Minh",
"country" : "VN"
}
]
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTNew",
"resource" : {
"resourceType" : "Coverage",
"id" : "ExampleCoverageBHYTNew",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"
]
},
"language" : "vi",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Coverage_ExampleCoverageBHYTNew\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Coverage ExampleCoverageBHYTNew</b></p><a name=\"ExampleCoverageBHYTNew\"> </a><a name=\"hcExampleCoverageBHYTNew\"> </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 DN}\">Người lao động trong doanh nghiệp</span></p><p><b>Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></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.\nNamespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):\n- Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH\n- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)\nCCCD/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\n'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHÓA TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,\nbiểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ\nmatching sai giữa hai trục định danh.\nQUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace\ntồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;\nsổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều\nkhi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP).\nCăn cứ:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **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\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD\n- **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH\n- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.\">VNBHYT</a>/0791234567</p><p><b>status</b>: Active</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/insurance-coverage-type medical}\">Bảo hiểm y tế</span></p><p><b>subscriber</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>beneficiary</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>relationship</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/subscriber-relationship self}\">Self</span></p><p><b>period</b>: 2025-08-01 --> 2026-07-31</p><p><b>payor</b>: Bảo hiểm Xã hội Việt Nam</p></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-card-type-cs",
"code" : "DN",
"display" : "Người lao động trong doanh nghiệp"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility",
"valueReference" : {
🔗 "reference" : "Organization/ExampleOrganizationChoRay",
"identifier" : {
"system" : "http://fhir.hl7.org.vn/core/sid/ma-cskcb",
"value" : "79001"
},
"display" : "Bệnh viện Chợ Rẫy"
}
}
],
"identifier" : [
{
"system" : "http://fhir.hl7.org.vn/core/sid/bhyt",
"value" : "0791234567"
}
],
"status" : "active",
"type" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/insurance-coverage-type",
"code" : "medical",
"display" : "Medical"
}
],
"text" : "Bảo hiểm y tế"
},
"subscriber" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
"display" : "Nguyễn Văn An"
},
"beneficiary" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
"display" : "Nguyễn Văn An"
},
"relationship" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
"code" : "self",
"display" : "Self"
}
]
},
"period" : {
"start" : "2025-08-01",
"end" : "2026-07-31"
},
"payor" : [
{
"display" : "Bảo hiểm Xã hội Việt Nam"
}
]
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay",
"resource" : {
"resourceType" : "Organization",
"id" : "ExampleOrganizationChoRay",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"
]
},
"language" : "vi",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Organization_ExampleOrganizationChoRay\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Organization ExampleOrganizationChoRay</b></p><a name=\"ExampleOrganizationChoRay\"> </a><a name=\"hcExampleOrganizationChoRay\"> </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-organization.html\">Cơ sở y tế VN Core — VN Core Organization Profile</a></p></div><p><b>Loại hình cơ sở y tế — Vietnam Organization Type Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-type-cs BV}\">Bệnh viện</span></p><p><b>Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-healthcare-level-cs TW}\">Trung ương</span></p><p><b>Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-hospital-rank-cs DB}\">Đặc biệt</span></p><p><b>Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-rank-status-cs RANKED}\">Đã xếp hạng</span></p><p><b>Cấp năng lực cơ sở KCB — Facility Care Level Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-facility-care-level-cs CHUYEN_SAU}\">Cấp chuyên sâu</span></p><p><b>Dải điểm chất lượng cơ sở KCB — Quality Score Band Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-quality-score-band-cs GT70}\">Trên 70 điểm</span></p><p><b>identifier</b>: Mã cơ sở khám chữa bệnh/79001</p><p><b>active</b>: true</p><p><b>name</b>: Bệnh viện Chợ Rẫy</p><p><b>telecom</b>: ph: 028 3855 4137</p><p><b>address</b>: 201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh</p></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-type-cs",
"code" : "BV",
"display" : "Bệnh viện"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-healthcare-level-cs",
"code" : "TW",
"display" : "Trung ương"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-hospital-rank-cs",
"code" : "DB",
"display" : "Đặc biệt"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-rank-status-cs",
"code" : "RANKED",
"display" : "Đã xếp hạng"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-facility-care-level-cs",
"code" : "CHUYEN_SAU",
"display" : "Cấp chuyên sâu"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-quality-score-band-cs",
"code" : "GT70",
"display" : "Trên 70 điểm"
}
]
}
}
],
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "CSKCB",
"display" : "Mã cơ sở khám chữa bệnh"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/ma-cskcb",
"value" : "79001"
}
],
"active" : true,
"name" : "Bệnh viện Chợ Rẫy",
"telecom" : [
{
"system" : "phone",
"value" : "028 3855 4137"
}
],
"address" : [
{
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"code" : "79",
"display" : "Thành phố Hồ Chí Minh"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs",
"code" : "27343",
"display" : "Phường Chợ Lớn"
}
}
],
"text" : "201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh",
"line" : [
"201B Nguyễn Chí Thanh"
],
"district" : "Quận 5",
"state" : "Thành phố Hồ Chí Minh",
"country" : "VN"
}
]
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationBHXH",
"resource" : {
"resourceType" : "Organization",
"id" : "ExampleOrganizationBHXH",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"
]
},
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Organization_ExampleOrganizationBHXH\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Organization ExampleOrganizationBHXH</b></p><a name=\"ExampleOrganizationBHXH\"> </a><a name=\"hcExampleOrganizationBHXH\"> </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-organization.html\">Cơ sở y tế VN Core — VN Core Organization Profile</a></p></div><p><b>identifier</b>: Mã cơ quan BHXH Việt Nam (mã quy ước)/00000</p><p><b>active</b>: true</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/organization-type ins}\">Cơ quan bảo hiểm xã hội</span></p><p><b>name</b>: Bảo hiểm xã hội Việt Nam</p><p><b>address</b>: Số 7 Tràng Thi, Hoàn Kiếm, Hà Nội</p></div>"
},
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "CSKCB",
"display" : "Mã cơ sở khám chữa bệnh"
}
],
"text" : "Mã cơ quan BHXH Việt Nam (mã quy ước)"
},
"system" : "http://fhir.hl7.org.vn/core/sid/ma-cskcb",
"value" : "00000"
}
],
"active" : true,
"type" : [
{
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/organization-type",
"code" : "ins",
"display" : "Insurance Company"
}
],
"text" : "Cơ quan bảo hiểm xã hội"
}
],
"name" : "Bảo hiểm xã hội Việt Nam",
"address" : [
{
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"code" : "01",
"display" : "Thành phố Hà Nội"
}
}
],
"text" : "Số 7 Tràng Thi, Hoàn Kiếm, Hà Nội",
"state" : "Thành phố Hà Nội",
"country" : "VN"
}
]
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/Claim/InlineClaimBHYTSubmissionHIV",
"resource" : {
"resourceType" : "Claim",
"id" : "InlineClaimBHYTSubmissionHIV",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"
]
},
"language" : "vi",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Claim_InlineClaimBHYTSubmissionHIV\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Claim InlineClaimBHYTSubmissionHIV</b></p><a name=\"InlineClaimBHYTSubmissionHIV\"> </a><a name=\"hcInlineClaimBHYTSubmissionHIV\"> </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-claim.html\">Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile</a></p></div><p><b>identifier</b>: Mã liên kết hồ sơ BHYT/LK-2026-HIV-000021</p><p><b>status</b>: Active</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/claim-type professional}\">Professional</span></p><p><b>subType</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs 1.4}\">KCB khi thay đổi nơi lưu trú, nơi cư trú</span></p><p><b>use</b>: Claim</p><p><b>patient</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>created</b>: 2026-04-18</p><p><b>provider</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>priority</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/processpriority normal}\">Normal</span></p><h3>Diagnoses</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Diagnosis[x]</b></td><td><b>Type</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td><span title=\"Codes:{http://hl7.org/fhir/sid/icd-10 B20}\">Human immunodeficiency virus [HIV] disease resulting in infectious and parasitic diseases</span></td><td><span title=\"Codes:{http://terminology.hl7.org/CodeSystem/ex-diagnosistype principal}\">Principal Diagnosis</span></td></tr></table><h3>Insurances</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td>true</td><td><a href=\"Coverage-ExampleCoverageBHYTNew.html\">Coverage: extension = Người lao động trong doanh nghiệp,->Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#0791234567; status = active; type = Medical; relationship = Self; period = 2025-08-01 --> 2026-07-31</a></td></tr></table><blockquote><p><b>item</b></p><p><b>Nguồn chi trả — Payment Source Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs 1}\">Bảo hiểm y tế</span></p><p><b>Thông tin thầu — Tender Information Extension</b>: 57/QĐ-TTMS;G1;N1;2022;G2.02</p><p><b>sequence</b>: 1</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 8}\">Thuốc, dịch truyền</span></p><p><b>productOrService</b>: <span title=\"Codes:{http://www.whocc.no/atc J05AR27}\">Thuốc ARV phối hợp TDF/3TC/DTG</span></p><p><b>quantity</b>: 30</p><h3>UnitPrices</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>12000</td><td>Vietnamese đồng</td></tr></table><h3>Nets</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>360000</td><td>Vietnamese đồng</td></tr></table></blockquote><h3>Totals</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>360000</td><td>Vietnamese đồng</td></tr></table></div>"
},
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
"code" : "MA_LK",
"display" : "Mã liên kết hồ sơ BHYT"
}
]
},
"system" : "http://fhir.hl7.org.vn/core/sid/ma-lk",
"value" : "LK-2026-HIV-000021"
}
],
"status" : "active",
"type" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/claim-type",
"code" : "professional",
"display" : "Professional"
}
]
},
"subType" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs",
"code" : "1.4"
}
]
},
"use" : "claim",
"patient" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
"display" : "Nguyễn Văn An"
},
"created" : "2026-04-18",
"provider" : {
🔗 "reference" : "Organization/ExampleOrganizationChoRay",
"display" : "Bệnh viện Chợ Rẫy"
},
"priority" : {
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/processpriority",
"code" : "normal",
"display" : "Normal"
}
]
},
"diagnosis" : [
{
"sequence" : 1,
"diagnosisCodeableConcept" : {
"coding" : [
{
"system" : "http://hl7.org/fhir/sid/icd-10",
"code" : "B20"
}
]
},
"type" : [
{
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/ex-diagnosistype",
"code" : "principal",
"display" : "Principal Diagnosis"
}
]
}
]
}
],
"insurance" : [
{
"sequence" : 1,
"focal" : true,
"coverage" : {
🔗 "reference" : "Coverage/ExampleCoverageBHYTNew"
}
}
],
"item" : [
{
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs",
"code" : "1",
"display" : "Bảo hiểm y tế"
}
]
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info",
"valueString" : "57/QĐ-TTMS;G1;N1;2022;G2.02"
}
],
"sequence" : 1,
"category" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
"code" : "8"
}
]
},
"productOrService" : {
"coding" : [
{
"system" : "http://www.whocc.no/atc",
"code" : "J05AR27",
"display" : "Lamivudine, tenofovir disoproxil and dolutegravir"
}
],
"text" : "Thuốc ARV phối hợp TDF/3TC/DTG"
},
"quantity" : {
"value" : 30
},
"unitPrice" : {
"value" : 12000,
"currency" : "VND"
},
"net" : {
"value" : 360000,
"currency" : "VND"
}
}
],
"total" : {
"value" : 360000,
"currency" : "VND"
}
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedicationRequestBHYTSubmissionHIV",
"resource" : {
"resourceType" : "MedicationRequest",
"id" : "InlineMedicationRequestBHYTSubmissionHIV",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request"
]
},
"language" : "vi",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"MedicationRequest_InlineMedicationRequestBHYTSubmissionHIV\"> </a><p class=\"res-header-id\"><b>Generated Narrative: MedicationRequest InlineMedicationRequestBHYTSubmissionHIV</b></p><a name=\"InlineMedicationRequestBHYTSubmissionHIV\"> </a><a name=\"hcInlineMedicationRequestBHYTSubmissionHIV\"> </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-medication-request.html\">Đơn thuốc VN Core — VN Core MedicationRequest Profile</a></p></div><p><b>Số đăng ký thuốc (Visa) — Medication Registration Number</b>: ARV-TLD-2026-021</p><p><b>Ngày y lệnh — Order Date Extension</b>: 2026-04-18 09:30:00+0700</p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 80</li></ul></blockquote><p><b>Nguồn chi trả — Payment Source Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs 1}\">Bảo hiểm y tế</span></p><p><b>status</b>: Active</p><p><b>intent</b>: Order</p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/medicationrequest-category outpatient}\">Outpatient</span></p><p><b>medication</b>: <span title=\"Codes:{http://www.whocc.no/atc J05AR27}\">TDF/3TC/DTG 300mg/300mg/50mg viên nén</span></p><p><b>subject</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>authoredOn</b>: 2026-04-18 09:30:00+0700</p><p><b>requester</b>: <a href=\"Practitioner-ExamplePractitionerBSCKII.html\">BS CKII Nguyễn Thị Lan</a></p><p><b>reasonCode</b>: <span title=\"Codes:{http://hl7.org/fhir/sid/icd-10 B20}\">Điều trị ARV phác đồ TDF/3TC/DTG</span></p><h3>DosageInstructions</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Text</b></td><td><b>Timing</b></td><td><b>Route</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td>Uống 1 viên mỗi ngày, tái khám và lĩnh thuốc định kỳ hàng tháng</td><td>Once per 1 day</td><td><span title=\"Codes:{http://snomed.info/sct 26643006}\">Uống</span></td></tr></table><blockquote><p><b>dispenseRequest</b></p><p><b>quantity</b>: 30 viên</p><h3>ExpectedSupplyDurations</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Unit</b></td><td><b>System</b></td><td><b>Code</b></td></tr><tr><td style=\"display: none\">*</td><td>30</td><td>ngày</td><td><a href=\"http://hl7.org/fhir/uv/xver-r5.r4/0.1.0/CodeSystem-v3-ucum.html\">http://unitsofmeasure.org</a></td><td>d</td></tr></table></blockquote></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number",
"valueString" : "ARV-TLD-2026-021"
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date",
"valueDateTime" : "2026-04-18T09:30:00+07:00"
},
{
"extension" : [
{
"url" : "scope",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs",
"code" : "1",
"display" : "Trong phạm vi hưởng BHYT"
}
]
}
},
{
"url" : "paymentRatio",
"valueDecimal" : 100
},
{
"url" : "benefitLevel",
"valueDecimal" : 80
}
],
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source",
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs",
"code" : "1",
"display" : "Bảo hiểm y tế"
}
]
}
}
],
"status" : "active",
"intent" : "order",
"category" : [
{
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code" : "outpatient",
"display" : "Outpatient"
}
]
}
],
"medicationCodeableConcept" : {
"coding" : [
{
"system" : "http://www.whocc.no/atc",
"code" : "J05AR27",
"display" : "Lamivudine, tenofovir disoproxil and dolutegravir"
}
],
"text" : "TDF/3TC/DTG 300mg/300mg/50mg viên nén"
},
"subject" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
"display" : "Nguyễn Văn An"
},
"authoredOn" : "2026-04-18T09:30:00+07:00",
"requester" : {
🔗 "reference" : "Practitioner/ExamplePractitionerBSCKII",
"display" : "BS CKII Nguyễn Thị Lan"
},
"reasonCode" : [
{
"coding" : [
{
"system" : "http://hl7.org/fhir/sid/icd-10",
"code" : "B20",
"display" : "Human immunodeficiency virus [HIV] disease resulting in infectious and parasitic diseases"
}
],
"text" : "Điều trị ARV phác đồ TDF/3TC/DTG"
}
],
"dosageInstruction" : [
{
"sequence" : 1,
"text" : "Uống 1 viên mỗi ngày, tái khám và lĩnh thuốc định kỳ hàng tháng",
"timing" : {
"repeat" : {
"frequency" : 1,
"period" : 1,
"periodUnit" : "d"
}
},
"route" : {
"coding" : [
{
"system" : "http://snomed.info/sct",
"code" : "26643006",
"display" : "Oral route"
}
],
"text" : "Uống"
}
}
],
"dispenseRequest" : {
"quantity" : {
"value" : 30,
"unit" : "viên"
},
"expectedSupplyDuration" : {
"value" : 30,
"unit" : "ngày",
"system" : "http://unitsofmeasure.org",
"code" : "d"
}
}
}
},
{
"fullUrl" : "http://fhir.hl7.org.vn/core/DocumentReference/InlineDocumentReferenceBHYTSubmissionHIV",
"resource" : {
"resourceType" : "DocumentReference",
"id" : "InlineDocumentReferenceBHYTSubmissionHIV",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference"
]
},
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"DocumentReference_InlineDocumentReferenceBHYTSubmissionHIV\"> </a><p class=\"res-header-id\"><b>Generated Narrative: DocumentReference InlineDocumentReferenceBHYTSubmissionHIV</b></p><a name=\"InlineDocumentReferenceBHYTSubmissionHIV\"> </a><a name=\"hcInlineDocumentReferenceBHYTSubmissionHIV\"> </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-document-reference.html\">Tài liệu y tế VN Core — VN Core DocumentReference Profile</a></p></div><p><b>identifier</b>: <a href=\"NamingSystem-vn-document-number-ns.html\" title=\"SCHEME DÙNG TẠM per-facility — 0.8.0 hạ cấp (hậu kiểm toán Codex): định danh này do TỪNG cơ sở\ntự quản lý nên khóa uniqueness là system+value; một URI quốc gia dùng chung KHÔNG bảo đảm uniqueness.\nKhuyến nghị chính: mỗi cơ sở tự công bố URI riêng; URI scheme này chỉ dùng khi chưa có URI riêng,\nkhi đó assigner là bắt buộc nghiệp vụ (khuyến nghị bổ sung, không phải cơ chế uniqueness chính).\nNamespace khuyến nghị cho mã tài liệu lâm sàng nội bộ do cơ sở y tế phát sinh, dùng cho Composition.identifier và DocumentReference.identifier khi chưa có NamingSystem riêng của từng cơ sở.\">VNDocumentNumber</a>/HIV-2026-000021</p><p><b>status</b>: Current</p><p><b>type</b>: <span title=\"Codes:\">Hồ sơ điều trị HIV/AIDS</span></p><p><b>subject</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>date</b>: 2026-04-18 09:30:00+0700</p><p><b>author</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>custodian</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>description</b>: Phác đồ điều trị HIV/AIDS: TDF/3TC/DTG, theo dõi ngoại trú định kỳ hàng tháng.</p><blockquote><p><b>content</b></p><h3>Attachments</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>ContentType</b></td><td><b>Language</b></td><td><b>Title</b></td><td><b>Creation</b></td></tr><tr><td style=\"display: none\">*</td><td>application/pdf</td><td>Vietnamese</td><td>HoSoDieuTriHIV-NguyenVanAn-20260418.pdf</td><td>2026-04-18 09:30:00+0700</td></tr></table></blockquote><h3>Contexts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Period</b></td></tr><tr><td style=\"display: none\">*</td><td>2026-04-18 09:30:00+0700 --> 2026-05-18 09:30:00+0700</td></tr></table></div>"
},
"identifier" : [
{
"system" : "http://fhir.hl7.org.vn/core/sid/document-number",
"value" : "HIV-2026-000021"
}
],
"status" : "current",
"type" : {
"text" : "Hồ sơ điều trị HIV/AIDS"
},
"subject" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
"display" : "Nguyễn Văn An"
},
"date" : "2026-04-18T09:30:00+07:00",
"author" : [
{
🔗 "reference" : "Organization/ExampleOrganizationChoRay",
"display" : "Bệnh viện Chợ Rẫy"
}
],
"custodian" : {
🔗 "reference" : "Organization/ExampleOrganizationChoRay",
"display" : "Bệnh viện Chợ Rẫy"
},
"description" : "Phác đồ điều trị HIV/AIDS: TDF/3TC/DTG, theo dõi ngoại trú định kỳ hàng tháng.",
"content" : [
{
"attachment" : {
"contentType" : "application/pdf",
"language" : "vi",
"title" : "HoSoDieuTriHIV-NguyenVanAn-20260418.pdf",
"creation" : "2026-04-18T09:30:00+07:00"
}
}
],
"context" : {
"period" : {
"start" : "2026-04-18T09:30:00+07:00",
"end" : "2026-05-18T09:30:00+07:00"
}
}
}
}
]
}