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
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-30 |
Các định nghĩa cho vn-ext-traditional-processing-method phần mở rộng
Guidance on how to interpret the contents of this table can be foundhere
| 0. Extension | |
| Definition | Phương pháp chế biến vị thuốc, dược liệu hoặc thuốc y học cổ truyền — mang trường Optional Extension Element - found in all resources. |
| Short | Phương pháp chế biến YHCT — Traditional Medicine Processing MethodOptional Extensions Element |
| Control | 0..* This element is affected by the following invariants: ele-1 |
| Is Modifier | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists())ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| 2. Extension.extension | |
| Definition | An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
| Short | ExtensionAdditional content defined by implementations |
| Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
| Control | 0..0* |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Alternate Names | extensions, user content |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on Extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 4. Extension.url | |
| Definition | Source of the definition for the extension code - a logical name or a URL. |
| Short | identifies the meaning of the extension |
| Comments | The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension. |
| Control | 1..1 |
| Type | uri |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| Fixed Value | http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method |
| 6. Extension.value[x] | |
| Definition | Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). |
| Short | Phương pháp chế biến YHCT — ưu tiên mã hóa, chuỗi tự do chỉ khi chưa có mãValue of extension |
| Control | 10..1 |
| Type | Choice of: string, CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| Slicing | This element introduces a set of slices on Extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators: |
| 8. Extension.value[x]:valueCodeableConcept | |
| Slice Name | valueCodeableConcept |
| Definition | Mã phương pháp chế biến vị thuốc cổ truyền, ví dụ Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). |
| Short | Mã phương pháp chế biến theo Phụ lục 3 QĐ 824/QĐ-BYT (MA_PP_CHEBIEN)Value of extension |
| Control | 0..1 |
| Binding | Unless not suitable, these codes SHALL be taken from For codes, see Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-tcm-processing-method-vs) |
| Type | CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 10. Extension.value[x]:valueString | |
| Slice Name | valueString |
| Definition | Chỉ dùng khi không mã hóa được: ba phương pháp chưng, tôi và rán dầu do TT 14/2024/TT-BYT bổ sung chưa có mã riêng trong Phụ lục 3 QĐ 824/QĐ-BYT, hoặc phương pháp do cơ sở tự xây dựng theo Điều 4 khoản 2 TT 14/2024/TT-BYT. Với ba phương pháp nói trên, khuyến nghị ghi kèm Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). |
| Short | Tên phương pháp chế biến khi bộ mã dùng chung chưa có mãValue of extension |
| Control | 0..1 |
| Type | string, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
Guidance on how to interpret the contents of this table can be foundhere
| 0. Extension | |
| Definition | Phương pháp chế biến vị thuốc, dược liệu hoặc thuốc y học cổ truyền — mang trường |
| Short | Phương pháp chế biến YHCT — Traditional Medicine Processing Method |
| 2. Extension.extension | |
| Control | 0..0 |
| 4. Extension.url | |
| Fixed Value | http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method |
| 6. Extension.value[x] | |
| Short | Phương pháp chế biến YHCT — ưu tiên mã hóa, chuỗi tự do chỉ khi chưa có mã |
| Control | 1..? |
| Type | Choice of: string, CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| Slicing | This element introduces a set of slices on Extension.value[x]. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 8. Extension.value[x]:valueCodeableConcept | |
| Slice Name | valueCodeableConcept |
| Definition | Mã phương pháp chế biến vị thuốc cổ truyền, ví dụ |
| Short | Mã phương pháp chế biến theo Phụ lục 3 QĐ 824/QĐ-BYT (MA_PP_CHEBIEN) |
| Control | 0..1 |
| Binding | Unless not suitable, these codes SHALL be taken from Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-tcm-processing-method-vs) |
| Type | CodeableConcept |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| 10. Extension.value[x]:valueString | |
| Slice Name | valueString |
| Definition | Chỉ dùng khi không mã hóa được: ba phương pháp chưng, tôi và rán dầu do TT 14/2024/TT-BYT bổ sung chưa có mã riêng trong Phụ lục 3 QĐ 824/QĐ-BYT, hoặc phương pháp do cơ sở tự xây dựng theo Điều 4 khoản 2 TT 14/2024/TT-BYT. Với ba phương pháp nói trên, khuyến nghị ghi kèm |
| Short | Tên phương pháp chế biến khi bộ mã dùng chung chưa có mã |
| Control | 0..1 |
| Type | string |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
Guidance on how to interpret the contents of this table can be foundhere
| 0. Extension | |
| Definition | Phương pháp chế biến vị thuốc, dược liệu hoặc thuốc y học cổ truyền — mang trường |
| Short | Phương pháp chế biến YHCT — Traditional Medicine Processing Method |
| Control | 0..* This element is affected by the following invariants: ele-1 |
| Is Modifier | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| 2. Extension.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Short | Unique id for inter-element referencing |
| Control | 0..1 |
| Type | string |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| 4. Extension.extension | |
| Definition | An Extension |
| Short | Extension |
| Control | 0..0 |
| Type | Extension |
| Is Modifier | false |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))ext-1: Must have either extensions or value[x], not both ( extension.exists() != value.exists()) |
| Slicing | This element introduces a set of slices on Extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators: |
| 6. Extension.url | |
| Definition | Source of the definition for the extension code - a logical name or a URL. |
| Short | identifies the meaning of the extension |
| Comments | The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension. |
| Control | 1..1 |
| Type | uri |
| Is Modifier | false |
| XML Format | In the XML format, this property is represented as an attribute. |
| Summary | false |
| Fixed Value | http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method |
| 8. Extension.value[x] | |
| Definition | Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). |
| Short | Phương pháp chế biến YHCT — ưu tiên mã hóa, chuỗi tự do chỉ khi chưa có mã |
| Control | 1..1 |
| Type | Choice of: string, CodeableConcept |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| Slicing | This element introduces a set of slices on Extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators: |
| 10. Extension.value[x]:valueCodeableConcept | |
| Slice Name | valueCodeableConcept |
| Definition | Mã phương pháp chế biến vị thuốc cổ truyền, ví dụ |
| Short | Mã phương pháp chế biến theo Phụ lục 3 QĐ 824/QĐ-BYT (MA_PP_CHEBIEN) |
| Control | 0..1 |
| Binding | Unless not suitable, these codes SHALL be taken from Phương pháp chế biến vị thuốc cổ truyền — VN Traditional Medicine Processing Method ValueSet (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-tcm-processing-method-vs) |
| Type | CodeableConcept |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
| 12. Extension.value[x]:valueString | |
| Slice Name | valueString |
| Definition | Chỉ dùng khi không mã hóa được: ba phương pháp chưng, tôi và rán dầu do TT 14/2024/TT-BYT bổ sung chưa có mã riêng trong Phụ lục 3 QĐ 824/QĐ-BYT, hoặc phương pháp do cơ sở tự xây dựng theo Điều 4 khoản 2 TT 14/2024/TT-BYT. Với ba phương pháp nói trên, khuyến nghị ghi kèm |
| Short | Tên phương pháp chế biến khi bộ mã dùng chung chưa có mã |
| Control | 0..1 |
| Type | string |
| [x] Note | SeeChoice of Data Typesfor further information about how to use [x] |
| Is Modifier | false |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |
| Summary | false |
| Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) |
