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 - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Ví dụ: Thuốc Amoxicillin 500mg

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


<Medication xmlns="http://hl7.org/fhir">
  <id value="ExampleMedicationAmoxicillin"/>
  <meta>
    <profile
             value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication"/>
  </meta>
  <language value="vi"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Medication ExampleMedicationAmoxicillin</b></p><a name="ExampleMedicationAmoxicillin"> </a><a name="hcExampleMedicationAmoxicillin"> </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.html">Thuốc VN Core — VN Core Medication Profile</a></p></div><p><b>Số đăng ký thuốc (Visa) — Medication Registration Number</b>: VD-12345-20</p><p><b>identifier</b>: <a href="NamingSystem-vn-drug-registration-number-ns.html" title="Hệ thống định danh số đăng ký lưu hành (giấy phép lưu hành, GPLH) của thuốc và nguyên liệu làm thuốc tại Việt Nam — tầng 1 trong mô hình định danh thuốc của VN Core (analysis/62 #3).
Hai định dạng cùng tồn tại:
- **Định dạng hiện hành**: 12 chữ số theo TT 12/2025/TT-BYT.
- **Định dạng legacy**: dạng chữ-số như `VD-12345-15`, `VN-12345-16`, `QLĐB-123-45` — tiếp tục có giá trị theo quy tắc chuyển tiếp của TT 12/2025/TT-BYT cho tới khi được cấp lại.
Số đăng ký là ĐỊNH DANH của một sản phẩm được cấp phép, không phải mã phân loại: dùng ở `Medication.identifier`, KHÔNG dùng làm `Medication.code`.
Căn cứ:
- **TT 12/2025/TT-BYT** (ban hành 16/05/2025, hiệu lực 01/07/2025) — đăng ký lưu hành thuốc, nguyên liệu làm thuốc; cấu trúc số đăng ký 12 chữ số và quy tắc chuyển tiếp số cũ
- **Luật 105/2016/QH13** — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)
- **QĐ 3176/QĐ-BYT** — trường `SO_DANG_KY` trong dữ liệu đầu ra KCB; **QĐ 1931/QĐ-BYT** bổ sung quy ước `UBND.YYYY.X.S` cho thuốc hiếm được UBND cấp tỉnh cấp phép nhập khẩu.">VNDrugRegistrationNumber</a>/VD-12345-20, <a href="http://terminology.hl7.org/7.1.0/NamingSystem-gtin.html" title="The GS1 GTIN is a globally unique identifier of trade items. A trade item is any item (product or service) upon which there is a need to retrieve pre-defined information and that may be priced, or ordered, or invoiced at any point in any supply chain. Note: GTINs may be used in both Codes (http://build.fhir.org/datatypes.html#Coding) and Identifiers (http://build.fhir.org/datatypes.html#Identifier).">GTIN Global Trade Item Number</a>/08935049512347</p><p><b>code</b>: <span title="Codes:{http://www.whocc.no/atc J01CA04}">Amoxicillin 500mg</span></p><p><b>form</b>: <span title="Codes:{http://snomed.info/sct 385049006}">Viên nang cứng</span></p><p><b>amount</b>: 20 viên<span style="background: LightGoldenRodYellow"> (Details: UCUM  code1 = '1')</span>/1 hộp<span style="background: LightGoldenRodYellow"> (Details: UCUM  code1 = '1')</span></p><h3>Ingredients</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Item[x]</b></td><td><b>IsActive</b></td><td><b>Strength</b></td></tr><tr><td style="display: none">*</td><td><span title="Codes:{http://snomed.info/sct 27658006}">Amoxicillin</span></td><td>true</td><td>500 mg<span style="background: LightGoldenRodYellow"> (Details: UCUM  codemg = 'mg')</span>/1 viên<span style="background: LightGoldenRodYellow"> (Details: UCUM  code1 = '1')</span></td></tr></table><h3>Batches</h3><table class="grid"><tr><td style="display: none">-</td><td><b>LotNumber</b></td><td><b>ExpirationDate</b></td></tr><tr><td style="display: none">*</td><td>LOT2026031501</td><td>2028-03-15</td></tr></table></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number">
    <valueString value="VD-12345-20"/>
  </extension>
  <identifier>
    <system value="http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc"/>
    <value value="VD-12345-20"/>
  </identifier>
  <identifier>
    <system value="https://www.gs1.org/gtin"/>
    <value value="08935049512347"/>
  </identifier>
  <code>
    <coding>
      <system value="http://www.whocc.no/atc"/>
      <code value="J01CA04"/>
      <display value="Amoxicillin"/>
    </coding>
    <text value="Amoxicillin 500mg"/>
  </code>
  <form>
    <coding>
      <system value="http://snomed.info/sct"/>
      <code value="385049006"/>
      <display value="Capsule"/>
    </coding>
    <text value="Viên nang cứng"/>
  </form>
  <amount>
    <numerator>
      <value value="20"/>
      <unit value="viên"/>
      <system value="http://unitsofmeasure.org"/>
      <code value="1"/>
    </numerator>
    <denominator>
      <value value="1"/>
      <unit value="hộp"/>
      <system value="http://unitsofmeasure.org"/>
      <code value="1"/>
    </denominator>
  </amount>
  <ingredient>
    <itemCodeableConcept>
      <coding>
        <system value="http://snomed.info/sct"/>
        <code value="27658006"/>
        <display value="Amoxicillin-containing product"/>
      </coding>
      <text value="Amoxicillin"/>
    </itemCodeableConcept>
    <isActive value="true"/>
    <strength>
      <numerator>
        <value value="500"/>
        <unit value="mg"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="mg"/>
      </numerator>
      <denominator>
        <value value="1"/>
        <unit value="viên"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="1"/>
      </denominator>
    </strength>
  </ingredient>
  <batch>
    <lotNumber value="LOT2026031501"/>
    <expirationDate value="2028-03-15"/>
  </batch>
</Medication>