VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft Viet Nam flag

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Đơn thuốc VN Core — VN Core MedicationRequest Profile

Official URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request Version: 0.1.0
Draft as of 2026-03-21 Computable Name: VNCoreMedicationRequest

Profile MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription). Hỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH), Luật Dược 2016 Điều 74 (kê đơn thuốc). / VN Core MedicationRequest profile for electronic prescriptions (ePrescription). Supports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim. Per TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field), Pharmaceutical Law 2016 Art.74 (prescription rules).

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... 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 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
... category S 0..* CodeableConcept Loại đơn thuốc: ngoại trú (outpatient), nội trú (inpatient), cấp cứu
Binding: medicationRequest Category Codes (example): A coded concept identifying the category of medication request. For example, where the medication is to be consumed or administered, or the type of medication treatment.
... doNotPerform ?!Σ 0..1 boolean True if request is prohibiting action
... medication[x] SΣ 1..1 Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying substance or product that can be ordered.
.... medicationCodeableConcept CodeableConcept
.... medicationReference Reference(Medication)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester SΣ 0..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) Bác sĩ kê đơn
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... text SΣ 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... timing SΣ 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... route SΣ 0..1 CodeableConcept Đường dùng (uống, tiêm, bôi...) — 55 mã per Dược điển VN
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... doseAndRate SΣ 0..* Element Liều lượng và tốc độ
... dispenseRequest S 0..1 BackboneElement Yêu cầu cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
... substitution 0..1 BackboneElement Thay thế thuốc
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... allowed[x] 1..1 Whether substitution is allowed or not
Binding: ActSubstanceAdminSubstitutionCode (example): Identifies the type of substitution allowed.
..... allowedBoolean boolean
..... allowedCodeableConcept CodeableConcept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationRequest.status Base required Medicationrequest status 📍4.0.1 FHIR Std.
MedicationRequest.intent Base required Medication request intent 📍4.0.1 FHIR Std.
MedicationRequest.category Base example Medication request category codes 📍4.0.1 FHIR Std.
MedicationRequest.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG
MedicationRequest.substitution.​allowed[x] Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v6.2

Constraints

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

