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.10.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.10.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-09-22

Á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.identifier[drugRegistrationNumber].value
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 khoá 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-hoá đượ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
  • VNCoreMedication.extension[controlledClass].valueCodeableConcept — mã trùng nguyên giá trị 0–6
  • trục này do mục 6.4.4 QĐ 232/QĐ-TTYQG cấp
  • KHÔNG phải TT 18/2026/TT-BYT — Thông tư đó ban hành ba danh mục hoạt chất và ba bảng giới hạn nồng độ cho thuốc dạng phối hợp
  • không phải bảy nhóm phân loại. Nền pháp lý của phân loại là Luật Dược 105/2016/QH13 Điều 2 khoản 26; ký tự loại đơn N/H/C theo TT 26/2025/TT-BYT khớp với mã 1/2/3.
... 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
  • — (không có carrier FHIR R4 lossless; Resource.meta.lastUpdated là instant
  • không phải date)
Adapter phải bảo toàn date-only cho cursor đồng bộ và không được bịa giờ để điền 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