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ụ: Bundle chứng nhận sức khỏe (payload SHC/SHL)

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/Bundle/ExampleBundleHealthCredential> a fhir:Bundle ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "ExampleBundleHealthCredential"] ;
  fhir:Resource.meta [
     fhir:Meta.profile [
       fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-health-credential-bundle" ;
       fhir:index -1 ;
       fhir:link <http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-health-credential-bundle>
     ]
  ] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:Bundle.identifier [
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/health-credential" ] ;
     fhir:Identifier.value [ fhir:value "HCRED-079200000123-20260602" ]
  ] ;
  fhir:Bundle.type [ fhir:value "collection"] ;
  fhir:Bundle.timestamp [ fhir:value "2026-06-02T09:00:00+07:00"^^xsd:dateTime] ;
  fhir:Bundle.entry [
     fhir:index -1 ;
     fhir:Bundle.entry.fullUrl [ fhir:value "http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn" ] ;
     fhir:Bundle.entry.resource <http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn>
  ], [
     fhir:index -1 ;
     fhir:Bundle.entry.fullUrl [ fhir:value "http://fhir.hl7.org.vn/core/Observation/ExampleObservationHealthClassification" ] ;
     fhir:Bundle.entry.resource <http://fhir.hl7.org.vn/core/Observation/ExampleObservationHealthClassification>
  ] .

