Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
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.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-yhct-outpatient-prescription | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreYHCTOutpatientPrescription | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.115 | |||||
Profile cho đơn thuốc cổ truyền, thuốc dược liệu và đơn kết hợp thuốc cổ truyền với thuốc hoá dược kê trong điều trị ngoại trú, theo TT 55/2025/TT-BYT.
Khác biệt so với đơn ngoại trú hoá dược (VNCoreOutpatientPrescription): mã đơn thuốc quốc gia mang hậu tố T; bài thuốc cổ truyền mã hoá bằng VNYHCTPrescriptionCS và vị thuốc bằng VNYHCTHerbCS; phương pháp chế biến vị thuốc ghi ở extension processingMethod.
Với đơn kết hợp, TT 55/2025/TT-BYT Điều 7 khoản 2 quy định kê thành các TỜ ĐƠN RIÊNG theo từng mẫu: thuốc thang theo Phụ lục I, thuốc cổ truyền và thuốc dược liệu theo Phụ lục II, thuốc hoá dược theo TT 26/2025/TT-BYT. Mỗi tờ đơn tự mang một mã đơn thuốc quốc gia 14 ký tự riêng, nên groupIdentifier KHÔNG dùng chung giữa phần cổ truyền và phần hoá dược — một giá trị không thể vừa mang hậu tố T vừa mang N/H/C. Để nối các tờ đơn của cùng một đợt điều trị, dùng VNCoreCombinedPrescriptionGroup (RequestGroup) với một mã đợt riêng, hoặc encounter chung. / Traditional-medicine outpatient prescription profile per Circular 55/2025/TT-BYT; the national prescription code carries the T suffix. Combined prescriptions are separate forms with separate codes, linked by a RequestGroup.
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
  MedicationRequest |
||||
  Slices for extension |
||||
 identifier |
|
| ||
 status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
 medication[x] |
|
| ||
 subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
 dispenseRequest |
|
| ||
| Documentation for this format | ||||
| 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.10.0 | This IG |
| 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-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
| Name | Flags | Card. | Type | Description & Constraints Filter:   | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| MedicationRequest |
0..* | VNCoreMedicationRequest | Ordering of medication for patient or group | |||||||
 Slices for extension |
Content/Rules for all slices | |||||||||
   extension:processingMethod |
0..1 | VNCoreExtTraditionalProcessingMethod | Phương pháp chế biến vị thuốc cổ truyền (MA_PP_CHEBIEN) — ghi khi bài thuốc yêu cầu | |||||||
 status |
