HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Đơn thuốc ngoại trú VN Core — VN Core Outpatient Prescription Profile

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

Profile cho đơn thuốc hóa dược, sinh phẩm kê trong điều trị ngoại trú và liên thông Hệ thống đơn thuốc quốc gia, theo TT 26/2025/TT-BYT (ban hành 30/06/2025, hiệu lực 01/07/2025). Khác biệt so với profile nền VNCoreMedicationRequest: mã đơn thuốc quốc gia là BẮT BUỘC và có ràng buộc định dạng; intent cố định order; category giới hạn ở bối cảnh ngoại trú hoặc ra viện; đơn phải đã phát hành (không dùng cho bản nháp). Đơn thuốc cổ truyền và thuốc dược liệu dùng profile riêng VNCoreYHCTOutpatientPrescription theo TT 55/2025/TT-BYT. / Outpatient prescription profile per Circular 26/2025/TT-BYT: the national prescription code is mandatory and format-constrained, intent is fixed to order, and the category is limited to outpatient or discharge contexts.

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
.. MedicationRequest 0..* VNCoreMedicationRequest Ordering of medication for patient or group
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... 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-reg-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
.... extension:paymentSource 0..1 CodeableConcept Nguồn chi trả cho dòng thuốc (NGUON_CTRA)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source
Binding: Nguồn chi trả — Vietnam Payment Source ValueSet (extensible)
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣC 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.
Constraints: vn-rx-outpatient-issued-only
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
Fixed Value: order
... category SC 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
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.
Constraints: vn-rx-outpatient-category
... 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
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester 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) Người kê đơn — bắt buộc theo TT 26/2025/TT-BYT
... groupIdentifier SΣC 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value Σ 1..1 string The value that is unique
Example General: 123456
... 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...) — 56 mã theo 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

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.groupIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.9.0 This IG

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()
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* VNCoreMedicationRequest Ordering of medication for patient or group
... status C 1..1 code Trạng thái đơn thuốc
Constraints: vn-rx-outpatient-issued-only
... intent 1..1 code Ý định: order (kê đơn) | proposal | plan
Fixed Value: order
... category C 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
Constraints: vn-rx-outpatient-category
... groupIdentifier C 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... system 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value 1..1 string The value that is unique

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* VNCoreMedicationRequest 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-reg-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
.... extension:paymentSource 0..1 CodeableConcept Nguồn chi trả cho dòng thuốc (NGUON_CTRA)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source
Binding: Nguồn chi trả — Vietnam Payment Source ValueSet (extensible)
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier S 0..* Identifier Mã dòng thuốc trong đơn (mã nội bộ của cơ sở kê đơn) — KHÔNG dùng cho mã đơn quốc gia
... status ?!SΣC 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.
Constraints: vn-rx-outpatient-issued-only
... 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.
Fixed Value: order
... category SC 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
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.
Constraints: vn-rx-outpatient-category
... 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Σ 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) Người kê đơn — bắt buộc theo TT 26/2025/TT-BYT
... 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 SΣC 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value Σ 1..1 string The value that is unique
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... 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...) — 56 mã theo 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.9.0 This IG
MedicationRequest.groupIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
MedicationRequest.groupIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
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.9.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 v7.2
MedicationRequest.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v7.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()
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'

Summary

