HL7 Vietnam VN Core FHIR Implementation Guide

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

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

: Ví dụ: Bundle chứng nhận sức khỏe (payload SHC/SHL)

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


<Bundle xmlns="http://hl7.org/fhir">
  <id value="ExampleBundleHealthCredential"/>
  <meta>
    <profile
             value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-health-credential-bundle"/>
  </meta>
  <language value="vi"/>
  <identifier>
    <system value="http://fhir.hl7.org.vn/core/sid/health-credential"/>
    <value value="HCRED-079200000123-20260602"/>
  </identifier>
  <type value="collection"/>
  <timestamp value="2026-06-02T09:00:00+07:00"/>
  <entry>
    <fullUrl
             value="http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn"/>
    <resource>
      <Patient>
        <id value="ExamplePatientNguyenVanAn"/>
        <meta>
          <profile
                   value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"/>
        </meta>
        <language value="vi"/>
        <text>
          <status value="generated"/>
          <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
(Tổng cục Thống kê). FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam.
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).
Căn cứ: QĐ 34/2020/QĐ-TTg (20/11/2020) — Ban hành Danh mục nghề nghiệp Việt Nam.
1.516 mã, 5 cấp phân loại, tương thích ISCO-08 (ILO).
FHIR base Patient không có element nghề nghiệp chuẩn — cần extension.
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>
        </text>
        <extension
                   url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity">
          <valueCodeableConcept>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-ethnicity-cs"/>
              <code value="01"/>
              <display value="Kinh"/>
            </coding>
          </valueCodeableConcept>
        </extension>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/patient-religion">
          <valueCodeableConcept>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-religion-cs"/>
              <code value="02"/>
              <display value="Công giáo"/>
            </coding>
            <coding>
              <system
                      value="http://terminology.hl7.org/CodeSystem/v3-ReligiousAffiliation"/>
              <code value="1041"/>
              <display value="Roman Catholic Church"/>
            </coding>
            <text value="Công giáo"/>
          </valueCodeableConcept>
        </extension>
        <extension
                   url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation">
          <valueCodeableConcept>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-occupation-cs"/>
              <code value="2511"/>
              <display value="Nhà phân tích hệ thống"/>
            </coding>
          </valueCodeableConcept>
        </extension>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/patient-citizenship">
          <extension url="code">
            <valueCodeableConcept>
              <coding>
                <system value="urn:iso:std:iso:3166"/>
                <code value="VN"/>
                <display value="Viet Nam"/>
              </coding>
            </valueCodeableConcept>
          </extension>
        </extension>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/patient-birthPlace">
          <valueAddress>
            <extension
                       url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province">
              <valueCoding>
                <system
                        value="http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"/>
                <code value="01"/>
                <display value="Thành phố Hà Nội"/>
              </valueCoding>
            </extension>
            <extension
                       url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward">
              <valueCoding>
                <system
                        value="http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs"/>
                <code value="00008"/>
                <display value="Phường Ngọc Hà"/>
              </valueCoding>
            </extension>
            <text value="Phường Ngọc Hà, Hà Nội"/>
            <state value="Hà Nội"/>
            <country value="VN"/>
          </valueAddress>
        </extension>
        <identifier>
          <type>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
              <code value="CCCD"/>
              <display value="Căn cước công dân"/>
            </coding>
          </type>
          <system value="http://fhir.hl7.org.vn/core/sid/cccd"/>
          <value value="001085012345"/>
        </identifier>
        <identifier>
          <type>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
              <code value="BHYT"/>
              <display value="Thẻ bảo hiểm y tế"/>
            </coding>
          </type>
          <system value="http://fhir.hl7.org.vn/core/sid/bhyt"/>
          <value value="001085012345"/>
        </identifier>
        <identifier>
          <type>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
              <code value="MRN"/>
              <display value="Mã bệnh nhân nội bộ"/>
            </coding>
          </type>
          <system value="http://fhir.hl7.org.vn/core/sid/mrn"/>
          <value value="BV-CR-2026-001234"/>
        </identifier>
        <identifier>
          <type>
            <coding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
              <code value="BHXH"/>
              <display value="Mã số bảo hiểm xã hội"/>
            </coding>
          </type>
          <system value="http://fhir.hl7.org.vn/core/sid/bhxh"/>
          <value value="0791234567"/>
        </identifier>
        <name>
          <text value="Nguyễn Văn An"/>
          <family value="Nguyễn"/>
          <given value="Văn"/>
          <given value="An"/>
        </name>
        <telecom>
          <system value="phone"/>
          <value value="0901234567"/>
          <use value="mobile"/>
        </telecom>
        <telecom>
          <system value="email"/>
          <value value="an.nguyen@email.vn"/>
        </telecom>
        <gender value="male"/>
        <birthDate value="1985-03-15"/>
        <address>
          <extension
                     url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province">
            <valueCoding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"/>
              <code value="79"/>
              <display value="Thành phố Hồ Chí Minh"/>
            </valueCoding>
          </extension>
          <extension
                     url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward">
            <valueCoding>
              <system
                      value="http://fhir.hl7.org.vn/core/CodeSystem/vn-ward-cs"/>
              <code value="26743"/>
              <display value="Phường Bến Thành"/>
            </valueCoding>
          </extension>
          <text
                value="Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh"/>
          <line value="Số 123 Nguyễn Huệ"/>
          <state value="Thành phố Hồ Chí Minh"/>
          <country value="VN"/>
        </address>
      </Patient>
    </resource>
  </entry>
  <entry>
    <fullUrl
             value="http://fhir.hl7.org.vn/core/Observation/ExampleObservationHealthClassification"/>
    <resource>
      <Observation>
        <id value="ExampleObservationHealthClassification"/>
        <meta>
          <profile
                   value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-health-classification"/>
        </meta>
        <language value="vi"/>
        <text>
          <status value="generated"/>
          <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>
        </text>
        <status value="final"/>
        <category>
          <coding>
            <system
                    value="http://terminology.hl7.org/CodeSystem/observation-category"/>
            <code value="exam"/>
            <display value="Exam"/>
          </coding>
        </category>
        <code>
          <coding>
            <system
                    value="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-observation-code-cs"/>
            <code value="PHAN_LOAI_SK"/>
            <display value="Phân loại sức khỏe"/>
          </coding>
          <text value="Phân loại sức khỏe (PHAN_LOAI_SK)"/>
        </code>
        <subject>🔗 
          <reference value="Patient/ExamplePatientNguyenVanAn"/>
        </subject>
        <effectiveDateTime value="2026-06-01"/>
        <performer>🔗 
          <reference value="Practitioner/ExamplePractitionerBSCKII"/>
        </performer>
        <valueCodeableConcept>
          <coding>
            <system
                    value="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-classification-cs"/>
            <code value="2"/>
            <display value="Loại II — Khoẻ"/>
          </coding>
        </valueCodeableConcept>
      </Observation>
    </resource>
  </entry>
</Bundle>