<http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn> a fhir:Patient ;
  fhir:Resource.id [ fhir:value "ExamplePatientNguyenVanAn"] ;
  fhir:Resource.meta [
     fhir:Meta.profile [
       fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient" ;
       fhir:index -1 ;
       fhir:link <http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient>
     ]
  ] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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#xA;(Tổng cục Thống kê). FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam.#xA;Că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).#xA;Căn cứ: QĐ 34/2020/QĐ-TTg (26/11/2020) — Ban hành Danh mục nghề nghiệp Việt Nam.#xA;1.516 mã, 5 cấp phân loại, tương thích ISCO-08 (ILO).#xA;FHIR base Patient không có element nghề nghiệp chuẩn — cần extension.#xA;Nghề 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>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity" ] ;
     fhir:Extension.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-ethnicity-cs" ] ;
         fhir:Coding.code [ fhir:value "01" ] ;
         fhir:Coding.display [ fhir:value "Kinh" ]
       ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/patient-religion" ] ;
     fhir:Extension.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-religion-cs" ] ;
         fhir:Coding.code [ fhir:value "02" ] ;
         fhir:Coding.display [ fhir:value "Công giáo" ]
       ], [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/v3-ReligiousAffiliation" ] ;
         fhir:Coding.code [ fhir:value "1041" ] ;
         fhir:Coding.display [ fhir:value "Roman Catholic Church" ]
       ] ;
       fhir:CodeableConcept.text [ fhir:value "Công giáo" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation" ] ;
     fhir:Extension.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-occupation-cs" ] ;
         fhir:Coding.code [ fhir:value "2511" ] ;
         fhir:Coding.display [ fhir:value "Nhà phân tích hệ thống" ]
       ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "code" ] ;
       fhir:Extension.valueCodeableConcept [
         fhir:CodeableConcept.coding [
           fhir:index -1 ;
           fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
           fhir:Coding.code [ fhir:value "VN" ] ;
           fhir:Coding.display [ fhir:value "Viet Nam" ]
         ]
       ]
     ] ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/patient-citizenship" ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/patient-birthPlace" ] ;
     fhir:Extension.valueAddress [
       fhir:Element.extension [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province" ] ;
         fhir:Extension.valueCoding [
           fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs" ] ;
           fhir:Coding.code [ fhir:value "01" ] ;
           fhir:Coding.display [ fhir:value "Thành phố Hà Nội" ]
         ]
       ], [
         fhir:index -1 ;
         fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward" ] ;
         fhir:Extension.valueCoding [
           fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs" ] ;
           fhir:Coding.code [ fhir:value "00008" ] ;
           fhir:Coding.display [ fhir:value "Phường Ngọc Hà" ]
         ]
       ] ;
       fhir:Address.text [ fhir:value "Phường Ngọc Hà, Hà Nội" ] ;
       fhir:Address.state [ fhir:value "Hà Nội" ] ;
       fhir:Address.country [ fhir:value "VN" ]
     ]
  ] ;
  fhir:Patient.identifier [
     fhir:index -1 ;
     fhir:Identifier.type [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs" ] ;
         fhir:Coding.code [ fhir:value "CCCD" ] ;
         fhir:Coding.display [ fhir:value "Căn cước công dân" ]
       ]
     ] ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/cccd" ] ;
     fhir:Identifier.value [ fhir:value "001085012345" ]
  ], [
     fhir:index -1 ;
     fhir:Identifier.type [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs" ] ;
         fhir:Coding.code [ fhir:value "BHYT" ] ;
         fhir:Coding.display [ fhir:value "Thẻ bảo hiểm y tế" ]
       ]
     ] ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/bhyt" ] ;
     fhir:Identifier.value [ fhir:value "0791234567" ]
  ], [
     fhir:index -1 ;
     fhir:Identifier.type [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs" ] ;
         fhir:Coding.code [ fhir:value "MRN" ] ;
         fhir:Coding.display [ fhir:value "Mã bệnh nhân nội bộ" ]
       ]
     ] ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/mrn" ] ;
     fhir:Identifier.value [ fhir:value "BV-CR-2026-001234" ] ;
     fhir:Identifier.assigner [
       fhir:Reference.display [ fhir:value "Bệnh viện Chợ Rẫy — cơ sở cấp mã bệnh nhân" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Identifier.type [
       fhir:CodeableConcept.coding [
         fhir:index -1 ;
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs" ] ;
         fhir:Coding.code [ fhir:value "BHXH" ] ;
         fhir:Coding.display [ fhir:value "Mã số bảo hiểm xã hội" ]
       ]
     ] ;
     fhir:Identifier.system [ fhir:value "http://fhir.hl7.org.vn/core/sid/bhxh" ] ;
     fhir:Identifier.value [ fhir:value "0791234567" ]
  ] ;
  fhir:Patient.name [
     fhir:index -1 ;
     fhir:HumanName.text [ fhir:value "Nguyễn Văn An" ] ;
     fhir:HumanName.family [ fhir:value "Nguyễn" ] ;
     fhir:HumanName.given [
       fhir:value "Văn" ;
       fhir:index -1
     ], [
       fhir:value "An" ;
       fhir:index -1
     ]
  ] ;
  fhir:Patient.telecom [
     fhir:index -1 ;
     fhir:ContactPoint.system [ fhir:value "phone" ] ;
     fhir:ContactPoint.value [ fhir:value "0901234567" ] ;
     fhir:ContactPoint.use [ fhir:value "mobile" ]
  ], [
     fhir:index -1 ;
     fhir:ContactPoint.system [ fhir:value "email" ] ;
     fhir:ContactPoint.value [ fhir:value "an.nguyen@email.vn" ]
  ] ;
  fhir:Patient.gender [ fhir:value "male"] ;
  fhir:Patient.birthDate [ fhir:value "1985-03-15"^^xsd:date] ;
  fhir:Patient.address [
     fhir:index -1 ;
     fhir:Element.extension [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province" ] ;
       fhir:Extension.valueCoding [
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs" ] ;
         fhir:Coding.code [ fhir:value "79" ] ;
         fhir:Coding.display [ fhir:value "Thành phố Hồ Chí Minh" ]
       ]
     ], [
       fhir:index -1 ;
       fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward" ] ;
       fhir:Extension.valueCoding [
         fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs" ] ;
         fhir:Coding.code [ fhir:value "26743" ] ;
         fhir:Coding.display [ fhir:value "Phường Bến Thành" ]
       ]
     ] ;
     fhir:Address.text [ fhir:value "Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh" ] ;
     fhir:Address.line [
       fhir:value "Số 123 Nguyễn Huệ" ;
       fhir:index -1
     ] ;
     fhir:Address.state [ fhir:value "Thành phố Hồ Chí Minh" ] ;
     fhir:Address.country [ fhir:value "VN" ]
  ] .

<http://fhir.hl7.org.vn/core/Observation/ExampleObservationHealthClassification> a fhir:Observation ;
  fhir:Resource.id [ fhir:value "ExampleObservationHealthClassification"] ;
  fhir:Resource.meta [
     fhir:Meta.profile [
       fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-health-classification" ;
       fhir:index -1 ;
       fhir:link <http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-health-classification>
     ]
  ] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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>"
  ] ;
  fhir:Observation.status [ fhir:value "final"] ;
  fhir:Observation.category [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/observation-category" ] ;
       fhir:Coding.code [ fhir:value "exam" ] ;
       fhir:Coding.display [ fhir:value "Exam" ]
     ]
  ] ;
  fhir:Observation.code [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-observation-code-cs" ] ;
       fhir:Coding.code [ fhir:value "PHAN_LOAI_SK" ] ;
       fhir:Coding.display [ fhir:value "Phân loại sức khỏe" ]
     ] ;
     fhir:CodeableConcept.text [ fhir:value "Phân loại sức khỏe (PHAN_LOAI_SK)" ]
  ] ;
  fhir:Observation.subject [
     fhir:link <http://hl7.org/fhir/Patient/ExamplePatientNguyenVanAn> ;
     fhir:Reference.reference [ fhir:value "Patient/ExamplePatientNguyenVanAn" ]
  ] ;
  fhir:Observation.effectiveDateTime [ fhir:value "2026-06-01"^^xsd:date] ;
  fhir:Observation.performer [
     fhir:index -1 ;
     fhir:link <http://hl7.org/fhir/Practitioner/ExamplePractitionerBSCKII> ;
     fhir:Reference.reference [ fhir:value "Practitioner/ExamplePractitionerBSCKII" ]
  ] ;
  fhir:Observation.valueCodeableConcept [
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-classification-cs" ] ;
       fhir:Coding.code [ fhir:value "2" ] ;
       fhir:Coding.display [ fhir:value "Loại II — Khoẻ" ]
     ]
  ] .

<http://hl7.org/fhir/Patient/ExamplePatientNguyenVanAn> a fhir:Patient .

<http://hl7.org/fhir/Practitioner/ExamplePractitionerBSCKII> a fhir:Practitioner .

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

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