HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.4.0 - STU1 Draft Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.4.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Cấp phát thuốc VN Core — VN Core Medication Dispense Profile

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense Phiên bản: 0.4.0
Computable Name: VNCoreMedicationDispense

Bản quyền/Pháp lý: 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 ngày 01/07/2025; NĐ 164/2025/NĐ-CP ngày 29/06/2025; TT 13/2025/TT-BYT ngày 06/06/2025.

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 (01/7/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.

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
.. MedicationDispense C 0..* MedicationDispense Dispensing a medication to a named patient
Constraints: mdd-1
... 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:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
Binding: MedicationDispense Category Codes (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: SNOMEDCTMedicationCodes (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
... 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
... performer S 0..* BackboneElement Người hoặc đơn vị cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... 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
... 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
... 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
... quantity S 0..1 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenHandedOver S 1..1 dateTime Ngày giờ giao thuốc cho người bệnh
... dosageInstruction S 0..* Dosage Hướng dẫn dùng thuốc khi cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... route SΣ 0..1 CodeableConcept Đường dùng thuốc
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationDispense.status Base required Medication dispense status codes 📍4.0.1 FHIR Std.
MedicationDispense.category Base preferred Medication dispense category codes 📍4.0.1 FHIR Std.
MedicationDispense.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationDispense If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationDispense 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 MedicationDispense 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 MedicationDispense If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationDispense 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()
mdd-1 error MedicationDispense whenHandedOver cannot be before whenPrepared whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationDispense 0..* MedicationDispense Dispensing a medication to a named patient
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... status S 1..1 code Trạng thái cấp phát thuốc
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
... subject 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
... performer S 0..* BackboneElement Người hoặc đơn vị cấp phát
.... 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
... 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
... 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
... quantity S 0..1 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenHandedOver S 1..1 dateTime Ngày giờ giao thuốc cho người bệnh
... dosageInstruction S 0..* Dosage Hướng dẫn dùng thuốc khi cấp phát
.... route S 0..1 CodeableConcept Đường dùng thuốc
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationDispense C 0..* MedicationDispense Dispensing a medication to a named patient
Constraints: mdd-1
... 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
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages 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
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External identifier
... partOf 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: MedicationDispense Status Codes (required): A coded concept specifying the state of the dispense event.
... statusReason[x] 0..1 Why a dispense was not performed
Binding: MedicationDispense Status Reason Codes (example): A code describing why a dispense was not performed.
.... statusReasonCodeableConcept CodeableConcept
.... statusReasonReference Reference(DetectedIssue)
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
Binding: MedicationDispense Category Codes (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: SNOMEDCTMedicationCodes (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
... 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
... supportingInformation 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
.... 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
.... function 0..1 CodeableConcept Who performed the dispense and what they did
Binding: MedicationDispense Performer Function Codes (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
... 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
... 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
... type 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc.
Binding: ActPharmacySupplyType (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 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenPrepared Σ 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
... destination 0..1 Reference(Location) Where the medication was sent
... receiver 0..* Reference(Patient | Practitioner) Who collected the medication
... note 0..* Annotation Information about the dispense
... dosageInstruction 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
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence Σ 0..1 integer The order of the dosage instructions
.... text Σ 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: SNOMEDCTAdditionalDosageInstructions (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
.... timing Σ 0..1 Timing When medication should be administered
.... asNeeded[x] Σ 0..1 Take "as needed" (for x)
Binding: SNOMEDCTMedicationAsNeededReasonCodes (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.
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept Body site to administer to
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (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: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... method Σ 0..1 CodeableConcept Technique for administering medication
Binding: SNOMEDCTAdministrationMethodCodes (example): A coded concept describing the technique by which the medicine is administered.
.... doseAndRate Σ 0..* Element Amount of medication administered
..... id 0..1 string Unique id for inter-element referencing
..... extension 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: DoseAndRateType (example): The kind of dose or rate specified.
..... dose[x] Σ 0..1 Amount of medication per dose
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] Σ 0..1 Amount of medication per unit of time
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio Upper limit on medication per unit of time
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) Upper limit on medication per administration
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) Upper limit on medication per lifetime of the patient
... substitution 0..1 BackboneElement Whether a substitution was performed on the dispense
.... 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
.... wasSubstituted 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: ActSubstanceAdminSubstitutionCode (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: SubstanceAdminSubstitutionReason (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
... detectedIssue 0..* Reference(DetectedIssue) Clinical issue with action
... eventHistory 0..* Reference(Provenance) A list of relevant lifecycle events

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationDispense.language Base preferred Common Languages 📍4.0.1 FHIR Std.
MedicationDispense.status Base required Medication dispense status codes 📍4.0.1 FHIR Std.
MedicationDispense.statusReason[x] Base example Medication dispense status reason codes 📍4.0.1 FHIR Std.
MedicationDispense.category Base preferred Medication dispense category codes 📍4.0.1 FHIR Std.
MedicationDispense.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationDispense.performer.​function Base example Medication dispense performer function codes 📍4.0.1 FHIR Std.
MedicationDispense.type Base example ActPharmacySupplyType 📦3.0.0 THO v7.1
MedicationDispense.dosageInstruction.​additionalInstruction Base example SNOMED CT Additional Dosage Instructions 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​asNeeded[x] Base example SNOMED CT Medication As Needed Reason Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​site Base example SNOMED CT Anatomical Structure for Administration Site Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG
MedicationDispense.dosageInstruction.​method Base example SNOMED CT Administration Method Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​doseAndRate.type Base example DoseAndRateType 📍4.0.1 FHIR Std.
MedicationDispense.substitution.​type Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v7.1
MedicationDispense.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationDispense If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationDispense 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 MedicationDispense 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 MedicationDispense If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationDispense 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()
mdd-1 error MedicationDispense whenHandedOver cannot be before whenPrepared whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationDispense C 0..* MedicationDispense Dispensing a medication to a named patient
Constraints: mdd-1
... 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:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
Binding: MedicationDispense Category Codes (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: SNOMEDCTMedicationCodes (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
... 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
... performer S 0..* BackboneElement Người hoặc đơn vị cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... 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
... 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
... 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
... quantity S 0..1 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenHandedOver S 1..1 dateTime Ngày giờ giao thuốc cho người bệnh
... dosageInstruction S 0..* Dosage Hướng dẫn dùng thuốc khi cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... route SΣ 0..1 CodeableConcept Đường dùng thuốc
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationDispense.status Base required Medication dispense status codes 📍4.0.1 FHIR Std.
MedicationDispense.category Base preferred Medication dispense category codes 📍4.0.1 FHIR Std.
MedicationDispense.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationDispense If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationDispense 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 MedicationDispense 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 MedicationDispense If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationDispense 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()
mdd-1 error MedicationDispense whenHandedOver cannot be before whenPrepared whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationDispense 0..* MedicationDispense Dispensing a medication to a named patient
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... status S 1..1 code Trạng thái cấp phát thuốc
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
... subject 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
... performer S 0..* BackboneElement Người hoặc đơn vị cấp phát
.... 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
... 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
... 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
... quantity S 0..1 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenHandedOver S 1..1 dateTime Ngày giờ giao thuốc cho người bệnh
... dosageInstruction S 0..* Dosage Hướng dẫn dùng thuốc khi cấp phát
.... route S 0..1 CodeableConcept Đường dùng thuốc
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationDispense C 0..* MedicationDispense Dispensing a medication to a named patient
Constraints: mdd-1
... 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
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages 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
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo S 0..1 (Complex) Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber S 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External identifier
... partOf 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: MedicationDispense Status Codes (required): A coded concept specifying the state of the dispense event.
... statusReason[x] 0..1 Why a dispense was not performed
Binding: MedicationDispense Status Reason Codes (example): A code describing why a dispense was not performed.
.... statusReasonCodeableConcept CodeableConcept
.... statusReasonReference Reference(DetectedIssue)
... category S 0..1 CodeableConcept Bối cảnh cấp phát: inpatient, outpatient, community, discharge
Binding: MedicationDispense Category Codes (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: SNOMEDCTMedicationCodes (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
... 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
... supportingInformation 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
.... 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
.... function 0..1 CodeableConcept Who performed the dispense and what they did
Binding: MedicationDispense Performer Function Codes (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
... 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
... 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
... type 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc.
Binding: ActPharmacySupplyType (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 SimpleQuantity(4.0.1) Số lượng thuốc đã cấp
... daysSupply S 0..1 SimpleQuantity(4.0.1) Số ngày thuốc đã cấp
... whenPrepared Σ 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
... destination 0..1 Reference(Location) Where the medication was sent
... receiver 0..* Reference(Patient | Practitioner) Who collected the medication
... note 0..* Annotation Information about the dispense
... dosageInstruction 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
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence Σ 0..1 integer The order of the dosage instructions
.... text Σ 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: SNOMEDCTAdditionalDosageInstructions (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
.... timing Σ 0..1 Timing When medication should be administered
.... asNeeded[x] Σ 0..1 Take "as needed" (for x)
Binding: SNOMEDCTMedicationAsNeededReasonCodes (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.
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept Body site to administer to
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (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: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... method Σ 0..1 CodeableConcept Technique for administering medication
Binding: SNOMEDCTAdministrationMethodCodes (example): A coded concept describing the technique by which the medicine is administered.
.... doseAndRate Σ 0..* Element Amount of medication administered
..... id 0..1 string Unique id for inter-element referencing
..... extension 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: DoseAndRateType (example): The kind of dose or rate specified.
..... dose[x] Σ 0..1 Amount of medication per dose
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] Σ 0..1 Amount of medication per unit of time
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio Upper limit on medication per unit of time
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) Upper limit on medication per administration
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) Upper limit on medication per lifetime of the patient
... substitution 0..1 BackboneElement Whether a substitution was performed on the dispense
.... 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
.... wasSubstituted 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: ActSubstanceAdminSubstitutionCode (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: SubstanceAdminSubstitutionReason (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
... detectedIssue 0..* Reference(DetectedIssue) Clinical issue with action
... eventHistory 0..* Reference(Provenance) A list of relevant lifecycle events

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationDispense.language Base preferred Common Languages 📍4.0.1 FHIR Std.
MedicationDispense.status Base required Medication dispense status codes 📍4.0.1 FHIR Std.
MedicationDispense.statusReason[x] Base example Medication dispense status reason codes 📍4.0.1 FHIR Std.
MedicationDispense.category Base preferred Medication dispense category codes 📍4.0.1 FHIR Std.
MedicationDispense.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationDispense.performer.​function Base example Medication dispense performer function codes 📍4.0.1 FHIR Std.
MedicationDispense.type Base example ActPharmacySupplyType 📦3.0.0 THO v7.1
MedicationDispense.dosageInstruction.​additionalInstruction Base example SNOMED CT Additional Dosage Instructions 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​asNeeded[x] Base example SNOMED CT Medication As Needed Reason Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​site Base example SNOMED CT Anatomical Structure for Administration Site Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.4.0 This IG
MedicationDispense.dosageInstruction.​method Base example SNOMED CT Administration Method Codes 📍4.0.1 FHIR Std.
MedicationDispense.dosageInstruction.​doseAndRate.type Base example DoseAndRateType 📍4.0.1 FHIR Std.
MedicationDispense.substitution.​type Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v7.1
MedicationDispense.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationDispense If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationDispense 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 MedicationDispense 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 MedicationDispense If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationDispense 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()
mdd-1 error MedicationDispense whenHandedOver cannot be before whenPrepared whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared

 

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