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
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
| Draft tại thời điểm 2026-07-31 |
Các định nghĩa cho vnPharmacyDrugCatalogLm mô hình logic
Guidance on how to interpret the contents of this table can be foundhere
| 0. vnPharmacyDrugCatalogLm | |
| Definition | 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. |
| Short | Danh mục thuốc CSDL Dược — Logical Model |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnPharmacyDrugCatalogLm.drugId | |
| Definition | id — Mã định danh thuốc |
| Short | id — Mã định danh thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnPharmacyDrugCatalogLm.name | |
| Definition | name — Tên thuốc |
| Short | name — Tên thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnPharmacyDrugCatalogLm.drugGroupId | |
| Definition | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Short | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnPharmacyDrugCatalogLm.registrationNumber | |
| Definition | registration_number — Số giấy phép lưu hành |
| Short | registration_number — Số giấy phép lưu hành |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnPharmacyDrugCatalogLm.oldRegistrationNumber | |
| Definition | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Short | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnPharmacyDrugCatalogLm.strength | |
| Definition | strength — Hàm lượng |
| Short | strength — Hàm lượng |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnPharmacyDrugCatalogLm.route | |
| Definition | routes[] — Đường dùng |
| Short | routes[] — Đường dùng |
| Control | 0..* |
| Type | BackboneElement |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 18. vnPharmacyDrugCatalogLm.route.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 20. vnPharmacyDrugCatalogLm.route.extension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
| Short | Additional content defined by implementations |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on vnPharmacyDrugCatalogLm.route.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 22. vnPharmacyDrugCatalogLm.route.modifierExtension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). |
| Short | Extensions that cannot be ignored even if unrecognized |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. |
| Alternate Names | extensions, user content, modifiers |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| 24. vnPharmacyDrugCatalogLm.route.routeId | |
| Definition | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Short | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 26. vnPharmacyDrugCatalogLm.route.routeName | |
| Definition | routes[].name — Tên đường dùng |
| Short | routes[].name — Tên đường dùng |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 28. vnPharmacyDrugCatalogLm.prescriptionStatus | |
| Definition | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Short | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 30. vnPharmacyDrugCatalogLm.specialControlType | |
| Definition | 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ạ) |
| Short | 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ạ) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 32. vnPharmacyDrugCatalogLm.packaging | |
| Definition | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Short | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Control | 0..* |
| Type | BackboneElement |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 34. vnPharmacyDrugCatalogLm.packaging.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 36. vnPharmacyDrugCatalogLm.packaging.extension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
| Short | Additional content defined by implementations |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on vnPharmacyDrugCatalogLm.packaging.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 38. vnPharmacyDrugCatalogLm.packaging.modifierExtension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). |
| Short | Extensions that cannot be ignored even if unrecognized |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. |
| Alternate Names | extensions, user content, modifiers |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| 40. vnPharmacyDrugCatalogLm.packaging.unitId | |
| Definition | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Short | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 42. vnPharmacyDrugCatalogLm.packaging.unitName | |
| Definition | packagings[].unit_name — Tên đơn vị tính |
| Short | packagings[].unit_name — Tên đơn vị tính |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 44. vnPharmacyDrugCatalogLm.packaging.gtin | |
| Definition | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Short | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 46. vnPharmacyDrugCatalogLm.lastUpdateTime | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 48. vnPharmacyDrugCatalogLm.manufacturerId | |
| Definition | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Short | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 50. vnPharmacyDrugCatalogLm.manufacturerName | |
| Definition | manufacturer.name — Tên nhà sản xuất |
| Short | manufacturer.name — Tên nhà sản xuất |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 52. vnPharmacyDrugCatalogLm.manufacturerCountry | |
| Definition | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Short | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 54. vnPharmacyDrugCatalogLm.manufacturerAddress | |
| Definition | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Short | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 56. vnPharmacyDrugCatalogLm.approvalDate | |
| Definition | approval_date — Ngày cấp số giấy phép lưu hành |
| Short | approval_date — Ngày cấp số giấy phép lưu hành |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 58. vnPharmacyDrugCatalogLm.expiryDate | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
Guidance on how to interpret the contents of this table can be foundhere
| 0. vnPharmacyDrugCatalogLm | |
| Definition | 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. |
| Short | Danh mục thuốc CSDL Dược — Logical Model |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnPharmacyDrugCatalogLm.drugId | |
| Definition | id — Mã định danh thuốc |
| Short | id — Mã định danh thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnPharmacyDrugCatalogLm.name | |
| Definition | name — Tên thuốc |
| Short | name — Tên thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnPharmacyDrugCatalogLm.drugGroupId | |
| Definition | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Short | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnPharmacyDrugCatalogLm.registrationNumber | |
| Definition | registration_number — Số giấy phép lưu hành |
| Short | registration_number — Số giấy phép lưu hành |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnPharmacyDrugCatalogLm.oldRegistrationNumber | |
| Definition | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Short | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnPharmacyDrugCatalogLm.strength | |
| Definition | strength — Hàm lượng |
| Short | strength — Hàm lượng |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnPharmacyDrugCatalogLm.route | |
| Definition | routes[] — Đường dùng |
| Short | routes[] — Đường dùng |
| Control | 0..* |
| Type | BackboneElement |
| 18. vnPharmacyDrugCatalogLm.route.routeId | |
| Definition | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Short | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 20. vnPharmacyDrugCatalogLm.route.routeName | |
| Definition | routes[].name — Tên đường dùng |
| Short | routes[].name — Tên đường dùng |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 22. vnPharmacyDrugCatalogLm.prescriptionStatus | |
| Definition | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Short | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 24. vnPharmacyDrugCatalogLm.specialControlType | |
| Definition | 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ạ) |
| Short | 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ạ) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 26. vnPharmacyDrugCatalogLm.packaging | |
| Definition | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Short | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Control | 0..* |
| Type | BackboneElement |
| 28. vnPharmacyDrugCatalogLm.packaging.unitId | |
| Definition | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Short | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 30. vnPharmacyDrugCatalogLm.packaging.unitName | |
| Definition | packagings[].unit_name — Tên đơn vị tính |
| Short | packagings[].unit_name — Tên đơn vị tính |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 32. vnPharmacyDrugCatalogLm.packaging.gtin | |
| Definition | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Short | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 34. vnPharmacyDrugCatalogLm.lastUpdateTime | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 36. vnPharmacyDrugCatalogLm.manufacturerId | |
| Definition | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Short | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 38. vnPharmacyDrugCatalogLm.manufacturerName | |
| Definition | manufacturer.name — Tên nhà sản xuất |
| Short | manufacturer.name — Tên nhà sản xuất |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 40. vnPharmacyDrugCatalogLm.manufacturerCountry | |
| Definition | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Short | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 42. vnPharmacyDrugCatalogLm.manufacturerAddress | |
| Definition | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Short | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 44. vnPharmacyDrugCatalogLm.approvalDate | |
| Definition | approval_date — Ngày cấp số giấy phép lưu hành |
| Short | approval_date — Ngày cấp số giấy phép lưu hành |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 46. vnPharmacyDrugCatalogLm.expiryDate | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
Guidance on how to interpret the contents of this table can be foundhere
| 0. vnPharmacyDrugCatalogLm | |
| Definition | 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. |
| Short | Danh mục thuốc CSDL Dược — Logical Model |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| 2. vnPharmacyDrugCatalogLm.drugId | |
| Definition | id — Mã định danh thuốc |
| Short | id — Mã định danh thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 4. vnPharmacyDrugCatalogLm.name | |
| Definition | name — Tên thuốc |
| Short | name — Tên thuốc |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 6. vnPharmacyDrugCatalogLm.drugGroupId | |
| Definition | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Short | drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 8. vnPharmacyDrugCatalogLm.registrationNumber | |
| Definition | registration_number — Số giấy phép lưu hành |
| Short | registration_number — Số giấy phép lưu hành |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 10. vnPharmacyDrugCatalogLm.oldRegistrationNumber | |
| Definition | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Short | old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 12. vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 14. vnPharmacyDrugCatalogLm.strength | |
| Definition | strength — Hàm lượng |
| Short | strength — Hàm lượng |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 16. vnPharmacyDrugCatalogLm.route | |
| Definition | routes[] — Đường dùng |
| Short | routes[] — Đường dùng |
| Control | 0..* |
| Type | BackboneElement |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 18. vnPharmacyDrugCatalogLm.route.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 20. vnPharmacyDrugCatalogLm.route.extension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
| Short | Additional content defined by implementations |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on vnPharmacyDrugCatalogLm.route.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 22. vnPharmacyDrugCatalogLm.route.modifierExtension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). |
| Short | Extensions that cannot be ignored even if unrecognized |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. |
| Alternate Names | extensions, user content, modifiers |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| 24. vnPharmacyDrugCatalogLm.route.routeId | |
| Definition | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Short | routes[].id — Mã đường dùng (danh mục GET /master/routes) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 26. vnPharmacyDrugCatalogLm.route.routeName | |
| Definition | routes[].name — Tên đường dùng |
| Short | routes[].name — Tên đường dùng |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 28. vnPharmacyDrugCatalogLm.prescriptionStatus | |
| Definition | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Short | prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 30. vnPharmacyDrugCatalogLm.specialControlType | |
| Definition | 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ạ) |
| Short | 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ạ) |
| Control | 0..1 |
| Type | integer |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 32. vnPharmacyDrugCatalogLm.packaging | |
| Definition | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Short | packagings[] — Quy cách đóng gói theo từng cấp độ |
| Control | 0..* |
| Type | BackboneElement |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 34. vnPharmacyDrugCatalogLm.packaging.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 36. vnPharmacyDrugCatalogLm.packaging.extension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
| Short | Additional content defined by implementations |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on vnPharmacyDrugCatalogLm.packaging.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 38. vnPharmacyDrugCatalogLm.packaging.modifierExtension | |
| Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). |
| Short | Extensions that cannot be ignored even if unrecognized |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..* |
| Type | Extension |
| Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them |
| Summary | true |
| Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. |
| Alternate Names | extensions, user content, modifiers |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| 40. vnPharmacyDrugCatalogLm.packaging.unitId | |
| Definition | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Short | packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units) |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 42. vnPharmacyDrugCatalogLm.packaging.unitName | |
| Definition | packagings[].unit_name — Tên đơn vị tính |
| Short | packagings[].unit_name — Tên đơn vị tính |
| Control | 1..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 44. vnPharmacyDrugCatalogLm.packaging.gtin | |
| Definition | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Short | packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 46. vnPharmacyDrugCatalogLm.lastUpdateTime | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 48. vnPharmacyDrugCatalogLm.manufacturerId | |
| Definition | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Short | manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 50. vnPharmacyDrugCatalogLm.manufacturerName | |
| Definition | manufacturer.name — Tên nhà sản xuất |
| Short | manufacturer.name — Tên nhà sản xuất |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 52. vnPharmacyDrugCatalogLm.manufacturerCountry | |
| Definition | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Short | manufacturer.country — Mã quốc gia sản xuất (ISO-3166) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 54. vnPharmacyDrugCatalogLm.manufacturerAddress | |
| Definition | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Short | manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1) |
| Control | 0..1 |
| Type | string |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 56. vnPharmacyDrugCatalogLm.approvalDate | |
| Definition | approval_date — Ngày cấp số giấy phép lưu hành |
| Short | approval_date — Ngày cấp số giấy phép lưu hành |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| 58. vnPharmacyDrugCatalogLm.expiryDate | |
| Definition | 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) |
| Short | 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) |
| Control | 0..1 |
| Type | date |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |