abstractbaseDefinitioncopyrightdatedescriptionexperimentalfhirVersionjurisdiction
jurisdiction[0]kindnamepublisherpurposestatustitletypeurlversion- Values Differ
| Left: | Cấp phát thuốc VN Core — VN Core Medication Dispense Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense) |
| Right: | Cấp phát thuốc VN Core — VN Core Medication Dispense Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense) |
| Error | StructureDefinition.version | Values for version differ: '0.5.0' vs '0.5.1' |
| 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 | ||
| 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.5.0 | 0.5.1 |
|
| 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.
| 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| |||||||||||
| 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 | Thuốc được cấp phát Binding: ?? (example): A coded concept identifying which substance or product can be dispensed. | |||||||||
| subject | SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | 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 | |||||||||
| context | 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 | 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 | |||||||||
| 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(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 | 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 | |||||||||
| location | 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 | 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 | |||||||||
| authorizingPrescription | 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 | 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 | 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 | |||||||||||||||||