This structure is derived from MedicationRequest

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... status S 1..1 code Trạng thái đơn thuốc
... intent S 1..1 code Ý định: order (kê đơn) | proposal | plan
... medication[x] S 1..1 CodeableConcept, Reference(Medication) Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
... subject S 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... authoredOn S 1..1 dateTime Ngày kê đơn
... requester S 0..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) Bác sĩ kê đơn
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... text S 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... timing S 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... route S 0..1 CodeableConcept Đường dùng (uống, tiêm, bôi...) — 55 mã per Dược điển VN
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... doseAndRate S 0..* Element Liều lượng và tốc độ
... dispenseRequest S 0..1 BackboneElement Yêu cầu cấp phát
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
... substitution 0..1 BackboneElement Thay thế thuốc

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... 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 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External ids for this request
... status ?!SΣ 1..1 code Trạng thái đơn thuốc
Binding: medicationrequest Status (required): A coded concept specifying the state of the prescribing event. Describes the lifecycle of the prescription.
... statusReason 0..1 CodeableConcept Reason for current status
Binding: medicationRequest Status Reason Codes (example): Identifies the reasons for a given status.
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
... category S 0..* CodeableConcept Loại đơn thuốc: ngoại trú (outpatient), nội trú (inpatient), cấp cứu
Binding: medicationRequest Category Codes (example): A coded concept identifying the category of medication request. For example, where the medication is to be consumed or administered, or the type of medication treatment.
... priority Σ 0..1 code routine | urgent | asap | stat
Binding: RequestPriority (required): Identifies the level of importance to be assigned to actioning the request.
... doNotPerform ?!Σ 0..1 boolean True if request is prohibiting action
... reported[x] Σ 0..1 Reported rather than primary record
.... reportedBoolean boolean
.... reportedReference Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)
... medication[x] SΣ 1..1 Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying substance or product that can be ordered.
.... medicationCodeableConcept CodeableConcept
.... medicationReference Reference(Medication)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... supportingInformation 0..* Reference(Resource) Information to support ordering of the medication
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester SΣ 0..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) Bác sĩ kê đơn
... performer 0..1 Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam) Intended performer of administration
... performerType Σ 0..1 CodeableConcept Desired kind of performer of the medication administration
Binding: ProcedurePerformerRoleCodes (example): Identifies the type of individual that is desired to administer the medication.
... recorder 0..1 Reference(Practitioner | PractitionerRole) Person who entered the request
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... reasonReference 0..* Reference(Condition | Observation) Condition or observation that supports why the prescription is being written
... instantiatesCanonical Σ 0..* canonical() Instantiates FHIR protocol or definition
... instantiatesUri Σ 0..* uri Instantiates external protocol or definition
... basedOn Σ 0..* Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation) What request fulfills
... groupIdentifier Σ 0..1 Identifier Composite request this is part of
... courseOfTherapyType 0..1 CodeableConcept Overall pattern of medication administration
Binding: medicationRequest Course of Therapy Codes (example): Identifies the overall pattern of medication administratio.
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... 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 SΣ 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... 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 SΣ 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... 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 (uống, tiêm, bôi...) — 55 mã per Dược điển VN
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 SΣ 0..* Element Liều lượng và tốc độ
..... 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
... dispenseRequest S 0..1 BackboneElement Yêu cầu 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
.... initialFill 0..1 BackboneElement First fill details
..... 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
..... quantity 0..1 SimpleQuantity(4.0.1) First fill quantity
..... duration 0..1 Duration First fill duration
.... dispenseInterval 0..1 Duration Minimum period of time between dispenses
.... validityPeriod 0..1 Period Time period supply is authorized for
.... numberOfRepeatsAllowed 0..1 unsignedInt Number of refills authorized
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
.... performer 0..1 Reference(Organization) Intended dispenser
... substitution 0..1 BackboneElement Thay thế thuốc
.... 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
.... allowed[x] 1..1 Whether substitution is allowed or not
Binding: ActSubstanceAdminSubstitutionCode (example): Identifies the type of substitution allowed.
..... allowedBoolean boolean
..... allowedCodeableConcept CodeableConcept
.... reason 0..1 CodeableConcept Why should (not) substitution be made
Binding: SubstanceAdminSubstitutionReason (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed.
... priorPrescription 0..1 Reference(MedicationRequest) An order/prescription that is being replaced
... detectedIssue 0..* Reference(DetectedIssue) Clinical Issue with action
... eventHistory 0..* Reference(Provenance) A list of events of interest in the lifecycle

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationRequest.language Base preferred Common Languages 📍4.0.1 FHIR Std.
MedicationRequest.status Base required Medicationrequest status 📍4.0.1 FHIR Std.
MedicationRequest.statusReason Base example Medication request status reason codes 📍4.0.1 FHIR Std.
MedicationRequest.intent Base required Medication request intent 📍4.0.1 FHIR Std.
MedicationRequest.category Base example Medication request category codes 📍4.0.1 FHIR Std.
MedicationRequest.priority Base required Request priority 📍4.0.1 FHIR Std.
MedicationRequest.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationRequest.performerType Base example Procedure Performer Role Codes 📍4.0.1 FHIR Std.
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.courseOfTherapyType Base example Medication request course of therapy codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​additionalInstruction Base example SNOMED CT Additional Dosage Instructions 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​asNeeded[x] Base example SNOMED CT Medication As Needed Reason Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​site Base example SNOMED CT Anatomical Structure for Administration Site Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​method Base example SNOMED CT Administration Method Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​doseAndRate.type Base example DoseAndRateType 📍4.0.1 FHIR Std.
MedicationRequest.substitution.​allowed[x] Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v6.2
MedicationRequest.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v6.2

Constraints

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

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... 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 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
... category S 0..* CodeableConcept Loại đơn thuốc: ngoại trú (outpatient), nội trú (inpatient), cấp cứu
Binding: medicationRequest Category Codes (example): A coded concept identifying the category of medication request. For example, where the medication is to be consumed or administered, or the type of medication treatment.
... doNotPerform ?!Σ 0..1 boolean True if request is prohibiting action
... medication[x] SΣ 1..1 Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying substance or product that can be ordered.
.... medicationCodeableConcept CodeableConcept
.... medicationReference Reference(Medication)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester SΣ 0..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) Bác sĩ kê đơn
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... text SΣ 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... timing SΣ 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... route SΣ 0..1 CodeableConcept Đường dùng (uống, tiêm, bôi...) — 55 mã per Dược điển VN
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... doseAndRate SΣ 0..* Element Liều lượng và tốc độ
... dispenseRequest S 0..1 BackboneElement Yêu cầu cấp phát
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
... substitution 0..1 BackboneElement Thay thế thuốc
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... allowed[x] 1..1 Whether substitution is allowed or not
Binding: ActSubstanceAdminSubstitutionCode (example): Identifies the type of substitution allowed.
..... allowedBoolean boolean
..... allowedCodeableConcept CodeableConcept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationRequest.status Base required Medicationrequest status 📍4.0.1 FHIR Std.
MedicationRequest.intent Base required Medication request intent 📍4.0.1 FHIR Std.
MedicationRequest.category Base example Medication request category codes 📍4.0.1 FHIR Std.
MedicationRequest.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG
MedicationRequest.substitution.​allowed[x] Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v6.2