Mandatory: 5 elements
Fixed: 2 elements

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* VNCoreMedicationRequest Ordering of medication for patient or group
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... 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-reg-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
.... extension:paymentSource 0..1 CodeableConcept Nguồn chi trả cho dòng thuốc (NGUON_CTRA)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source
Binding: Nguồn chi trả — Vietnam Payment Source ValueSet (extensible)
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣC 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.
Constraints: vn-rx-outpatient-issued-only
... intent ?!SΣ 1..1 code Ý định: order (kê đơn) | proposal | plan
Binding: medicationRequest Intent (required): The kind of medication order.
Fixed Value: order
... category SC 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
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.
Constraints: vn-rx-outpatient-category
... 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
... authoredOn SΣ 1..1 dateTime Ngày kê đơn
... requester 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) Người kê đơn — bắt buộc theo TT 26/2025/TT-BYT
... groupIdentifier SΣC 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value Σ 1..1 string The value that is unique
Example General: 123456
... 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...) — 56 mã theo 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

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.groupIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
MedicationRequest.dosageInstruction.​route Base extensible Đường dùng thuốc — Vietnam Medication Route ValueSet 📦0.9.0 This IG

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()
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* VNCoreMedicationRequest Ordering of medication for patient or group
... status C 1..1 code Trạng thái đơn thuốc
Constraints: vn-rx-outpatient-issued-only
... intent 1..1 code Ý định: order (kê đơn) | proposal | plan
Fixed Value: order
... category C 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
Constraints: vn-rx-outpatient-category
... groupIdentifier C 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... system 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value 1..1 string The value that is unique

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationRequest 0..* VNCoreMedicationRequest 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-reg-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
.... extension:paymentSource 0..1 CodeableConcept Nguồn chi trả cho dòng thuốc (NGUON_CTRA)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source
Binding: Nguồn chi trả — Vietnam Payment Source ValueSet (extensible)
.... extension:tenderInfo 0..1 string Thông tin thầu (TT_THAU)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info
.... extension:processingMethod 0..1 CodeableConcept Phương pháp chế biến YHCT (MA_PP_CHEBIEN)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method
Binding: Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier S 0..* Identifier Mã dòng thuốc trong đơn (mã nội bộ của cơ sở kê đơn) — KHÔNG dùng cho mã đơn quốc gia
... status ?!SΣC 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.
Constraints: vn-rx-outpatient-issued-only
... 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.
Fixed Value: order
... category SC 1..* CodeableConcept Bối cảnh kê đơn: outpatient (ngoại trú) hoặc discharge (cấp khi ra viện)
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.
Constraints: vn-rx-outpatient-category
... 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Σ 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) Người kê đơn — bắt buộc theo TT 26/2025/TT-BYT
... 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 SΣC 1..1 Identifier Mã đơn thuốc quốc gia (bắt buộc với đơn ngoại trú)
Constraints: vn-rx-outpatient-code-format
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: http://fhir.hl7.org.vn/core/sid/don-thuoc-quoc-gia
.... value Σ 1..1 string The value that is unique
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... 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...) — 56 mã theo 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.9.0 This IG
MedicationRequest.groupIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
MedicationRequest.groupIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
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.9.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 v7.2
MedicationRequest.substitution.​reason Base example SubstanceAdminSubstitutionReason 📦3.0.0 THO v7.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()
vn-rx-outpatient-category error MedicationRequest.category Đơn ngoại trú phải mang ít nhất một category là outpatient hoặc discharge theo hệ mã medicationrequest-category của HL7. coding.where(system = 'http://terminology.hl7.org/CodeSystem/medicationrequest-category' and (code = 'outpatient' or code = 'discharge')).exists()
vn-rx-outpatient-code-format error MedicationRequest.groupIdentifier Mã đơn thuốc quốc gia gồm 14 ký tự theo Phụ lục I TT 26/2025/TT-BYT: 5 chữ số mã cơ sở khám bệnh, chữa bệnh + 7 ký tự chữ thường hoặc số + dấu gạch nối + 1 ký tự loại đơn (N, H hoặc C). Đơn thuốc cổ truyền dùng hậu tố T và thuộc profile VNCoreYHCTOutpatientPrescription. value.matches('^[0-9]{5}[0-9a-z]{7}-[NHC]$')
vn-rx-outpatient-issued-only error MedicationRequest.status Đơn ngoại trú liên thông phải là đơn đã phát hành: status không được là draft. $this != 'draft'

Summary

Mandatory: 5 elements
Fixed: 2 elements

 

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