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

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

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vnPharmacyDrugCatalogLm Phiên bản: 0.9.0
Computable Name: VNPharmacyDrugCatalogLM
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.163

Logical model cho bản ghi thuốc trong danh mục quốc gia của Hệ thống cơ sở dữ liệu về dược (api.csdlduoc.com.vn/v2, GET /master/drugs). Nguồn: Tài liệu kỹ thuật đặc tả API v1.1 mục 5.3, ban hành theo QĐ 232/QĐ-TTYQG (17/7/2026). Đây là danh mục do TTYQG cấp phát (read-only đối với cơ sở); phần mềm HIS/nhà thuốc đồng bộ tăng dần bằng last_update_from/last_update_to.

Usages:

  • This Logical Model is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung hồ sơ

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnPharmacyDrugCatalogLm 0..* Base Danh mục thuốc CSDL Dược — Logical Model
... drugId 1..1 string id — Mã định danh thuốc
... name 1..1 string name — Tên thuốc
... drugGroupId 0..1 string drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)
... oldRegistrationNumber 0..1 string old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)
... activePharmaceuticalIngredient 0..1 string active_pharmaceutical_ingredient — Hoạt chất (chuỗi gộp, có thể nhiều hoạt chất kèm hàm lượng)
... strength 0..1 string strength — Hàm lượng
... route 0..* BackboneElement routes[] — Đường dùng
.... routeId 1..1 string routes[].id — Mã đường dùng (danh mục GET /master/routes)
.... routeName 1..1 string routes[].name — Tên đường dùng
... prescriptionStatus 0..1 integer prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)
... specialControlType 0..1 integer special_control_type — Phân loại thuốc kiểm soát đặc biệt (mục 6.4.4: 0 = không KSĐB, 1 = gây nghiện, 2 = hướng thần, 3 = tiền chất, 4 = thuốc độc, 5 = cấm dùng cho bộ/ngành, 6 = phóng xạ)
... packaging 0..* BackboneElement packagings[] — Quy cách đóng gói theo từng cấp độ
.... unitId 1..1 string packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)
.... unitName 1..1 string packagings[].unit_name — Tên đơn vị tính
.... gtin 0..1 string packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói
... lastUpdateTime 0..1 dateTime last_update_time — Ngày chỉnh sửa gần nhất (bổ sung ở v1.1, phục vụ đồng bộ tăng dần)
... manufacturerId 0..1 string manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)
... manufacturerName 0..1 string manufacturer.name — Tên nhà sản xuất
... manufacturerCountry 0..1 string manufacturer.country — Mã quốc gia sản xuất (ISO-3166)
... manufacturerAddress 0..1 string manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)
... approvalDate 0..1 date approval_date — Ngày cấp số giấy phép lưu hành
... expiryDate 0..1 date expiry_date — Ngày hết hiệu lực lưu hành (hạn GPLH — KHÔNG phải hạn dùng lô thuốc)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnPharmacyDrugCatalogLm 0..* Base Danh mục thuốc CSDL Dược — Logical Model
... drugId 1..1 string id — Mã định danh thuốc
... name 1..1 string name — Tên thuốc
... drugGroupId 0..1 string drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)
... oldRegistrationNumber 0..1 string old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)
... activePharmaceuticalIngredient 0..1 string active_pharmaceutical_ingredient — Hoạt chất (chuỗi gộp, có thể nhiều hoạt chất kèm hàm lượng)
... strength 0..1 string strength — Hàm lượng
... route 0..* BackboneElement routes[] — Đường dùng
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... routeId 1..1 string routes[].id — Mã đường dùng (danh mục GET /master/routes)
.... routeName 1..1 string routes[].name — Tên đường dùng
... prescriptionStatus 0..1 integer prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)
... specialControlType 0..1 integer special_control_type — Phân loại thuốc kiểm soát đặc biệt (mục 6.4.4: 0 = không KSĐB, 1 = gây nghiện, 2 = hướng thần, 3 = tiền chất, 4 = thuốc độc, 5 = cấm dùng cho bộ/ngành, 6 = phóng xạ)
... packaging 0..* BackboneElement packagings[] — Quy cách đóng gói theo từng cấp độ
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... unitId 1..1 string packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)
.... unitName 1..1 string packagings[].unit_name — Tên đơn vị tính
.... gtin 0..1 string packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói
... lastUpdateTime 0..1 dateTime last_update_time — Ngày chỉnh sửa gần nhất (bổ sung ở v1.1, phục vụ đồng bộ tăng dần)
... manufacturerId 0..1 string manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)
... manufacturerName 0..1 string manufacturer.name — Tên nhà sản xuất
... manufacturerCountry 0..1 string manufacturer.country — Mã quốc gia sản xuất (ISO-3166)
... manufacturerAddress 0..1 string manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)
... approvalDate 0..1 date approval_date — Ngày cấp số giấy phép lưu hành
... expiryDate 0..1 date expiry_date — Ngày hết hiệu lực lưu hành (hạn GPLH — KHÔNG phải hạn dùng lô thuốc)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Mandatory: 0 element(7 nested mandatory elements)

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnPharmacyDrugCatalogLm 0..* Base Danh mục thuốc CSDL Dược — Logical Model
... drugId 1..1 string id — Mã định danh thuốc
... name 1..1 string name — Tên thuốc
... drugGroupId 0..1 string drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)
... oldRegistrationNumber 0..1 string old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)
... activePharmaceuticalIngredient 0..1 string active_pharmaceutical_ingredient — Hoạt chất (chuỗi gộp, có thể nhiều hoạt chất kèm hàm lượng)
... strength 0..1 string strength — Hàm lượng
... route 0..* BackboneElement routes[] — Đường dùng
.... routeId 1..1 string routes[].id — Mã đường dùng (danh mục GET /master/routes)
.... routeName 1..1 string routes[].name — Tên đường dùng
... prescriptionStatus 0..1 integer prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)
... specialControlType 0..1 integer special_control_type — Phân loại thuốc kiểm soát đặc biệt (mục 6.4.4: 0 = không KSĐB, 1 = gây nghiện, 2 = hướng thần, 3 = tiền chất, 4 = thuốc độc, 5 = cấm dùng cho bộ/ngành, 6 = phóng xạ)
... packaging 0..* BackboneElement packagings[] — Quy cách đóng gói theo từng cấp độ
.... unitId 1..1 string packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)
.... unitName 1..1 string packagings[].unit_name — Tên đơn vị tính
.... gtin 0..1 string packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói
... lastUpdateTime 0..1 dateTime last_update_time — Ngày chỉnh sửa gần nhất (bổ sung ở v1.1, phục vụ đồng bộ tăng dần)
... manufacturerId 0..1 string manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)
... manufacturerName 0..1 string manufacturer.name — Tên nhà sản xuất
... manufacturerCountry 0..1 string manufacturer.country — Mã quốc gia sản xuất (ISO-3166)
... manufacturerAddress 0..1 string manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)
... approvalDate 0..1 date approval_date — Ngày cấp số giấy phép lưu hành
... expiryDate 0..1 date expiry_date — Ngày hết hiệu lực lưu hành (hạn GPLH — KHÔNG phải hạn dùng lô thuốc)

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnPharmacyDrugCatalogLm 0..* Base Danh mục thuốc CSDL Dược — Logical Model
... drugId 1..1 string id — Mã định danh thuốc
... name 1..1 string name — Tên thuốc
... drugGroupId 0..1 string drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)
... oldRegistrationNumber 0..1 string old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)
... activePharmaceuticalIngredient 0..1 string active_pharmaceutical_ingredient — Hoạt chất (chuỗi gộp, có thể nhiều hoạt chất kèm hàm lượng)
... strength 0..1 string strength — Hàm lượng
... route 0..* BackboneElement routes[] — Đường dùng
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... routeId 1..1 string routes[].id — Mã đường dùng (danh mục GET /master/routes)
.... routeName 1..1 string routes[].name — Tên đường dùng
... prescriptionStatus 0..1 integer prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)
... specialControlType 0..1 integer special_control_type — Phân loại thuốc kiểm soát đặc biệt (mục 6.4.4: 0 = không KSĐB, 1 = gây nghiện, 2 = hướng thần, 3 = tiền chất, 4 = thuốc độc, 5 = cấm dùng cho bộ/ngành, 6 = phóng xạ)
... packaging 0..* BackboneElement packagings[] — Quy cách đóng gói theo từng cấp độ
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... unitId 1..1 string packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)
.... unitName 1..1 string packagings[].unit_name — Tên đơn vị tính
.... gtin 0..1 string packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói
... lastUpdateTime 0..1 dateTime last_update_time — Ngày chỉnh sửa gần nhất (bổ sung ở v1.1, phục vụ đồng bộ tăng dần)
... manufacturerId 0..1 string manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)
... manufacturerName 0..1 string manufacturer.name — Tên nhà sản xuất
... manufacturerCountry 0..1 string manufacturer.country — Mã quốc gia sản xuất (ISO-3166)
... manufacturerAddress 0..1 string manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)
... approvalDate 0..1 date approval_date — Ngày cấp số giấy phép lưu hành
... expiryDate 0..1 date expiry_date — Ngày hết hiệu lực lưu hành (hạn GPLH — KHÔNG phải hạn dùng lô thuốc)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Mandatory: 0 element(7 nested mandatory elements)

 

Biểu diễn khác của hồ sơ: CSV, Excel