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-20 |
Các định nghĩa cho vn-ext-item-benefit-stage-sequence phần mở rộng
Guidance on how to interpret the contents of this table can be foundhere
| 0. Extension | |
| Definition | Khóa liên kết một dòng chi phí Claim hoặc ExplanationOfBenefit với đúng giai đoạn hưởng bảo hiểm được khai báo trên insurance. Giá trị là positiveInt và phải khớp sequence trong VNCoreExtCoverageBenefitStage. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT. This extension links a Claim or ExplanationOfBenefit cost line to the exact insurance benefit stage declared on insurance. Its positive integer value must match the sequence carried by VNCoreExtCoverageBenefitStage. Optional Extension Element - found in all resources. |
| Short | Liên kết dòng chi phí với giai đoạn hưởng — Item Benefit Stage SequenceOptional 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-item-benefit-stage-sequence |
| 6. Extension.value[x] | |
| Definition | Khóa sequence tham chiếu đến VNCoreExtCoverageBenefitStage trên insurance của cùng resource. The sequence key referencing VNCoreExtCoverageBenefitStage on insurance in the same resource. Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). |
| Short | Sequence của giai đoạn hưởng tương ứng — Matching benefit-stage sequenceValue of extension |
| Control | 10..1 |
| Type | positiveInt, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, 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 |
| 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 | Khóa liên kết một dòng chi phí Claim hoặc ExplanationOfBenefit với đúng giai đoạn hưởng bảo hiểm được khai báo trên insurance. Giá trị là positiveInt và phải khớp sequence trong VNCoreExtCoverageBenefitStage. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT. This extension links a Claim or ExplanationOfBenefit cost line to the exact insurance benefit stage declared on insurance. Its positive integer value must match the sequence carried by VNCoreExtCoverageBenefitStage. |
| Short | Liên kết dòng chi phí với giai đoạn hưởng — Item Benefit Stage Sequence |
| 2. Extension.extension | |
| Control | 0..0 |
| 4. Extension.url | |
| Fixed Value | http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-item-benefit-stage-sequence |
| 6. Extension.value[x] | |
| Definition | Khóa sequence tham chiếu đến VNCoreExtCoverageBenefitStage trên insurance của cùng resource. The sequence key referencing VNCoreExtCoverageBenefitStage on insurance in the same resource. |
| Short | Sequence của giai đoạn hưởng tương ứng — Matching benefit-stage sequence |
| Control | 1..? |
| Type | positiveInt, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, 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] |
| 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 | Khóa liên kết một dòng chi phí Claim hoặc ExplanationOfBenefit với đúng giai đoạn hưởng bảo hiểm được khai báo trên insurance. Giá trị là positiveInt và phải khớp sequence trong VNCoreExtCoverageBenefitStage. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT. This extension links a Claim or ExplanationOfBenefit cost line to the exact insurance benefit stage declared on insurance. Its positive integer value must match the sequence carried by VNCoreExtCoverageBenefitStage. |
| Short | Liên kết dòng chi phí với giai đoạn hưởng — Item Benefit Stage Sequence |
| 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-item-benefit-stage-sequence |
| 8. Extension.value[x] | |
| Definition | Khóa sequence tham chiếu đến VNCoreExtCoverageBenefitStage trên insurance của cùng resource. The sequence key referencing VNCoreExtCoverageBenefitStage on insurance in the same resource. |
| Short | Sequence của giai đoạn hưởng tương ứng — Matching benefit-stage sequence |
| Control | 1..1 |
| Type | positiveInt |
| [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())) |
