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

Mô hình logic: Danh mục thuốc CSDL Dược — Logical Model - Ánh xạ

Draft tại thời điểm 2026-07-31

Ánh xạ cho vnPharmacyDrugCatalogLm mô hình logic.

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVN Core FHIR mappingdoco
.. vnPharmacyDrugCatalogLm
... drugId
VNCoreMedication.code.coding.code (hệ mã GPLH) | VNCoreMedication.extension[registrationNumber].valueString
API mô tả drug_id = 'Mã định danh thuốc/Số giấy phép lưu hành' (mục 5.3.2 path variable) — dùng số GPLH làm khóa tra cứu.
... name
VNCoreMedication.code.text
... drugGroupId
— (chưa có carrier trên VNCoreMedication; tham khảo MedicationKnowledge.productType)
... oldRegistrationNumber
— (giữ ở lớp adapter; nếu cần biểu diễn dùng Medication.identifier với period kết thúc)
... activePharmaceuticalIngredient
VNCoreMedication.ingredient.itemCodeableConcept.text
v1.1 đã bỏ danh mục hoạt chất độc lập (/master/active-ingredients của v1.0); hoạt chất chỉ còn là chuỗi tự do — không terminology-hóa được từ phía CSDL Dược.
... strength
VNCoreMedication.ingredient.strength (Ratio) | VNCoreMedication.amount
... route
.... @id
.... extension
.... modifierExtension
.... routeId
VNCoreMedicationRequest.dosageInstruction.route.coding.code
Cần đối chiếu bộ mã đường dùng của TTYQG với VNMedicationRouteCS (BYT) khi có sandbox — nếu khác nhau phải có ConceptMap trước khi map thẳng.
.... routeName
VNCoreMedicationRequest.dosageInstruction.route.text
... prescriptionStatus
cơ sở bán lẻ chỉ bán thuốc kê đơn khi có đơn hợp lệ theo TT 26/2025/TT-BYT Điều 12 khoản 7)
... specialControlType
— (ứng viên CodeSystem VN Core riêng — đề xuất P1 analysis/59; khớp phân loại thuốc phải kiểm soát đặc biệt theo TT 18/2026/TT-BYT và ký tự loại đơn N/H/C theo TT 26/2025/TT-BYT)
... packaging
.... @id
.... extension
.... modifierExtension
.... unitId
  • Quantity.code tại các resource giao dịch (SupplyDelivery.suppliedItem.quantity
  • MedicationDispense.quantity)
.... unitName
Quantity.unit tại các resource giao dịch
.... gtin
//www.gs1.org/gtin)
GTIN là trục định danh đóng gói xuyên suốt CSDL Dược (danh mục + giao dịch). v1.1 đã bỏ conversion_rate_to_base/is_basic_unit của v1.0.
... lastUpdateTime
Resource.meta.lastUpdated
... manufacturerId
VNCoreMedication.manufacturer.resolve().identifier.value
... manufacturerName
VNCoreMedication.manufacturer.display | Organization.name
... manufacturerCountry
Organization.address.country
... manufacturerAddress
Organization.address.text
... approvalDate
— (thuộc hồ sơ đăng ký lưu hành; tham khảo MedicationKnowledge.regulatory)
... expiryDate
— (KHÔNG map sang Medication.batch.expirationDate — đó là hạn dùng lô; hạn GPLH tham khảo MedicationKnowledge.regulatory)

doco Documentation for this format