Constraints

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

Differential View

This structure is derived from MedicationRequest

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceCostInfo 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... status S 1..1 code Trạng thái đơn thuốc
... intent S 1..1 code Ý định: order (kê đơn) | proposal | plan
... medication[x] S 1..1 CodeableConcept, Reference(Medication) Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
... subject S 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... authoredOn S 1..1 dateTime Ngày kê đơn
... requester S 0..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) Bác sĩ kê đơn
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... text S 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... timing S 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... route S 0..1 CodeableConcept Đường dùng (uống, tiêm, bôi...) — 55 mã per Dược điển VN
Binding: Đường dùng thuốc — Vietnam Medication Route ValueSet (extensible)
.... doseAndRate S 0..* Element Liều lượng và tốc độ
... dispenseRequest S 0..1 BackboneElement Yêu cầu cấp phát
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
... substitution 0..1 BackboneElement Thay thế thuốc

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* MedicationRequest Ordering of medication for patient or group
... 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 0..1 (Complex) Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info
.... extension:registrationNumber 0..1 string Số đăng ký thuốc (SO_DANG_KY)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-registration-number
.... extension:orderDate 0..1 dateTime Ngày y lệnh (NGAY_YL)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External ids for this request
... status ?!SΣ 1..1 code Trạng thái đơn thuốc
Binding: medicationrequest Status (required): A coded concept specifying the state of the prescribing event. Describes the lifecycle of the prescription.
... statusReason 0..1 CodeableConcept Reason for current status
Binding: medicationRequest Status Reason Codes (example): Identifies the reasons for a given status.
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
... category S 0..* CodeableConcept Loại đơn thuốc: ngoại trú (outpatient), nội trú (inpatient), cấp cứu
Binding: medicationRequest Category Codes (example): A coded concept identifying the category of medication request. For example, where the medication is to be consumed or administered, or the type of medication treatment.
... priority Σ 0..1 code routine | urgent | asap | stat
Binding: RequestPriority (required): Identifies the level of importance to be assigned to actioning the request.
... doNotPerform ?!Σ 0..1 boolean True if request is prohibiting action
... reported[x] Σ 0..1 Reported rather than primary record
.... reportedBoolean boolean
.... reportedReference Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)
... medication[x] SΣ 1..1 Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying substance or product that can be ordered.
.... medicationCodeableConcept CodeableConcept
.... medicationReference Reference(Medication)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Bệnh nhân được kê đơn
... encounter 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám liên quan
... supportingInformation 0..* Reference(Resource) Information to support ordering of the medication
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester SΣ 0..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) Bác sĩ kê đơn
... performer 0..1 Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam) Intended performer of administration
... performerType Σ 0..1 CodeableConcept Desired kind of performer of the medication administration
Binding: ProcedurePerformerRoleCodes (example): Identifies the type of individual that is desired to administer the medication.
... recorder 0..1 Reference(Practitioner | PractitionerRole) Person who entered the request
... reasonCode 0..* CodeableConcept Lý do kê đơn (mã ICD-10)
Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible)
... reasonReference 0..* Reference(Condition | Observation) Condition or observation that supports why the prescription is being written
... instantiatesCanonical Σ 0..* canonical() Instantiates FHIR protocol or definition
... instantiatesUri Σ 0..* uri Instantiates external protocol or definition
... basedOn Σ 0..* Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation) What request fulfills
... groupIdentifier Σ 0..1 Identifier Composite request this is part of
... courseOfTherapyType 0..1 CodeableConcept Overall pattern of medication administration
Binding: medicationRequest Course of Therapy Codes (example): Identifies the overall pattern of medication administratio.
... insurance 0..* Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) Thẻ BHYT (nếu đơn BHYT)
... note 0..* Annotation Ghi chú bổ sung
... dosageInstruction S 1..* Dosage Hướng dẫn liều dùng
.... 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 SΣ 0..1 string Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)
.... 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 SΣ 0..1 Timing Lịch dùng thuốc (tần suất, thời điểm)
.... 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 (uống, tiêm, bôi...) — 55 mã per Dược điển VN
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 SΣ 0..* Element Liều lượng và tốc độ
..... 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
... dispenseRequest S 0..1 BackboneElement Yêu cầu 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
.... initialFill 0..1 BackboneElement First fill details
..... 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
..... quantity 0..1 SimpleQuantity(4.0.1) First fill quantity
..... duration 0..1 Duration First fill duration
.... dispenseInterval 0..1 Duration Minimum period of time between dispenses
.... validityPeriod 0..1 Period Time period supply is authorized for
.... numberOfRepeatsAllowed 0..1 unsignedInt Number of refills authorized
.... quantity S 0..1 SimpleQuantity(4.0.1) Tổng số lượng cấp phát
.... expectedSupplyDuration 0..1 Duration Số ngày cung cấp
.... performer 0..1 Reference(Organization) Intended dispenser
... substitution 0..1 BackboneElement Thay thế thuốc
.... 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
.... allowed[x] 1..1 Whether substitution is allowed or not
Binding: ActSubstanceAdminSubstitutionCode (example): Identifies the type of substitution allowed.
..... allowedBoolean boolean
..... allowedCodeableConcept CodeableConcept
.... reason 0..1 CodeableConcept Why should (not) substitution be made
Binding: SubstanceAdminSubstitutionReason (example): A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed.
... priorPrescription 0..1 Reference(MedicationRequest) An order/prescription that is being replaced
... detectedIssue 0..* Reference(DetectedIssue) Clinical Issue with action
... eventHistory 0..* Reference(Provenance) A list of events of interest in the lifecycle

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationRequest.language Base preferred Common Languages 📍4.0.1 FHIR Std.
MedicationRequest.status Base required Medicationrequest status 📍4.0.1 FHIR Std.
MedicationRequest.statusReason Base example Medication request status reason codes 📍4.0.1 FHIR Std.
MedicationRequest.intent Base required Medication request intent 📍4.0.1 FHIR Std.
MedicationRequest.category Base example Medication request category codes 📍4.0.1 FHIR Std.
MedicationRequest.priority Base required Request priority 📍4.0.1 FHIR Std.
MedicationRequest.medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationRequest.performerType Base example Procedure Performer Role Codes 📍4.0.1 FHIR Std.
MedicationRequest.reasonCode Base extensible Mã chẩn đoán — VN Core Condition Code ValueSet 📦0.1.0 This IG
MedicationRequest.courseOfTherapyType Base example Medication request course of therapy codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​additionalInstruction Base example SNOMED CT Additional Dosage Instructions 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​asNeeded[x] Base example SNOMED CT Medication As Needed Reason Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​site Base example SNOMED CT Anatomical Structure for Administration Site Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.1.0 This IG
MedicationRequest.dosageInstruction.​method Base example SNOMED CT Administration Method Codes 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​doseAndRate.type Base example DoseAndRateType 📍4.0.1 FHIR Std.
MedicationRequest.substitution.​allowed[x] Base example ActSubstanceAdminSubstitutionCode 📦3.0.0 THO v6.2
MedicationRequest.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v6.2

Constraints

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

 

Other representations of profile: CSV, Excel, Schematron