Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
{
"resourceType" : "Bundle",
"id" : "ExampleBundleHealthCredential",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-health-credential-bundle"
]
},
"language" : "vi",
"identifier" : {
"system" : "http://fhir.hl7.org.vn/core/sid/health-credential",
"value" : "HCRED-079200000123-20260602"
},
"type" : "collection",
"timestamp" : "2026-06-02T09: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ế/001085012345</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 (20/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" : "001085012345"
},
{
"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"
},
{
"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/Observation/ExampleObservationHealthClassification",
"resource" : {
"resourceType" : "Observation",
"id" : "ExampleObservationHealthClassification",
"meta" : {
"profile" : [
🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-health-classification"
]
},
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><a name=\"Observation_ExampleObservationHealthClassification\"> </a><p class=\"res-header-id\"><b>Generated Narrative: Observation ExampleObservationHealthClassification</b></p><a name=\"ExampleObservationHealthClassification\"> </a><a name=\"hcExampleObservationHealthClassification\"> </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-observation-health-classification.html\">Phân loại sức khỏe VN Core — VN Core Observation Health Classification Profile</a></p></div><p><b>status</b>: Final</p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/observation-category exam}\">Exam</span></p><p><b>code</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-observation-code-cs PHAN_LOAI_SK}\">Phân loại sức khỏe (PHAN_LOAI_SK)</span></p><p><b>subject</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)</a></p><p><b>effective</b>: 2026-06-01</p><p><b>performer</b>: <a href=\"Practitioner-ExamplePractitionerBSCKII.html\">Practitioner Nguyễn Thị Lan</a></p><p><b>value</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-classification-cs 2}\">Loại II — Khoẻ</span></p></div>"
},
"status" : "final",
"category" : [
{
"coding" : [
{
"system" : "http://terminology.hl7.org/CodeSystem/observation-category",
"code" : "exam",
"display" : "Exam"
}
]
}
],
"code" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-observation-code-cs",
"code" : "PHAN_LOAI_SK",
"display" : "Phân loại sức khỏe"
}
],
"text" : "Phân loại sức khỏe (PHAN_LOAI_SK)"
},
"subject" : {
🔗 "reference" : "Patient/ExamplePatientNguyenVanAn"
},
"effectiveDateTime" : "2026-06-01",
"performer" : [
{
🔗 "reference" : "Practitioner/ExamplePractitionerBSCKII"
}
],
"valueCodeableConcept" : {
"coding" : [
{
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-classification-cs",
"code" : "2",
"display" : "Loại II — Khoẻ"
}
]
}
}
}
]
}