Profile Comparison between http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense vs http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense

Messages

Metadata

Name	Value		Comments
abstract	false
baseDefinition	http://hl7.org/fhir/StructureDefinition/MedicationDispense
copyright	Căn cứ pháp lý Việt Nam: Luật Dược 105/2016/QH13 ngày 06/04/2016 Điều 74; Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36; NĐ 163/2025/NĐ-CP ngày 29/06/2025, hiệu lực 01/07/2025 và thay thế NĐ 54/2017/NĐ-CP theo Điều 129; TT 26/2025/TT-BYT; TT 20/2022/TT-BYT; TT 37/2024/TT-BYT; TT 27/2025/TT-BYT; QĐ 3176/QĐ-BYT ngày 29/10/2024; QĐ 697/QĐ-BYT ngày 19/03/2026; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025; NĐ 164/2025/NĐ-CP ngày 29/06/2025; TT 13/2025/TT-BYT ngày 06/06/2025.
date	2026-04-14	2026-07-30	Values Differ
description	Profile MedicationDispense cho Việt Nam. Dùng để ghi nhận cấp phát thuốc trong chu trình đơn thuốc điện tử, điều trị nội trú/ngoại trú, bệnh án điện tử, và dữ liệu phục vụ thanh toán BHYT. Căn cứ pháp lý hiện hành: - **Luật Dược 105/2016/QH13 ngày 06/4/2016 Điều 74** — nguyên tắc kê đơn/cấp phát thuốc - **Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36** — sửa đổi Điều 74 Luật Dược, giao Bộ Y tế quy định chi tiết đơn thuốc, ứng dụng CNTT, liên thông CSDL quốc gia về y tế - **NĐ 163/2025/NĐ-CP ngày 29/6/2025** — hướng dẫn Luật Dược, thay thế hoàn toàn NĐ 54/2017/NĐ-CP từ 01/7/2025 theo Điều 129 - **TT 26/2025/TT-BYT** — kê đơn thuốc ngoại trú: Điều 5 về kê đơn ngoại trú và sau điều trị nội trú; Điều 10 về giá trị pháp lý của đơn thuốc điện tử; Điều 12 về liên thông Hệ thống đơn thuốc quốc gia và lĩnh thuốc trong 05 ngày từ ngày kê - **TT 20/2022/TT-BYT + TT 37/2024/TT-BYT** — danh mục, tỷ lệ và điều kiện thanh toán thuốc hóa dược, sinh phẩm, thuốc phóng xạ và chất đánh dấu thuộc phạm vi BHYT - **TT 27/2025/TT-BYT** — thuốc y học cổ truyền thuộc phạm vi BHYT, hiệu lực 01/9/2025 - **QĐ 3176/QĐ-BYT (29/10/2024)** — XML3: MA_THUOC, SO_DANG_KY, NGAY_YL - **QĐ 697/QĐ-BYT (19/3/2026)** — mẫu bảng kê chi phí KCB, danh mục chi phí thuốc là 1/12 nhóm - **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — thanh toán BHYT thuốc - **NĐ 164/2025/NĐ-CP (29/6/2025)** — giao dịch điện tử/API Cổng BHXH - **TT 13/2025/TT-BYT (06/6/2025)** — bệnh án điện tử ghi nhận thông tin cấp phát thuốc. Ghi chú: NĐ 54/2017/NĐ-CP chỉ là legacy reference và không được dùng làm current basis sau 01/7/2025. / VN Core MedicationDispense profile for recording medication dispensing events in Vietnamese EMR, ePrescription, inpatient/outpatient, and BHYT reimbursement workflows.
experimental
fhirVersion	4.0.1
jurisdiction
jurisdiction[0]	urn:iso:std:iso:3166#VN
kind	resource
name	VNCoreMedicationDispense
publisher	Omi HealthTech / VN Core FHIR Community Initiative
purpose
status	draft
title	Cấp phát thuốc VN Core — VN Core Medication Dispense Profile
type	MedicationDispense
url	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense
version	0.8.0	0.9.0	Values Differ

Structure