C | 1..1 | code | Trạng thái đơn thuốc Constraints: vn-rx-yhct-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-yhct-category | ||||||
| requester |
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 55/2025/TT-BYT | |||||||
| groupIdentifier |
C | 1..1 | Identifier | Mã đơn thuốc quốc gia, hậu tố T (bắt buộc với đơn thuốc cổ truyền ngoại trú) Constraints: vn-rx-yhct-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 | |||||||
| note |
SO | 0..* | Annotation | Hướng dẫn cách sắc thuốc — TT 55/2025/TT-BYT Điều 8 khoản 5 điểm a
| ||||||
| Documentation for this format | ||||||||||
| Name | Kho hồ sơ EMR (Repository) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|
| MedicationRequest |
||
| Slices for extension |
||
| note |
| |
| Documentation for this format | ||
| Id | Grade | Path(s) | Description | Expression |
| vn-rx-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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.
| ||||||||||||||||
| 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: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: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 vị thuốc cổ truyền (MA_PP_CHEBIEN) — ghi khi bài thuốc yêu cầu 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 |
SO | 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 |
?!SOΣ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-yhct-issued-only
| |||||||||||||||
| statusReason |
0..1 | CodeableConcept | Reason for current status Binding: medicationRequest Status Reason Codes (example): Identifies the reasons for a given status. | ||||||||||||||||
| intent |
?!SOΣ | 1..1 | code | Ý định: order (kê đơn) | proposal | plan Binding: medicationRequest Intent (required): The kind of medication order. Fixed Value: order
| |||||||||||||||
| category |
SOC | 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-yhct-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] |
SOΣ | 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 |
SOΣ | 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 |
SOΣ | 1..1 | dateTime | Ngày kê đơn
| |||||||||||||||
| requester |
SOΣ | 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 55/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 |
SOΣC | 1..1 | Identifier | Mã đơn thuốc quốc gia, hậu tố T (bắt buộc với đơn thuốc cổ truyền ngoại trú) Constraints: vn-rx-yhct-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 |
SO | 0..* | Annotation | Hướng dẫn cách sắc thuốc — TT 55/2025/TT-BYT Điều 8 khoản 5 điểm a
| |||||||||||||||
| dosageInstruction |
SO | 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 |
SO | 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 | ||||||||||||||||
| Documentation for this format | |||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| MedicationRequest |
||||
| Slices for extension |
||||
| identifier |
|
| ||
| status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
| medication[x] |
|
| ||
| subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
| dispenseRequest |
|
| ||
| Documentation for this format | ||||
| 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.10.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.10.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 |
| 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-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| MedicationRequest |
||||
| Slices for extension |
||||
| identifier |
|
| ||
| status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
| medication[x] |
|
| ||
| subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
| dispenseRequest |
|
| ||
| Documentation for this format | ||||
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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: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: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 vị thuốc cổ truyền (MA_PP_CHEBIEN) — ghi khi bài thuốc yêu cầu 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 |
SO | 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 |
?!SOΣ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-yhct-issued-only
| |||||||||||||||
| intent |
?!SOΣ | 1..1 | code | Ý định: order (kê đơn) | proposal | plan Binding: medicationRequest Intent (required): The kind of medication order. Fixed Value: order
| |||||||||||||||
| category |
SOC | 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-yhct-category
| |||||||||||||||
| doNotPerform |
?!Σ | 0..1 | boolean | True if request is prohibiting action | |||||||||||||||
| medication[x] |
SOΣ | 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 |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân được kê đơn
| |||||||||||||||
| authoredOn |
SOΣ | 1..1 | dateTime | Ngày kê đơn
| |||||||||||||||
| requester |
SOΣ | 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 55/2025/TT-BYT
| |||||||||||||||
| groupIdentifier |
SOΣC | 1..1 | Identifier | Mã đơn thuốc quốc gia, hậu tố T (bắt buộc với đơn thuốc cổ truyền ngoại trú) Constraints: vn-rx-yhct-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 | |||||||||||||||
| note |
SO | 0..* | Annotation | Hướng dẫn cách sắc thuốc — TT 55/2025/TT-BYT Điều 8 khoản 5 điểm a
| |||||||||||||||
| dosageInstruction |
SO | 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 |
SO | 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 | |||||||||||||||
| Documentation for this format | |||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| MedicationRequest |
||||
| Slices for extension |
||||
| identifier |
|
| ||
| status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
| medication[x] |
|
| ||
| subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
| dispenseRequest |
|
| ||
| Documentation for this format | ||||
| 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.10.0 | This IG |
| 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-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
Dạng xem Differential
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| MedicationRequest |
0..* | VNCoreMedicationRequest | Ordering of medication for patient or group | |||||||
| Slices for extension |
Content/Rules for all slices | |||||||||
| extension:processingMethod |
0..1 | VNCoreExtTraditionalProcessingMethod | Phương pháp chế biến vị thuốc cổ truyền (MA_PP_CHEBIEN) — ghi khi bài thuốc yêu cầu | |||||||
| status |
C | 1..1 | code | Trạng thái đơn thuốc Constraints: vn-rx-yhct-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-yhct-category | ||||||
| requester |
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 55/2025/TT-BYT | |||||||
| groupIdentifier |
C | 1..1 | Identifier | Mã đơn thuốc quốc gia, hậu tố T (bắt buộc với đơn thuốc cổ truyền ngoại trú) Constraints: vn-rx-yhct-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 | |||||||
| note |
SO | 0..* | Annotation | Hướng dẫn cách sắc thuốc — TT 55/2025/TT-BYT Điều 8 khoản 5 điểm a
| ||||||
| Documentation for this format | ||||||||||
| Name | Kho hồ sơ EMR (Repository) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|
| MedicationRequest |
||
| Slices for extension |
||
| note |
| |
| Documentation for this format | ||
| Id | Grade | Path(s) | Description | Expression |
| vn-rx-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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.
| ||||||||||||||||
| 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: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: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 vị thuốc cổ truyền (MA_PP_CHEBIEN) — ghi khi bài thuốc yêu cầu 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 |
SO | 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 |
?!SOΣ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-yhct-issued-only
| |||||||||||||||
| statusReason |
0..1 | CodeableConcept | Reason for current status Binding: medicationRequest Status Reason Codes (example): Identifies the reasons for a given status. | ||||||||||||||||
| intent |
?!SOΣ | 1..1 | code | Ý định: order (kê đơn) | proposal | plan Binding: medicationRequest Intent (required): The kind of medication order. Fixed Value: order
| |||||||||||||||
| category |
SOC | 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-yhct-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] |
SOΣ | 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 |
SOΣ | 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 |
SOΣ | 1..1 | dateTime | Ngày kê đơn
| |||||||||||||||
| requester |
SOΣ | 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 55/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 |
SOΣC | 1..1 | Identifier | Mã đơn thuốc quốc gia, hậu tố T (bắt buộc với đơn thuốc cổ truyền ngoại trú) Constraints: vn-rx-yhct-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 |
SO | 0..* | Annotation | Hướng dẫn cách sắc thuốc — TT 55/2025/TT-BYT Điều 8 khoản 5 điểm a
| |||||||||||||||
| dosageInstruction |
SO | 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 |
SO | 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 | ||||||||||||||||
| Documentation for this format | |||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| MedicationRequest |
||||
| Slices for extension |
||||
| identifier |
|
| ||
| status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
| medication[x] |
|
| ||
| subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
| dispenseRequest |
|
| ||
| Documentation for this format | ||||
| 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.10.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.10.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 |
| 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-yhct-category | error | MedicationRequest.category | Đơn thuốc cổ truyề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-yhct-code-format | error | MedicationRequest.groupIdentifier | Mã đơn thuốc quốc gia cho đơn thuốc cổ truyền gồm 14 ký tự: 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 + hậu tố T. |
value.matches('^[0-9]{5}[0-9a-z]{7}-T$')
|
| vn-rx-yhct-issued-only | error | MedicationRequest.status | Đơn thuốc cổ truyền liên thông phải là đơn đã phát hành: status không được là draft. |
$this != 'draft'
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| MedicationRequest |
||||
| Slices for extension |
||||
| identifier |
|
| ||
| status |
|
| ||
| intent |
|
| ||
| category |
|
| ||
| medication[x] |
|
| ||
| subject |
|
| ||
| authoredOn |
|
| ||
| requester |
|
| ||
| groupIdentifier |
|
| ||
| note |
| |||
| dosageInstruction |
|
| ||
| dispenseRequest |
|
| ||
| Documentation for this format | ||||
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron
