{ "resourceType" : "StructureDefinition", "id" : "vnPharmacyDrugCatalogLm", "language" : "vi", "text" : { "status" : "extensions", "div" : "

Generated Narrative: StructureDefinition vnPharmacyDrugCatalogLm

\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
NameFlagsCard.TypeDescription & Constraints\"doco\"
\".\"\".\" vnPharmacyDrugCatalogLm 0..*BaseDanh mục thuốc CSDL Dược — Logical Model
\".\"\".\"\".\" drugId 1..1stringid — Mã định danh thuốc
\".\"\".\"\".\" name 1..1stringname — Tên thuốc
\".\"\".\"\".\" drugGroupId 0..1stringdrug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)
\".\"\".\"\".\" registrationNumber 1..1stringregistration_number — Số giấy phép lưu hành
\".\"\".\"\".\" oldRegistrationNumber 0..1stringold_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)
\".\"\".\"\".\" activePharmaceuticalIngredient 0..1stringactive_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..1stringstrength — Hàm lượng
\".\"\".\"\".\" route 0..*BackboneElementroutes[] — Đường dùng
\".\"\".\"\".\"\".\" routeId 1..1stringroutes[].id — Mã đường dùng (danh mục GET /master/routes)
\".\"\".\"\".\"\".\" routeName 1..1stringroutes[].name — Tên đường dùng
\".\"\".\"\".\" prescriptionStatus 0..1integerprescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)
\".\"\".\"\".\" specialControlType 0..1integerspecial_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..*BackboneElementpackagings[] — Quy cách đóng gói theo từng cấp độ
\".\"\".\"\".\"\".\" unitId 1..1stringpackagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)
\".\"\".\"\".\"\".\" unitName 1..1stringpackagings[].unit_name — Tên đơn vị tính
\".\"\".\"\".\"\".\" gtin 0..1stringpackagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói
\".\"\".\"\".\" lastUpdateTime 0..1dateTimelast_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..1stringmanufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)
\".\"\".\"\".\" manufacturerName 0..1stringmanufacturer.name — Tên nhà sản xuất
\".\"\".\"\".\" manufacturerCountry 0..1stringmanufacturer.country — Mã quốc gia sản xuất (ISO-3166)
\".\"\".\"\".\" manufacturerAddress 0..1stringmanufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)
\".\"\".\"\".\" approvalDate 0..1dateapproval_date — Ngày cấp số giấy phép lưu hành
\".\"\".\"\".\" expiryDate 0..1dateexpiry_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
" }, "extension" : [{ "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis", "valueCoding" : { "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs", "code" : "QD-232-TTYQG" } }, { "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis", "valueCoding" : { "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs", "code" : "TT-11-2025" } }], "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vnPharmacyDrugCatalogLm", "identifier" : [{ "system" : "urn:ietf:rfc:3986", "value" : "urn:oid:2.25.161089673617632664299011809196868855799.42.163" }], "version" : "0.9.0", "name" : "VNPharmacyDrugCatalogLM", "title" : "Danh mục thuốc CSDL Dược — Logical Model", "status" : "draft", "date" : "2026-07-31T01:48:42+07:00", "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative", "contact" : [{ "name" : "Omi HealthTech / VN Core FHIR Community Initiative", "telecom" : [{ "system" : "url", "value" : "https://hl7.org.vn" }, { "system" : "email", "value" : "info@hl7.org.vn" }] }, { "name" : "Omi HealthTech (OmiGroup)", "telecom" : [{ "system" : "url", "value" : "https://omihealthtech.vn" }, { "system" : "url", "value" : "https://omigroup.vn" }, { "system" : "email", "value" : "info@hl7.org.vn" }] }], "description" : "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.", "jurisdiction" : [{ "coding" : [{ "system" : "urn:iso:std:iso:3166", "code" : "VN", "display" : "Viet Nam" }] }], "fhirVersion" : "4.0.1", "mapping" : [{ "identity" : "vn-fhir", "uri" : "http://fhir.hl7.org.vn/core/mapping/csdl-duoc-fhir", "name" : "VN Core FHIR mapping", "comment" : "Ánh xạ danh mục thuốc CSDL Dược v1.1 → VNCoreMedication (+ MedicationKnowledge cho phần regulatory/packaging). drug_id trùng vai trò số GPLH; GTIN theo GS1 là trục định danh đóng gói." }], "kind" : "logical", "abstract" : false, "type" : "http://fhir.hl7.org.vn/core/StructureDefinition/vnPharmacyDrugCatalogLm", "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base", "derivation" : "specialization", "snapshot" : { "extension" : [{ "url" : "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version", "valueString" : "4.0.1" }], "element" : [{ "id" : "vnPharmacyDrugCatalogLm", "path" : "vnPharmacyDrugCatalogLm", "short" : "Danh mục thuốc CSDL Dược — Logical Model", "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.", "min" : 0, "max" : "*", "base" : { "path" : "Base", "min" : 0, "max" : "*" }, "isModifier" : false }, { "id" : "vnPharmacyDrugCatalogLm.drugId", "path" : "vnPharmacyDrugCatalogLm.drugId", "short" : "id — Mã định danh thuốc", "definition" : "id — Mã định danh thuốc", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.drugId", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.coding.code (hệ mã GPLH) | VNCoreMedication.extension[registrationNumber].valueString", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.name", "path" : "vnPharmacyDrugCatalogLm.name", "short" : "name — Tên thuốc", "definition" : "name — Tên thuốc", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.name", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.drugGroupId", "path" : "vnPharmacyDrugCatalogLm.drugGroupId", "short" : "drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)", "definition" : "drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.drugGroupId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (chưa có carrier trên VNCoreMedication; tham khảo MedicationKnowledge.productType)" }] }, { "id" : "vnPharmacyDrugCatalogLm.registrationNumber", "path" : "vnPharmacyDrugCatalogLm.registrationNumber", "short" : "registration_number — Số giấy phép lưu hành", "definition" : "registration_number — Số giấy phép lưu hành", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.registrationNumber", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.extension[registrationNumber].valueString | VNCoreMedicationRequest.extension[registrationNumber].valueString | VNCoreMedicationDispense.extension[registrationNumber].valueString" }] }, { "id" : "vnPharmacyDrugCatalogLm.oldRegistrationNumber", "path" : "vnPharmacyDrugCatalogLm.oldRegistrationNumber", "short" : "old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)", "definition" : "old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.oldRegistrationNumber", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (giữ ở lớp adapter; nếu cần biểu diễn dùng Medication.identifier với period kết thúc)" }] }, { "id" : "vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient", "path" : "vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient", "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)", "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)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.ingredient.itemCodeableConcept.text", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.strength", "path" : "vnPharmacyDrugCatalogLm.strength", "short" : "strength — Hàm lượng", "definition" : "strength — Hàm lượng", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.strength", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.ingredient.strength (Ratio) | VNCoreMedication.amount" }] }, { "id" : "vnPharmacyDrugCatalogLm.route", "path" : "vnPharmacyDrugCatalogLm.route", "short" : "routes[] — Đường dùng", "definition" : "routes[] — Đường dùng", "min" : 0, "max" : "*", "base" : { "path" : "vnPharmacyDrugCatalogLm.route", "min" : 0, "max" : "*" }, "type" : [{ "code" : "BackboneElement" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }] }, { "id" : "vnPharmacyDrugCatalogLm.route.id", "path" : "vnPharmacyDrugCatalogLm.route.id", "representation" : ["xmlAttr"], "short" : "Unique id for inter-element referencing", "definition" : "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.", "min" : 0, "max" : "1", "base" : { "path" : "Element.id", "min" : 0, "max" : "1" }, "type" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type", "valueUrl" : "string" }], "code" : "http://hl7.org/fhirpath/System.String" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyDrugCatalogLm.route.extension", "path" : "vnPharmacyDrugCatalogLm.route.extension", "slicing" : { "discriminator" : [{ "type" : "value", "path" : "url" }], "description" : "Extensions are always sliced by (at least) url", "rules" : "open" }, "short" : "Additional content defined by implementations", "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.", "comment" : "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.", "alias" : ["extensions", "user content"], "min" : 0, "max" : "*", "base" : { "path" : "Element.extension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyDrugCatalogLm.route.modifierExtension", "path" : "vnPharmacyDrugCatalogLm.route.modifierExtension", "short" : "Extensions that cannot be ignored even if unrecognized", "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.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).", "comment" : "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.", "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](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).", "alias" : ["extensions", "user content", "modifiers"], "min" : 0, "max" : "*", "base" : { "path" : "BackboneElement.modifierExtension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : true, "isModifierReason" : "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them", "isSummary" : true, "mapping" : [{ "identity" : "rim", "map" : "N/A" }] }, { "id" : "vnPharmacyDrugCatalogLm.route.routeId", "path" : "vnPharmacyDrugCatalogLm.route.routeId", "short" : "routes[].id — Mã đường dùng (danh mục GET /master/routes)", "definition" : "routes[].id — Mã đường dùng (danh mục GET /master/routes)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.route.routeId", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationRequest.dosageInstruction.route.coding.code", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.route.routeName", "path" : "vnPharmacyDrugCatalogLm.route.routeName", "short" : "routes[].name — Tên đường dùng", "definition" : "routes[].name — Tên đường dùng", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.route.routeName", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationRequest.dosageInstruction.route.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.prescriptionStatus", "path" : "vnPharmacyDrugCatalogLm.prescriptionStatus", "short" : "prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)", "definition" : "prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.prescriptionStatus", "min" : 0, "max" : "1" }, "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (không có carrier trực tiếp trên VNCoreMedication; nghiệp vụ: 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)" }] }, { "id" : "vnPharmacyDrugCatalogLm.specialControlType", "path" : "vnPharmacyDrugCatalogLm.specialControlType", "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ạ)", "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ạ)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.specialControlType", "min" : 0, "max" : "1" }, "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (ứ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)" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging", "path" : "vnPharmacyDrugCatalogLm.packaging", "short" : "packagings[] — Quy cách đóng gói theo từng cấp độ", "definition" : "packagings[] — Quy cách đóng gói theo từng cấp độ", "min" : 0, "max" : "*", "base" : { "path" : "vnPharmacyDrugCatalogLm.packaging", "min" : 0, "max" : "*" }, "type" : [{ "code" : "BackboneElement" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.id", "path" : "vnPharmacyDrugCatalogLm.packaging.id", "representation" : ["xmlAttr"], "short" : "Unique id for inter-element referencing", "definition" : "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.", "min" : 0, "max" : "1", "base" : { "path" : "Element.id", "min" : 0, "max" : "1" }, "type" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type", "valueUrl" : "string" }], "code" : "http://hl7.org/fhirpath/System.String" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.extension", "path" : "vnPharmacyDrugCatalogLm.packaging.extension", "slicing" : { "discriminator" : [{ "type" : "value", "path" : "url" }], "description" : "Extensions are always sliced by (at least) url", "rules" : "open" }, "short" : "Additional content defined by implementations", "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.", "comment" : "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.", "alias" : ["extensions", "user content"], "min" : 0, "max" : "*", "base" : { "path" : "Element.extension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : false, "isSummary" : false, "mapping" : [{ "identity" : "rim", "map" : "n/a" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.modifierExtension", "path" : "vnPharmacyDrugCatalogLm.packaging.modifierExtension", "short" : "Extensions that cannot be ignored even if unrecognized", "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.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).", "comment" : "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.", "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](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).", "alias" : ["extensions", "user content", "modifiers"], "min" : 0, "max" : "*", "base" : { "path" : "BackboneElement.modifierExtension", "min" : 0, "max" : "*" }, "type" : [{ "code" : "Extension" }], "constraint" : [{ "key" : "ele-1", "severity" : "error", "human" : "All FHIR elements must have a @value or children", "expression" : "hasValue() or (children().count() > id.count())", "xpath" : "@value|f:*|h:div", "source" : "http://hl7.org/fhir/StructureDefinition/Element" }, { "key" : "ext-1", "severity" : "error", "human" : "Must have either extensions or value[x], not both", "expression" : "extension.exists() != value.exists()", "xpath" : "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source" : "http://hl7.org/fhir/StructureDefinition/Extension" }], "isModifier" : true, "isModifierReason" : "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them", "isSummary" : true, "mapping" : [{ "identity" : "rim", "map" : "N/A" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.unitId", "path" : "vnPharmacyDrugCatalogLm.packaging.unitId", "short" : "packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)", "definition" : "packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.packaging.unitId", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Quantity.code tại các resource giao dịch (SupplyDelivery.suppliedItem.quantity, MedicationDispense.quantity)" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.unitName", "path" : "vnPharmacyDrugCatalogLm.packaging.unitName", "short" : "packagings[].unit_name — Tên đơn vị tính", "definition" : "packagings[].unit_name — Tên đơn vị tính", "min" : 1, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.packaging.unitName", "min" : 1, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Quantity.unit tại các resource giao dịch" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.gtin", "path" : "vnPharmacyDrugCatalogLm.packaging.gtin", "short" : "packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói", "definition" : "packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.packaging.gtin", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.coding (system https://www.gs1.org/gtin)", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.lastUpdateTime", "path" : "vnPharmacyDrugCatalogLm.lastUpdateTime", "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)", "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)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.lastUpdateTime", "min" : 0, "max" : "1" }, "type" : [{ "code" : "dateTime" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Resource.meta.lastUpdated" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerId", "path" : "vnPharmacyDrugCatalogLm.manufacturerId", "short" : "manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)", "definition" : "manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.manufacturerId", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.resolve().identifier.value" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerName", "path" : "vnPharmacyDrugCatalogLm.manufacturerName", "short" : "manufacturer.name — Tên nhà sản xuất", "definition" : "manufacturer.name — Tên nhà sản xuất", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.manufacturerName", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.display | Organization.name" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerCountry", "path" : "vnPharmacyDrugCatalogLm.manufacturerCountry", "short" : "manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "definition" : "manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.manufacturerCountry", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.country" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerAddress", "path" : "vnPharmacyDrugCatalogLm.manufacturerAddress", "short" : "manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)", "definition" : "manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.manufacturerAddress", "min" : 0, "max" : "1" }, "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.approvalDate", "path" : "vnPharmacyDrugCatalogLm.approvalDate", "short" : "approval_date — Ngày cấp số giấy phép lưu hành", "definition" : "approval_date — Ngày cấp số giấy phép lưu hành", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.approvalDate", "min" : 0, "max" : "1" }, "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (thuộc hồ sơ đăng ký lưu hành; tham khảo MedicationKnowledge.regulatory)" }] }, { "id" : "vnPharmacyDrugCatalogLm.expiryDate", "path" : "vnPharmacyDrugCatalogLm.expiryDate", "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)", "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)", "min" : 0, "max" : "1", "base" : { "path" : "vnPharmacyDrugCatalogLm.expiryDate", "min" : 0, "max" : "1" }, "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (KHÔNG map sang Medication.batch.expirationDate — đó là hạn dùng lô; hạn GPLH tham khảo MedicationKnowledge.regulatory)" }] }] }, "differential" : { "element" : [{ "id" : "vnPharmacyDrugCatalogLm", "path" : "vnPharmacyDrugCatalogLm", "short" : "Danh mục thuốc CSDL Dược — Logical Model", "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." }, { "id" : "vnPharmacyDrugCatalogLm.drugId", "path" : "vnPharmacyDrugCatalogLm.drugId", "short" : "id — Mã định danh thuốc", "definition" : "id — Mã định danh thuốc", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.coding.code (hệ mã GPLH) | VNCoreMedication.extension[registrationNumber].valueString", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.name", "path" : "vnPharmacyDrugCatalogLm.name", "short" : "name — Tên thuốc", "definition" : "name — Tên thuốc", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.drugGroupId", "path" : "vnPharmacyDrugCatalogLm.drugGroupId", "short" : "drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)", "definition" : "drug_group_id — Mã nhóm thuốc (danh mục GET /master/drug-groups)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (chưa có carrier trên VNCoreMedication; tham khảo MedicationKnowledge.productType)" }] }, { "id" : "vnPharmacyDrugCatalogLm.registrationNumber", "path" : "vnPharmacyDrugCatalogLm.registrationNumber", "short" : "registration_number — Số giấy phép lưu hành", "definition" : "registration_number — Số giấy phép lưu hành", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.extension[registrationNumber].valueString | VNCoreMedicationRequest.extension[registrationNumber].valueString | VNCoreMedicationDispense.extension[registrationNumber].valueString" }] }, { "id" : "vnPharmacyDrugCatalogLm.oldRegistrationNumber", "path" : "vnPharmacyDrugCatalogLm.oldRegistrationNumber", "short" : "old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)", "definition" : "old_registration_number — Số giấy phép lưu hành cũ (bổ sung ở v1.1)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (giữ ở lớp adapter; nếu cần biểu diễn dùng Medication.identifier với period kết thúc)" }] }, { "id" : "vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient", "path" : "vnPharmacyDrugCatalogLm.activePharmaceuticalIngredient", "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)", "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)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.ingredient.itemCodeableConcept.text", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.strength", "path" : "vnPharmacyDrugCatalogLm.strength", "short" : "strength — Hàm lượng", "definition" : "strength — Hàm lượng", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.ingredient.strength (Ratio) | VNCoreMedication.amount" }] }, { "id" : "vnPharmacyDrugCatalogLm.route", "path" : "vnPharmacyDrugCatalogLm.route", "short" : "routes[] — Đường dùng", "definition" : "routes[] — Đường dùng", "min" : 0, "max" : "*", "type" : [{ "code" : "BackboneElement" }] }, { "id" : "vnPharmacyDrugCatalogLm.route.routeId", "path" : "vnPharmacyDrugCatalogLm.route.routeId", "short" : "routes[].id — Mã đường dùng (danh mục GET /master/routes)", "definition" : "routes[].id — Mã đường dùng (danh mục GET /master/routes)", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationRequest.dosageInstruction.route.coding.code", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.route.routeName", "path" : "vnPharmacyDrugCatalogLm.route.routeName", "short" : "routes[].name — Tên đường dùng", "definition" : "routes[].name — Tên đường dùng", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedicationRequest.dosageInstruction.route.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.prescriptionStatus", "path" : "vnPharmacyDrugCatalogLm.prescriptionStatus", "short" : "prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)", "definition" : "prescription_status — Phân loại thuốc kê đơn (mục 6.4.3: 0 = không kê đơn, 1 = kê đơn)", "min" : 0, "max" : "1", "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (không có carrier trực tiếp trên VNCoreMedication; nghiệp vụ: 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)" }] }, { "id" : "vnPharmacyDrugCatalogLm.specialControlType", "path" : "vnPharmacyDrugCatalogLm.specialControlType", "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ạ)", "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ạ)", "min" : 0, "max" : "1", "type" : [{ "code" : "integer" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (ứ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)" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging", "path" : "vnPharmacyDrugCatalogLm.packaging", "short" : "packagings[] — Quy cách đóng gói theo từng cấp độ", "definition" : "packagings[] — Quy cách đóng gói theo từng cấp độ", "min" : 0, "max" : "*", "type" : [{ "code" : "BackboneElement" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.unitId", "path" : "vnPharmacyDrugCatalogLm.packaging.unitId", "short" : "packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)", "definition" : "packagings[].unit_id — Mã đơn vị tính (danh mục GET /master/units)", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Quantity.code tại các resource giao dịch (SupplyDelivery.suppliedItem.quantity, MedicationDispense.quantity)" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.unitName", "path" : "vnPharmacyDrugCatalogLm.packaging.unitName", "short" : "packagings[].unit_name — Tên đơn vị tính", "definition" : "packagings[].unit_name — Tên đơn vị tính", "min" : 1, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Quantity.unit tại các resource giao dịch" }] }, { "id" : "vnPharmacyDrugCatalogLm.packaging.gtin", "path" : "vnPharmacyDrugCatalogLm.packaging.gtin", "short" : "packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói", "definition" : "packagings[].gtin — Mã GTIN tương ứng cấp độ đóng gói", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.code.coding (system https://www.gs1.org/gtin)", "comment" : "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." }] }, { "id" : "vnPharmacyDrugCatalogLm.lastUpdateTime", "path" : "vnPharmacyDrugCatalogLm.lastUpdateTime", "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)", "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)", "min" : 0, "max" : "1", "type" : [{ "code" : "dateTime" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Resource.meta.lastUpdated" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerId", "path" : "vnPharmacyDrugCatalogLm.manufacturerId", "short" : "manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)", "definition" : "manufacturer.id — Mã nhà sản xuất (danh mục GET /master/manufacturers)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.resolve().identifier.value" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerName", "path" : "vnPharmacyDrugCatalogLm.manufacturerName", "short" : "manufacturer.name — Tên nhà sản xuất", "definition" : "manufacturer.name — Tên nhà sản xuất", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "VNCoreMedication.manufacturer.display | Organization.name" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerCountry", "path" : "vnPharmacyDrugCatalogLm.manufacturerCountry", "short" : "manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "definition" : "manufacturer.country — Mã quốc gia sản xuất (ISO-3166)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.country" }] }, { "id" : "vnPharmacyDrugCatalogLm.manufacturerAddress", "path" : "vnPharmacyDrugCatalogLm.manufacturerAddress", "short" : "manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)", "definition" : "manufacturer.address — Địa chỉ nhà sản xuất (bổ sung ở v1.1)", "min" : 0, "max" : "1", "type" : [{ "code" : "string" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "Organization.address.text" }] }, { "id" : "vnPharmacyDrugCatalogLm.approvalDate", "path" : "vnPharmacyDrugCatalogLm.approvalDate", "short" : "approval_date — Ngày cấp số giấy phép lưu hành", "definition" : "approval_date — Ngày cấp số giấy phép lưu hành", "min" : 0, "max" : "1", "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (thuộc hồ sơ đăng ký lưu hành; tham khảo MedicationKnowledge.regulatory)" }] }, { "id" : "vnPharmacyDrugCatalogLm.expiryDate", "path" : "vnPharmacyDrugCatalogLm.expiryDate", "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)", "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)", "min" : 0, "max" : "1", "type" : [{ "code" : "date" }], "mapping" : [{ "identity" : "vn-fhir", "map" : "— (KHÔNG map sang Medication.batch.expirationDate — đó là hạn dùng lô; hạn GPLH tham khảo MedicationKnowledge.regulatory)" }] }] } }