Name	L Flags	L Card.	L Type	L Description & Constraints	R Flags	R Card.	R Type	R Description & Constraints	Comments
MedicationDispense	C	0..*	MedicationDispense	Dispensing a medication to a named patient	C	0..*	MedicationDispense	Dispensing a medication to a named patient
id	Σ	0..1	id	Logical id of this artifact	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding
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		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		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	External identifier		0..*	Identifier	External identifier
partOf		0..*	Reference(Procedure)	Event that dispense is part of		0..*	Reference(Procedure)	Event that dispense is part of
status	?!SΣ	1..1	code	Trạng thái cấp phát thuốc Binding: ?? (required): A coded concept specifying the state of the dispense event.	?!SΣ	1..1	code	Trạng thái cấp phát thuốc Binding: ?? (required): A coded concept specifying the state of the dispense event.
statusReason[x]		0..1	CodeableConcept, Reference(DetectedIssue)	Why a dispense was not performed Binding: ?? (example): A code describing why a dispense was not performed.		0..1	CodeableConcept, Reference(DetectedIssue)	Why a dispense was not performed Binding: ?? (example): A code describing why a dispense was not performed.
category	S	0..1	CodeableConcept	Bối cảnh cấp phát: inpatient, outpatient, community, discharge Binding: ?? (preferred): A code describing where the dispensed medication is expected to be consumed or administered.	S	0..1	CodeableConcept	Bối cảnh cấp phát: inpatient, outpatient, community, discharge Binding: ?? (preferred): A code describing where the dispensed medication is expected to be consumed or administered.
medication[x]	SΣ	1..1	CodeableConcept	Thuốc được cấp phát Binding: ?? (example): A coded concept identifying which substance or product can be dispensed.	SΣ	1..1	CodeableConcept, Reference(Thuốc VN Core — VN Core Medication Profile)	Thuốc được cấp phát — mã/tên thuốc, hoặc tham chiếu VNCoreMedication khi cần lô/hạn dùng/số đăng ký Binding: ?? (example): A coded concept identifying which substance or product can be dispensed.
subject	SΣ	1..1	Reference(http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)	Bệnh nhân nhận thuốc	SΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân nhận thuốc	Type Mismatch: Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient]]) vs Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient]])
context	S	0..1	Reference(http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter)	Lượt khám/điều trị liên quan	S	0..1	Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile)	Lượt khám/điều trị liên quan	Type Mismatch: Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter]]) vs Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter]])
supportingInformation		0..*	Reference(Resource)	Information that supports the dispensing of the medication		0..*	Reference(Resource)	Information that supports the dispensing of the medication
performer	S	0..*	BackboneElement	Người hoặc đơn vị cấp phát	S	0..*	BackboneElement	Người hoặc đơn vị cấp phát
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
function		0..1	CodeableConcept	Who performed the dispense and what they did Binding: ?? (example): A code describing the role an individual played in dispensing a medication.		0..1	CodeableConcept	Who performed the dispense and what they did Binding: ?? (example): A code describing the role an individual played in dispensing a medication.
actor	S	1..1	Reference(http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)	Dược sĩ, vai trò hành nghề, hoặc khoa Dược/cơ sở cấp phát	S	1..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile)	Dược sĩ, vai trò hành nghề, hoặc khoa Dược/cơ sở cấp phát	Type Mismatch: Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner], CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role], CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization]]) vs Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner], CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role], CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization]])
location	S	0..1	Reference(http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location)	Địa điểm cấp phát thuốc	S	0..1	Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile)	Địa điểm cấp phát thuốc	Type Mismatch: Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location]]) vs Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location]])
authorizingPrescription	S	0..*	Reference(http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request)	Đơn thuốc/y lệnh cho lần cấp phát	S	0..*	Reference(Đơn thuốc VN Core — VN Core MedicationRequest Profile)	Đơn thuốc/y lệnh cho lần cấp phát	Type Mismatch: Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request]]) vs Reference([CanonicalType[http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request]])
type		0..1	CodeableConcept	Trial fill, partial fill, emergency fill, etc. Binding: ?? (example): Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc.		0..1	CodeableConcept	Trial fill, partial fill, emergency fill, etc. Binding: ?? (example): Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc.
quantity	S	0..1	??	Số lượng thuốc đã cấp	S	0..1	??	Số lượng thuốc đã cấp
daysSupply	S	0..1	??	Số ngày thuốc đã cấp	S	0..1	??	Số ngày thuốc đã cấp
whenPrepared	Σ	0..1	dateTime	When product was packaged and reviewed	Σ	0..1	dateTime	When product was packaged and reviewed
whenHandedOver	S	1..1	dateTime	Ngày giờ giao thuốc cho người bệnh	S	1..1	dateTime	Ngày giờ giao thuốc cho người bệnh
destination		0..1	Reference(Location)	Where the medication was sent		0..1	Reference(Location)	Where the medication was sent
receiver		0..*	Reference(Patient | Practitioner)	Who collected the medication		0..*	Reference(Patient | Practitioner)	Who collected the medication
note		0..*	Annotation	Information about the dispense		0..*	Annotation	Information about the dispense
dosageInstruction	S	0..*	Dosage	Hướng dẫn dùng thuốc khi cấp phát	S	0..*	Dosage	Hướng dẫn dùng thuốc khi cấp phát
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
sequence	Σ	0..1	integer	The order of the dosage instructions	Σ	0..1	integer	The order of the dosage instructions
text	Σ	0..1	string	Free text dosage instructions e.g. SIG	Σ	0..1	string	Free text dosage instructions e.g. SIG
additionalInstruction	Σ	0..*	CodeableConcept	Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness" Binding: ?? (example): A coded concept identifying additional instructions such as "take with water" or "avoid operating heavy machinery".	Σ	0..*	CodeableConcept	Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness" Binding: ?? (example): A coded concept identifying additional instructions such as "take with water" or "avoid operating heavy machinery".
patientInstruction	Σ	0..1	string	Patient or consumer oriented instructions	Σ	0..1	string	Patient or consumer oriented instructions
timing	Σ	0..1	Timing	When medication should be administered	Σ	0..1	Timing	When medication should be administered
asNeeded[x]	Σ	0..1	boolean, CodeableConcept	Take "as needed" (for x) Binding: ?? (example): A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc.	Σ	0..1	boolean, CodeableConcept	Take "as needed" (for x) Binding: ?? (example): A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc.
site	Σ	0..1	CodeableConcept	Body site to administer to Binding: ?? (example): A coded concept describing the site location the medicine enters into or onto the body.	Σ	0..1	CodeableConcept	Body site to administer to Binding: ?? (example): A coded concept describing the site location the medicine enters into or onto the body.
route	SΣ	0..1	CodeableConcept	Đường dùng thuốc Binding: ?? (extensible)	SΣ	0..1	CodeableConcept	Đường dùng thuốc Binding: ?? (extensible)
method	Σ	0..1	CodeableConcept	Technique for administering medication Binding: ?? (example): A coded concept describing the technique by which the medicine is administered.	Σ	0..1	CodeableConcept	Technique for administering medication Binding: ?? (example): A coded concept describing the technique by which the medicine is administered.
doseAndRate	Σ	0..*	Element	Amount of medication administered	Σ	0..*	Element	Amount of medication administered
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
type	Σ	0..1	CodeableConcept	The kind of dose or rate specified Binding: ?? (example): The kind of dose or rate specified.	Σ	0..1	CodeableConcept	The kind of dose or rate specified Binding: ?? (example): The kind of dose or rate specified.
dose[x]	Σ	0..1	Range, ??	Amount of medication per dose	Σ	0..1	Range, ??	Amount of medication per dose
rate[x]	Σ	0..1	Ratio, Range, ??	Amount of medication per unit of time	Σ	0..1	Ratio, Range, ??	Amount of medication per unit of time
maxDosePerPeriod	Σ	0..1	Ratio	Upper limit on medication per unit of time	Σ	0..1	Ratio	Upper limit on medication per unit of time
maxDosePerAdministration	Σ	0..1	??	Upper limit on medication per administration	Σ	0..1	??	Upper limit on medication per administration
maxDosePerLifetime	Σ	0..1	??	Upper limit on medication per lifetime of the patient	Σ	0..1	??	Upper limit on medication per lifetime of the patient
substitution		0..1	BackboneElement	Whether a substitution was performed on the dispense		0..1	BackboneElement	Whether a substitution was performed on the dispense
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
wasSubstituted		1..1	boolean	Whether a substitution was or was not performed on the dispense		1..1	boolean	Whether a substitution was or was not performed on the dispense
type		0..1	CodeableConcept	Code signifying whether a different drug was dispensed from what was prescribed Binding: ?? (example): A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription.		0..1	CodeableConcept	Code signifying whether a different drug was dispensed from what was prescribed Binding: ?? (example): A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription.
reason		0..*	CodeableConcept	Why was substitution made Binding: ?? (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed.		0..*	CodeableConcept	Why was substitution made Binding: ?? (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed.
responsibleParty		0..*	Reference(Practitioner | PractitionerRole)	Who is responsible for the substitution		0..*	Reference(Practitioner | PractitionerRole)	Who is responsible for the substitution
detectedIssue		0..*	Reference(DetectedIssue)	Clinical issue with action		0..*	Reference(DetectedIssue)	Clinical issue with action
eventHistory		0..*	Reference(Provenance)	A list of relevant lifecycle events		0..*	Reference(Provenance)	A list of relevant lifecycle events
Documentation for this format