HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Ví dụ: Trạm Y tế xã (sau sáp nhập ĐVHC) — vòng đời mã cơ sở

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


<Organization xmlns="http://hl7.org/fhir">
  <id value="ExampleOrganizationMergedStation"/>
  <meta>
    <profile
             value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"/>
  </meta>
  <language value="vi"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Organization ExampleOrganizationMergedStation</b></p><a name="ExampleOrganizationMergedStation"> </a><a name="hcExampleOrganizationMergedStation"> </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 TYT}">Trạm y tế</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 XA}">Xã</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 NOT_APPLICABLE}">Không áp dụ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 BAN_DAU}">Cấp ban đầu</span></p><blockquote><p><b>Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension</b></p><ul><li>relationType: <a href="CodeSystem-vn-org-lifecycle-relation-cs.html#vn-org-lifecycle-relation-cs-predecessor">Loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type: predecessor</a> (Tiền nhiệm)</li><li>target: Trạm Y tế xã (cũ, trước sáp nhập 01/7/2025) (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ố): 2 ký tự đầu là mã tỉnh/TP, 3 ký tự sau là số thứ tự cơ sở trong tỉnh (mã 97 = cơ sở thuộc Bộ Quốc phòng, 98 = Bộ Công an).
Cấp mã: Sở Y tế (địa phương) / Cục Quân y (BQP) / Cục Y tế (BCA) theo nguyên tắc tại QĐ 384/QĐ-BYT (30/01/2019); Cục Quản lý Khám, chữa bệnh — Bộ Y tế là đầu mối tổng hợp, công bố danh mục. Dùng để định danh cơ sở y tế trong giám định/thanh toán BHYT (Cổng tiếp nhận dữ liệu giám định BHXH) và liên thông Sổ SKĐT VNeID (QĐ 2733/QĐ-BYT Phụ lục 01 Điều 3).
Đính chính 23/07/2026: trước ghi 'do BHXH Việt Nam cấp' — không đúng cơ quan cấp mã theo QĐ 384/QĐ-BYT.
Căn cứ: QĐ 384/QĐ-BYT (30/01/2019, hiệu lực 01/02/2019 — lưu ý QĐ 2733/QĐ-BYT trích là 'ngày 01/02/2019'), Luật KCB 2023 (15/2023/QH15).
Lưu ý giai đoạn: mã tỉnh 2 ký tự đặt theo danh mục hành chính trước 01/07/2025; sau sáp nhập 34 tỉnh CHƯA có văn bản cấp lại hệ mã (xác minh 23/07/2026) — nguyên tắc chuyển tiếp: cơ sở giữ mã cũ đến khi được cấp mã mới (TT 53/2025/TT-BYT sửa TT 43/2025/TT-BYT về Trạm Y tế xã; NĐ 188/2025/NĐ-CP Điều 69 khoản 8 điểm đ cho thẻ/thông tin tiếp tục sử dụng); theo dõi watch-list.">VNCSKCB</a>/01234)</li><li>period: ?? --&gt; 2025-06-30</li><li>legalBasis: <a href="CodeSystem-vn-legal-document-ref-cs.html#vn-legal-document-ref-cs-NQ-202-2025">Văn bản pháp lý VN — Vietnam Legal Document Reference CodeSystem: NQ-202-2025</a> (NQ 202/2025/QH15)</li><li>carryOver: <a href="CodeSystem-vn-org-carry-over-item-cs.html#vn-org-carry-over-item-cs-bhyt-contract">Hạng mục kế thừa khi chuyển mã cơ sở y tế — Organization Carry-over Item: bhyt-contract</a> (Hợp đồng KCB BHYT)</li><li>carryOver: <a href="CodeSystem-vn-org-carry-over-item-cs.html#vn-org-carry-over-item-cs-primary-care-registration">Hạng mục kế thừa khi chuyển mã cơ sở y tế — Organization Carry-over Item: primary-care-registration</a> (Đăng ký KCB ban đầu)</li><li>carryOver: <a href="CodeSystem-vn-org-carry-over-item-cs.html#vn-org-carry-over-item-cs-license">Hạng mục kế thừa khi chuyển mã cơ sở y tế — Organization Carry-over Item: license</a> (Giấy phép hoạt động KCB)</li></ul></blockquote><p><b>identifier</b>: Mã cơ sở khám chữa bệnh/01567 (, period: 2025-07-01 --&gt; (ongoing))</p><p><b>active</b>: true</p><p><b>name</b>: Trạm Y tế xã Phú Mỹ</p><p><b>address</b>: Xã Phú Mỹ, Thành phố Hà Nội</p></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-type-cs"/>
        <code value="TYT"/>
        <display value="Trạm y tế"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-healthcare-level-cs"/>
        <code value="XA"/>
        <display value="Xã"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-organization-rank-status-cs"/>
        <code value="NOT_APPLICABLE"/>
        <display value="Không áp dụng"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-facility-care-level-cs"/>
        <code value="BAN_DAU"/>
        <display value="Cấp ban đầu"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation">
    <extension url="relationType">
      <valueCoding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-org-lifecycle-relation-cs"/>
        <code value="predecessor"/>
        <display value="Tiền nhiệm"/>
      </valueCoding>
    </extension>
    <extension url="target">
      <valueReference>
        <identifier>
          <system value="http://fhir.hl7.org.vn/core/sid/ma-cskcb"/>
          <value value="01234"/>
        </identifier>
        <display value="Trạm Y tế xã (cũ, trước sáp nhập 01/7/2025)"/>
      </valueReference>
    </extension>
    <extension url="period">
      <valuePeriod>
        <end value="2025-06-30"/>
      </valuePeriod>
    </extension>
    <extension url="legalBasis">
      <valueCoding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
        <code value="NQ-202-2025"/>
        <display value="NQ 202/2025/QH15"/>
      </valueCoding>
    </extension>
    <extension url="carryOver">
      <valueCoding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-org-carry-over-item-cs"/>
        <code value="bhyt-contract"/>
        <display value="Hợp đồng KCB BHYT"/>
      </valueCoding>
    </extension>
    <extension url="carryOver">
      <valueCoding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-org-carry-over-item-cs"/>
        <code value="primary-care-registration"/>
        <display value="Đăng ký KCB ban đầu"/>
      </valueCoding>
    </extension>
    <extension url="carryOver">
      <valueCoding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-org-carry-over-item-cs"/>
        <code value="license"/>
        <display value="Giấy phép hoạt động KCB"/>
      </valueCoding>
    </extension>
  </extension>
  <identifier>
    <type>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
        <code value="CSKCB"/>
        <display value="Mã cơ sở khám chữa bệnh"/>
      </coding>
    </type>
    <system value="http://fhir.hl7.org.vn/core/sid/ma-cskcb"/>
    <value value="01567"/>
    <period>
      <start value="2025-07-01"/>
    </period>
  </identifier>
  <active value="true"/>
  <name value="Trạm Y tế xã Phú Mỹ"/>
  <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="01"/>
        <display value="Thành phố Hà Nội"/>
      </valueCoding>
    </extension>
    <text value="Xã Phú Mỹ, Thành phố Hà Nội"/>
    <state value="Thành phố Hà Nội"/>
    <country value="VN"/>
  </address>
</Organization>