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

Hồ sơ tài nguyên: Thuốc VN Core — VN Core Medication Profile

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

Profile Medication cho Việt Nam. Thông tin chi tiết thuốc: mã, tên, dạng bào chế, hàm lượng, số đăng ký. Liên kết với MedicationRequest (đơn thuốc) và Claim (thanh toán BHYT). Căn cứ:

  • Luật 44/2024/QH15 — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
  • Luật Dược 2016 — nền tảng quản lý thuốc
  • TT 37/2024/TT-BYT — 16/11/2024 — danh mục thuốc hóa dược/sinh phẩm thuộc phạm vi BHYT
  • TT 27/2025/TT-BYT — ban hành 01/7/2025, hiệu lực 01/9/2025 — thuốc dược liệu, thuốc cổ truyền thuộc phạm vi BHYT
  • Dược điển VN — chuẩn chất lượng thuốc
  • QĐ 3176/QĐ-BYT — 29/10/2024 — trường MA_THUOC, TEN_THUOC trong dữ liệu BHXH
  • NĐ 102/2025/NĐ-CP — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế. Nguồn thiết kế: OHP Data Processor (Medication mapper).

Usages:

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
.. Medication 0..* Medication Definition of a Medication
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
.... identifier:drugRegistrationNumber SΣ 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value Σ 1..1 string The value that is unique
Example General: 123456
.... identifier:gtin Σ 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value Σ 1..1 string The value that is unique
Example General: 123456
... code SΣ 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.
... form S 0..1 CodeableConcept Dạng bào chế (viên nén, dung dịch, bột...)
Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication.
... amount Σ 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 Hoạt chất / dược liệu (mã hoặc tên)
..... itemCodeableConcept CodeableConcept
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Medication.identifier:drugRegistrationNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.code Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
Medication.status Base required Medication status codes 📍4.0.1 FHIR Std.
Medication.form Base example SNOMED CT Form Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Medication If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Medication If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Medication If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Medication If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Medication A resource should have narrative for robust management text.`div`.exists()
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()

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Medication 0..* Medication Definition of a Medication
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... Slices for identifier S 0..* Identifier Định danh thuốc: số đăng ký lưu hành, GTIN bao gói
Slice: Unordered, Open by value:system
.... identifier:drugRegistrationNumber S 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... system 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value 1..1 string The value that is unique
.... identifier:gtin 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value 1..1 string The value that is unique
... code S 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
... amount 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... item[x] S 1..1 CodeableConcept, Reference(Substance | Medication) Hoạt chất / dược liệu (mã hoặc tên)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Medication 0..* Medication Definition of a Medication
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier SΣ 0..* Identifier Định danh thuốc: số đăng ký lưu hành, GTIN bao gói
Slice: Unordered, Open by value:system
.... identifier:drugRegistrationNumber SΣ 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value Σ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:gtin Σ 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value Σ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... code SΣ 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.
... manufacturer Σ 0..1 Reference(Organization) Manufacturer of the item
... form S 0..1 CodeableConcept Dạng bào chế (viên nén, dung dịch, bột...)
Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication.
... amount Σ 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 Hoạt chất / dược liệu (mã hoặc tên)
..... itemCodeableConcept CodeableConcept
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Medication.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Medication.identifier:drugRegistrationNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:drugRegistrationNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Medication.code Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
Medication.status Base required Medication status codes 📍4.0.1 FHIR Std.
Medication.form Base example SNOMED CT Form Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Medication If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Medication If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Medication If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Medication If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Medication A resource should have narrative for robust management text.`div`.exists()
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: 1 element(4 nested mandatory elements)
Must-Support: 10 elements
Fixed: 2 elements

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the values of Medication.identifier

Dạng xem phần tử chính

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Medication 0..* Medication Definition of a Medication
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
.... identifier:drugRegistrationNumber SΣ 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value Σ 1..1 string The value that is unique
Example General: 123456
.... identifier:gtin Σ 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value Σ 1..1 string The value that is unique
Example General: 123456
... code SΣ 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.
... form S 0..1 CodeableConcept Dạng bào chế (viên nén, dung dịch, bột...)
Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication.
... amount Σ 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 Hoạt chất / dược liệu (mã hoặc tên)
..... itemCodeableConcept CodeableConcept
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Medication.identifier:drugRegistrationNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.code Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
Medication.status Base required Medication status codes 📍4.0.1 FHIR Std.
Medication.form Base example SNOMED CT Form Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Medication If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Medication If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Medication If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Medication If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Medication A resource should have narrative for robust management text.`div`.exists()
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()

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Medication 0..* Medication Definition of a Medication
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... Slices for identifier S 0..* Identifier Định danh thuốc: số đăng ký lưu hành, GTIN bao gói
Slice: Unordered, Open by value:system
.... identifier:drugRegistrationNumber S 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... system 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value 1..1 string The value that is unique
.... identifier:gtin 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... system 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value 1..1 string The value that is unique
... code S 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
... amount 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... item[x] S 1..1 CodeableConcept, Reference(Substance | Medication) Hoạt chất / dược liệu (mã hoặc tên)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Medication 0..* Medication Definition of a Medication
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY) — LEGACY, dùng identifier[drugRegistrationNumber] cho dữ liệu mới
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier SΣ 0..* Identifier Định danh thuốc: số đăng ký lưu hành, GTIN bao gói
Slice: Unordered, Open by value:system
.... identifier:drugRegistrationNumber SΣ 0..1 Identifier Số đăng ký lưu hành (GPLH) — 12 chữ số theo TT 12/2025/TT-BYT hoặc định dạng legacy VD-xxxxx-yy
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc
..... value Σ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:gtin Σ 0..1 Identifier GTIN bao gói (GS1) — một GTIN ứng với một quy cách đóng gói cụ thể
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: https://www.gs1.org/gtin
..... value Σ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... code SΣ 1..1 CodeableConcept Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)
Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.
... manufacturer Σ 0..1 Reference(Organization) Manufacturer of the item
... form S 0..1 CodeableConcept Dạng bào chế (viên nén, dung dịch, bột...)
Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication.
... amount Σ 0..1 Ratio Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng
... ingredient S 0..* BackboneElement Thành phần hoạt chất / dược liệu YHCT
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 Hoạt chất / dược liệu (mã hoặc tên)
..... itemCodeableConcept CodeableConcept
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Hoạt chất chính (true) hay phụ (false)
.... strength S 0..1 Ratio Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)
... batch S 0..1 BackboneElement Lô sản xuất (truy xuất nguồn gốc, thu hồi)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber S 0..1 string Số lô (SO_LO)
.... expirationDate S 0..1 dateTime Hạn sử dụng (HAN_DUNG)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Medication.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Medication.identifier:drugRegistrationNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:drugRegistrationNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Medication.identifier:gtin.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Medication.code Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
Medication.status Base required Medication status codes 📍4.0.1 FHIR Std.
Medication.form Base example SNOMED CT Form Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Medication If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Medication If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Medication If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Medication If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Medication A resource should have narrative for robust management text.`div`.exists()
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: 1 element(4 nested mandatory elements)
Must-Support: 10 elements
Fixed: 2 elements

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the values of Medication.identifier

 

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