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.10.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.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Sự cố bất lợi sau tiêm chủng — VN Core Adverse Event Post Immunization - Mô tả chi tiết

Draft tại thời điểm 2026-08-06

Các định nghĩa cho vn-core-adverse-event-post-immunization hồ sơ tài nguyên

Guidance on how to interpret the contents of this table can be foundhere

0. AdverseEvent
Definition

Actual or potential/avoided event causing unintended physical injury resulting from or contributed to by medical care, a research study or other healthcare setting factors that requires additional monitoring, treatment, or hospitalization, or that results in death.

ShortMedical care, research study or other healthcare event causing physical injury
Control0..*
Is Modifierfalse
Summaryfalse
Alternate NamesAE
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: 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: 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: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
vn-aefi-immunization-linked: Báo cáo AEFI phải truy được ít nhất một mũi tiêm: qua liên kết thời gian (vn-ext-aefi-related-immunization) hoặc qua nghi ngờ nhân quả (suspectEntity). An AEFI report SHALL link at least one immunization via the temporal-association extension or suspectEntity. (extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-aefi-related-immunization').exists() or suspectEntity.where(instance.reference.exists() or instance.identifier.exists()).exists())
vn-aefi-sequelae-resulting-condition: Kết cục để lại di chứng phải kèm bệnh/khuyết tật cụ thể. An outcome of resolvedWithSequelae SHALL reference the resulting condition. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and code = 'resolvedWithSequelae').empty() or resultingCondition.where(reference.exists() or identifier.exists()).exists())
vn-aefi-severe-outcome-seriousness: Kết cục tử vong hoặc để lại di chứng buộc phải phân loại là tai biến nặng. A fatal or sequelae outcome SHALL be classified as a serious AEFI. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and (code = 'fatal' or code = 'resolvedWithSequelae')).empty() or seriousness.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs' and code = 'serious-aefi').exists())
2. AdverseEvent.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. AdverseEvent.extension
Definition

An Extension


May be used to represent additional information that is not part of the basic definition of the resource. 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.

ShortExtensionAdditional 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.

Control0..*
TypeExtension
Is Modifierfalse
Summaryfalse
Alternate Namesextensions, user content
Invariantsele-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())
SlicingThis element introduces a set of slices on AdverseEvent.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 6. AdverseEvent.extension:relatedImmunization
    Slice NamerelatedImmunization
    Definition

    Đường liên kết trung tính cho ca chưa có (hoặc không có) nghi ngờ nhân quả — ví dụ sự cố trùng hợp do bệnh lý khác xảy ra sau tiêm. Khi có nghi ngờ nhân quả thực sự, dùng suspectEntity.

    ShortMũi tiêm liên quan theo thời gian — không hàm ý nhân quả
    Control0..*
    This element is affected by the following invariants: ele-1
    TypeExtension(Mũi tiêm liên quan theo thời gian — VN AEFI Related Immunization) (Extension Type: Reference(Tiêm chủng — VN Core Immunization))
    Is Modifierfalse
    Must Supporttrue
    Obligations
      ObligationsActor
      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
      Summaryfalse
      Invariantsele-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())
      8. AdverseEvent.modifierExtension
      Definition

      May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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 is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

      Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

      ShortExtensions that cannot be ignored
      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.

      Control0..*
      TypeExtension
      Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
      Summaryfalse
      Requirements

      Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

      Alternate Namesextensions, user content
      Invariantsele-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())
      10. AdverseEvent.actuality
      Definition

      Whether the event actually happened, or just had the potential to. Note that this is independent of whether anyone was affected or harmed or how severely.

      ShortLuôn là sự cố đã xảy raactual | potential
      Control1..1
      BindingThe codes SHALL be taken from AdverseEventActualityhttp://hl7.org/fhir/ValueSet/adverse-event-actuality|4.0.1
      (required to http://hl7.org/fhir/ValueSet/adverse-event-actuality|4.0.1)

      Overall nature of the adverse event, e.g. real or potential.

      Typecode
      Is Modifiertrue because This element is labeled as a modifier because it has a potential code that indicates the adverse event did not actually happen.
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Must Supporttrue
      Obligations
        ObligationsActor
        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
        Summarytrue
        Fixed Valueactual
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        12. AdverseEvent.category
        Definition

        The overall type of event, intended for search and filtering purposes.

        ShortMiền báo cáo — luôn chứa mã sự cố bất lợi sau tiêm chủngproduct-problem | product-quality | product-use-error | wrong-dose | incorrect-prescribing-information | wrong-technique | wrong-route-of-administration | wrong-rate | wrong-duration | wrong-time | expired-drug | medical-device-use-error | problem-different-manufacturer | unsafe-physical-environment
        Control10..*
        BindingUnless not suitable, these codes SHALL be taken from AdverseEventCategoryhttp://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1
        (extensible to http://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1)

        Overall categorization of the event, e.g. product-related or situational.

        TypeCodeableConcept
        Is Modifierfalse
        Must Supporttrue
        Obligations
          ObligationsActor
          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
          Summarytrue
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          SlicingThis element introduces a set of slices on AdverseEvent.category. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • pattern @ $this
          • 14. AdverseEvent.category:aefiDomain
            Slice NameaefiDomain
            Definition

            The overall type of event, intended for search and filtering purposes.

            ShortĐánh dấu bản ghi thuộc miền AEFI (tầng cha của cây phân loại)product-problem | product-quality | product-use-error | wrong-dose | incorrect-prescribing-information | wrong-technique | wrong-route-of-administration | wrong-rate | wrong-duration | wrong-time | expired-drug | medical-device-use-error | problem-different-manufacturer | unsafe-physical-environment
            Control10..1*
            BindingUnless not suitable, these codes SHALL be taken from AdverseEventCategoryhttp://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1
            (extensible to http://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1)

            Overall categorization of the event, e.g. product-related or situational.

            TypeCodeableConcept
            Is Modifierfalse
            Must Supporttrue
            Obligations
              ObligationsActor
              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
              Summarytrue
              Pattern Value{
                "coding" : [{
                  "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs",
                  "code" : "aefi"
                }]
              }
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              16. AdverseEvent.event
              Definition

              Sự cố là GÌ. Cố ý để coding mở: TT 13/2026/TT-BYT không ban hành danh mục biểu hiện AEFI, và hướng dẫn chuyên môn của Cục Phòng bệnh chưa công bố. Khuyến nghị dùng ICD-10 hoặc SNOMED CT khi có.


              This element defines the specific type of event that occurred or that was prevented from occurring.

              ShortBiểu hiện lâm sàng của sự cố — triệu chứng hoặc chẩn đoán cụ thểType of the event itself in relation to the subject
              Control10..1
              BindingFor example codes, see SNOMEDCTClinicalFindingshttp://hl7.org/fhir/ValueSet/adverse-event-type|4.0.1
              (example to http://hl7.org/fhir/ValueSet/adverse-event-type|4.0.1)

              Detailed type of event.

              TypeCodeableConcept
              Is Modifierfalse
              Must Supporttrue
              Obligations
                ObligationsActor
                SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                Summarytrue
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                18. AdverseEvent.subject
                Definition

                This subject or group impacted by the event.

                ShortNgười được tiêm chủng gặp sự cốSubject impacted by event
                Comments

                If AdverseEvent.resultingCondition differs among members of the group, then use Patient as the subject.

                Control1..1
                TypeReference(Bệnh nhân VN Core — VN Core Patient Profile, Patient, Group, Practitioner, RelatedPerson)
                Is Modifierfalse
                Must Supporttrue
                Obligations
                  ObligationsActor
                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                  Summarytrue
                  Requirements

                  Allows for exposure of biohazard (such as legionella) to a group of individuals in a hospital.

                  Alternate Namespatient
                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  20. AdverseEvent.date
                  Definition

                  The date (and perhaps time) when the adverse event occurred.

                  ShortThời điểm sự cố xảy raWhen the event occurred
                  Control10..1
                  TypedateTime
                  Is Modifierfalse
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  Must Supporttrue
                  Obligations
                    ObligationsActor
                    SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                    SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                    Summarytrue
                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                    22. AdverseEvent.detected
                    Definition

                    Estimated or actual date the AdverseEvent began, in the opinion of the reporter.

                    ShortThời điểm phát hiện sự cố — có thể sau thời điểm xảy raWhen the event was detected
                    Control0..1
                    TypedateTime
                    Is Modifierfalse
                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                    Must Supporttrue
                    Obligations
                      ObligationsActor
                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                      Summarytrue
                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                      24. AdverseEvent.recordedDate
                      Definition

                      The date on which the existence of the AdverseEvent was first recorded.

                      ShortThời điểm ghi nhận vào hồ sơ; mốc tính hạn báo cáo 24 giờ với tai biến nặngWhen the event was recorded
                      Comments

                      The recordedDate represents the date when this particular AdverseEvent record was created in the system, not the date of the most recent update. The date of the last record modification can be retrieved from the resource metadata.

                      Control0..1
                      TypedateTime
                      Is Modifierfalse
                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                      Must Supporttrue
                      Obligations
                        ObligationsActor
                        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                        Summarytrue
                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                        26. AdverseEvent.resultingCondition
                        Definition

                        Includes information about the reaction that occurred as a result of exposure to a substance (for example, a drug or a chemical).

                        ShortDi chứng để lại — bắt buộc khi kết cục là để lại di chứngEffect on the subject due to this event
                        Control0..*
                        TypeReference(Chẩn đoán VN Core — VN Core Condition Profile, Condition)
                        Is Modifierfalse
                        Must Supporttrue
                        Obligations
                          ObligationsActor
                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                          Summarytrue
                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          28. AdverseEvent.location
                          Definition

                          The information about where the adverse event occurred.

                          ShortNơi ghi nhận sự cố — điểm tiêm chủng hoặc cơ sở KCB tiếp nhậnLocation where adverse event occurred
                          Control0..1
                          TypeReference(Location)
                          Is Modifierfalse
                          Must Supporttrue
                          Obligations
                            ObligationsActor
                            SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                            SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                            Summarytrue
                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            30. AdverseEvent.seriousness
                            Definition

                            Trục quyết định nghĩa vụ pháp lý: tai biến nặng kích hoạt trách nhiệm báo cáo trong 24 giờ (TT 13/2026/TT-BYT Điều 15 khoản 5 điểm a) và có thể dẫn tới bồi thường nhà nước (NĐ 165/2026/NĐ-CP Điều 50).


                            Assessment whether this event was of real importance.

                            ShortPhân loại pháp lý: phản ứng thông thường hay tai biến nặngSeriousness of the event
                            Comments

                            0..1 chứ không 1..1 (kiểm toán 07/08/2026, mục 1.9): tại thời điểm ghi nhận ban đầu có thể CHƯA đủ căn cứ phân loại, và ép nhị phân sớm sẽ sinh dữ liệu đoán mò. VẮNG seriousness nghĩa là CHƯA PHÂN LOẠI — hệ thống tiếp nhận không được suy diễn thành phản ứng thông thường, và phải xử lý bản ghi chưa phân loại như chưa loại trừ tai biến nặng cho tới khi có phân loại. Khi kết cục đã là tử vong hoặc để lại di chứng, invariant vn-aefi-severe-outcome-seriousness buộc phân loại tai biến nặng ngay.

                            Control0..1
                            BindingThe codes SHALL be taken from For example codes, see Mức độ nghiêm trọng sự cố sau tiêm chủng — VN AEFI Seriousness ValueSethttp://hl7.org/fhir/ValueSet/adverse-event-seriousness|4.0.1
                            (required to http://fhir.hl7.org.vn/core/ValueSet/vn-aefi-seriousness-vs)
                            TypeCodeableConcept
                            Is Modifierfalse
                            Must Supporttrue
                            Obligations
                              ObligationsActor
                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                              Summarytrue
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              32. AdverseEvent.severity
                              Definition

                              Describes the severity of the adverse event, in relation to the subject. Contrast to AdverseEvent.seriousness - a severe rash might not be serious, but a mild heart problem is.

                              ShortMức độ nặng nhẹ lâm sàng — KHÔNG thay cho seriousnessmild | moderate | severe
                              Control0..1
                              BindingThe codes SHALL be taken from AdverseEventSeverityhttp://hl7.org/fhir/ValueSet/adverse-event-severity|4.0.1
                              (required to http://hl7.org/fhir/ValueSet/adverse-event-severity|4.0.1)

                              The severity of the adverse event itself, in direct relation to the subject.

                              TypeCodeableConcept
                              Is Modifierfalse
                              Must Supporttrue
                              Obligations
                                ObligationsActor
                                SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                Summarytrue
                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                34. AdverseEvent.outcome
                                Definition

                                Describes the type of outcome from the adverse event.

                                ShortKết cục: khỏi | đang hồi phục | còn tiếp diễn | để lại di chứng | tử vong | chưa rõresolved | recovering | ongoing | resolvedWithSequelae | fatal | unknown
                                Control0..1
                                BindingThe codes SHALL be taken from AdverseEventOutcomehttp://hl7.org/fhir/ValueSet/adverse-event-outcome|4.0.1
                                (required to http://hl7.org/fhir/ValueSet/adverse-event-outcome|4.0.1)

                                TODO (and should this be required?).

                                TypeCodeableConcept
                                Is Modifierfalse
                                Must Supporttrue
                                Obligations
                                  ObligationsActor
                                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                  Summarytrue
                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                  36. AdverseEvent.recorder
                                  Definition

                                  Information on who recorded the adverse event. May be the patient or a practitioner.

                                  ShortNgười ghi nhận báo cáoWho recorded the adverse event
                                  Control0..1
                                  TypeReference(Patient, Practitioner, PractitionerRole, RelatedPerson)
                                  Is Modifierfalse
                                  Must Supporttrue
                                  Must Support TypesNo must-support rules about the choice of types/profiles
                                  Obligations
                                    ObligationsActor
                                    SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                    SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                    Summarytrue
                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                    38. AdverseEvent.suspectEntity
                                    Definition

                                    Describes the entity that is suspected to have caused the adverse event.

                                    ShortMũi tiêm NGHI NGỜ gây ra sự cố — chỉ khai khi thực sự có nghi ngờThe suspected agent causing the adverse event
                                    Comments

                                    0..* chứ không 1..* (kiểm toán 07/08/2026, mục 1.9): suspectEntity theo R4 là thực thể nghi gây ra sự cố; ép tối thiểu 1 biến mọi ca 'xảy ra sau tiêm' thành nghi ngờ nhân quả, trái định nghĩa AEFI tại TT 13/2026/TT-BYT Điều 2 khoản 2. Ca chưa/không nghi ngờ liên kết mũi tiêm qua extension relatedImmunization; invariant vn-aefi-immunization-linked bảo đảm luôn truy được ít nhất một mũi tiêm.

                                    Control0..*
                                    TypeBackboneElement
                                    Is Modifierfalse
                                    Must Supporttrue
                                    Obligations
                                      ObligationsActor
                                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                      Summarytrue
                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                      40. AdverseEvent.suspectEntity.modifierExtension
                                      Definition

                                      May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions.

                                      Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                      ShortExtensions that cannot be ignored even if unrecognized
                                      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.

                                      Control0..*
                                      TypeExtension
                                      Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                      Summarytrue
                                      Requirements

                                      Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                      Alternate Namesextensions, user content, modifiers
                                      Invariantsele-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())
                                      42. AdverseEvent.suspectEntity.instance
                                      Definition

                                      Chỉ trỏ tới VNCoreImmunization: đây là profile cho sự cố SAU TIÊM CHỦNG, mọi đối tượng nghi ngờ đều là một mũi tiêm đã thực hiện. Sự cố nghi do thuốc hoặc thiết bị dùng AdverseEvent gốc, không dùng profile này.


                                      Identifies the actual instance of what caused the adverse event. May be a substance, medication, medication administration, medication statement or a device.

                                      ShortLượt tiêm chủng nghi ngờRefers to the specific entity that caused the adverse event
                                      Control1..1
                                      TypeReference(Tiêm chủng — VN Core Immunization, Immunization, Procedure, Substance, Medication, MedicationAdministration, MedicationStatement, Device)
                                      Is Modifierfalse
                                      Summarytrue
                                      Alternate NamesSubstance or Medication or Device
                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                      44. AdverseEvent.suspectEntity.causality
                                      Definition

                                      Information on the possible cause of the event.

                                      ShortĐánh giá nhân quả — KHÔNG bắt buộc tại thời điểm ghi nhậnInformation on the possible cause of the event
                                      Control0..*
                                      TypeBackboneElement
                                      Is Modifierfalse
                                      Must Supporttrue
                                      Summarytrue
                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                      46. AdverseEvent.suspectEntity.causality.modifierExtension
                                      Definition

                                      May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions.

                                      Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                      ShortExtensions that cannot be ignored even if unrecognized
                                      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.

                                      Control0..*
                                      TypeExtension
                                      Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                      Summarytrue
                                      Requirements

                                      Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                      Alternate Namesextensions, user content, modifiers
                                      Invariantsele-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())

                                      Guidance on how to interpret the contents of this table can be foundhere

                                      0. AdverseEvent
                                      Invariantsvn-aefi-immunization-linked: Báo cáo AEFI phải truy được ít nhất một mũi tiêm: qua liên kết thời gian (vn-ext-aefi-related-immunization) hoặc qua nghi ngờ nhân quả (suspectEntity). An AEFI report SHALL link at least one immunization via the temporal-association extension or suspectEntity. (extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-aefi-related-immunization').exists() or suspectEntity.where(instance.reference.exists() or instance.identifier.exists()).exists())
                                      vn-aefi-sequelae-resulting-condition: Kết cục để lại di chứng phải kèm bệnh/khuyết tật cụ thể. An outcome of resolvedWithSequelae SHALL reference the resulting condition. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and code = 'resolvedWithSequelae').empty() or resultingCondition.where(reference.exists() or identifier.exists()).exists())
                                      vn-aefi-severe-outcome-seriousness: Kết cục tử vong hoặc để lại di chứng buộc phải phân loại là tai biến nặng. A fatal or sequelae outcome SHALL be classified as a serious AEFI. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and (code = 'fatal' or code = 'resolvedWithSequelae')).empty() or seriousness.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs' and code = 'serious-aefi').exists())
                                      2. AdverseEvent.extension
                                      SlicingThis element introduces a set of slices on AdverseEvent.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                      • value @ url
                                      • 4. AdverseEvent.extension:relatedImmunization
                                        Slice NamerelatedImmunization
                                        Definition

                                        Đường liên kết trung tính cho ca chưa có (hoặc không có) nghi ngờ nhân quả — ví dụ sự cố trùng hợp do bệnh lý khác xảy ra sau tiêm. Khi có nghi ngờ nhân quả thực sự, dùng suspectEntity.

                                        ShortMũi tiêm liên quan theo thời gian — không hàm ý nhân quả
                                        Control0..*
                                        TypeExtension(Mũi tiêm liên quan theo thời gian — VN AEFI Related Immunization) (Extension Type: Reference(Tiêm chủng — VN Core Immunization))
                                        Must Supporttrue
                                        Obligations
                                          ObligationsActor
                                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                          6. AdverseEvent.actuality
                                          ShortLuôn là sự cố đã xảy ra
                                          Must Supporttrue
                                          Obligations
                                            ObligationsActor
                                            SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                            SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                            Fixed Valueactual
                                            8. AdverseEvent.category
                                            ShortMiền báo cáo — luôn chứa mã sự cố bất lợi sau tiêm chủng
                                            Control1..?
                                            Must Supporttrue
                                            Obligations
                                              ObligationsActor
                                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                              SlicingThis element introduces a set of slices on AdverseEvent.category. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                              • pattern @ $this
                                              • 10. AdverseEvent.category:aefiDomain
                                                Slice NameaefiDomain
                                                ShortĐánh dấu bản ghi thuộc miền AEFI (tầng cha của cây phân loại)
                                                Control1..1
                                                Must Supporttrue
                                                Obligations
                                                  ObligationsActor
                                                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                  Pattern Value{
                                                    "coding" : [{
                                                      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs",
                                                      "code" : "aefi"
                                                    }]
                                                  }
                                                  12. AdverseEvent.event
                                                  Definition

                                                  Sự cố là GÌ. Cố ý để coding mở: TT 13/2026/TT-BYT không ban hành danh mục biểu hiện AEFI, và hướng dẫn chuyên môn của Cục Phòng bệnh chưa công bố. Khuyến nghị dùng ICD-10 hoặc SNOMED CT khi có.

                                                  ShortBiểu hiện lâm sàng của sự cố — triệu chứng hoặc chẩn đoán cụ thể
                                                  Control1..?
                                                  Must Supporttrue
                                                  Obligations
                                                    ObligationsActor
                                                    SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                    SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                    14. AdverseEvent.subject
                                                    ShortNgười được tiêm chủng gặp sự cố
                                                    TypeReference(Bệnh nhân VN Core — VN Core Patient Profile)
                                                    Must Supporttrue
                                                    Obligations
                                                      ObligationsActor
                                                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                      16. AdverseEvent.date
                                                      ShortThời điểm sự cố xảy ra
                                                      Control1..?
                                                      Must Supporttrue
                                                      Obligations
                                                        ObligationsActor
                                                        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                        18. AdverseEvent.detected
                                                        ShortThời điểm phát hiện sự cố — có thể sau thời điểm xảy ra
                                                        Must Supporttrue
                                                        Obligations
                                                          ObligationsActor
                                                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                          20. AdverseEvent.recordedDate
                                                          ShortThời điểm ghi nhận vào hồ sơ; mốc tính hạn báo cáo 24 giờ với tai biến nặng
                                                          Must Supporttrue
                                                          Obligations
                                                            ObligationsActor
                                                            SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                            SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                            22. AdverseEvent.resultingCondition
                                                            ShortDi chứng để lại — bắt buộc khi kết cục là để lại di chứng
                                                            TypeReference(Chẩn đoán VN Core — VN Core Condition Profile)
                                                            Must Supporttrue
                                                            Obligations
                                                              ObligationsActor
                                                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                              24. AdverseEvent.location
                                                              ShortNơi ghi nhận sự cố — điểm tiêm chủng hoặc cơ sở KCB tiếp nhận
                                                              Must Supporttrue
                                                              Obligations
                                                                ObligationsActor
                                                                SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                26. AdverseEvent.seriousness
                                                                Definition

                                                                Trục quyết định nghĩa vụ pháp lý: tai biến nặng kích hoạt trách nhiệm báo cáo trong 24 giờ (TT 13/2026/TT-BYT Điều 15 khoản 5 điểm a) và có thể dẫn tới bồi thường nhà nước (NĐ 165/2026/NĐ-CP Điều 50).

                                                                ShortPhân loại pháp lý: phản ứng thông thường hay tai biến nặng
                                                                Comments

                                                                0..1 chứ không 1..1 (kiểm toán 07/08/2026, mục 1.9): tại thời điểm ghi nhận ban đầu có thể CHƯA đủ căn cứ phân loại, và ép nhị phân sớm sẽ sinh dữ liệu đoán mò. VẮNG seriousness nghĩa là CHƯA PHÂN LOẠI — hệ thống tiếp nhận không được suy diễn thành phản ứng thông thường, và phải xử lý bản ghi chưa phân loại như chưa loại trừ tai biến nặng cho tới khi có phân loại. Khi kết cục đã là tử vong hoặc để lại di chứng, invariant vn-aefi-severe-outcome-seriousness buộc phân loại tai biến nặng ngay.

                                                                BindingThe codes SHALL be taken from Mức độ nghiêm trọng sự cố sau tiêm chủng — VN AEFI Seriousness ValueSet
                                                                (required to http://fhir.hl7.org.vn/core/ValueSet/vn-aefi-seriousness-vs)
                                                                Must Supporttrue
                                                                Obligations
                                                                  ObligationsActor
                                                                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                  28. AdverseEvent.severity
                                                                  ShortMức độ nặng nhẹ lâm sàng — KHÔNG thay cho seriousness
                                                                  Must Supporttrue
                                                                  Obligations
                                                                    ObligationsActor
                                                                    SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                    SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                    30. AdverseEvent.outcome
                                                                    ShortKết cục: khỏi | đang hồi phục | còn tiếp diễn | để lại di chứng | tử vong | chưa rõ
                                                                    Must Supporttrue
                                                                    Obligations
                                                                      ObligationsActor
                                                                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                      32. AdverseEvent.recorder
                                                                      ShortNgười ghi nhận báo cáo
                                                                      Must Supporttrue
                                                                      Obligations
                                                                        ObligationsActor
                                                                        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                        34. AdverseEvent.suspectEntity
                                                                        ShortMũi tiêm NGHI NGỜ gây ra sự cố — chỉ khai khi thực sự có nghi ngờ
                                                                        Comments

                                                                        0..* chứ không 1..* (kiểm toán 07/08/2026, mục 1.9): suspectEntity theo R4 là thực thể nghi gây ra sự cố; ép tối thiểu 1 biến mọi ca 'xảy ra sau tiêm' thành nghi ngờ nhân quả, trái định nghĩa AEFI tại TT 13/2026/TT-BYT Điều 2 khoản 2. Ca chưa/không nghi ngờ liên kết mũi tiêm qua extension relatedImmunization; invariant vn-aefi-immunization-linked bảo đảm luôn truy được ít nhất một mũi tiêm.

                                                                        Must Supporttrue
                                                                        Obligations
                                                                          ObligationsActor
                                                                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                          36. AdverseEvent.suspectEntity.instance
                                                                          Definition

                                                                          Chỉ trỏ tới VNCoreImmunization: đây là profile cho sự cố SAU TIÊM CHỦNG, mọi đối tượng nghi ngờ đều là một mũi tiêm đã thực hiện. Sự cố nghi do thuốc hoặc thiết bị dùng AdverseEvent gốc, không dùng profile này.

                                                                          ShortLượt tiêm chủng nghi ngờ
                                                                          TypeReference(Tiêm chủng — VN Core Immunization)
                                                                          38. AdverseEvent.suspectEntity.causality
                                                                          ShortĐánh giá nhân quả — KHÔNG bắt buộc tại thời điểm ghi nhận
                                                                          Must Supporttrue

                                                                          Guidance on how to interpret the contents of this table can be foundhere

                                                                          0. AdverseEvent
                                                                          Definition

                                                                          Actual or potential/avoided event causing unintended physical injury resulting from or contributed to by medical care, a research study or other healthcare setting factors that requires additional monitoring, treatment, or hospitalization, or that results in death.

                                                                          ShortMedical care, research study or other healthcare event causing physical injury
                                                                          Control0..*
                                                                          Is Modifierfalse
                                                                          Summaryfalse
                                                                          Alternate NamesAE
                                                                          Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
                                                                          dom-3: 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: 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: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
                                                                          dom-6: A resource should have narrative for robust management (text.`div`.exists())
                                                                          vn-aefi-immunization-linked: Báo cáo AEFI phải truy được ít nhất một mũi tiêm: qua liên kết thời gian (vn-ext-aefi-related-immunization) hoặc qua nghi ngờ nhân quả (suspectEntity). An AEFI report SHALL link at least one immunization via the temporal-association extension or suspectEntity. (extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-aefi-related-immunization').exists() or suspectEntity.where(instance.reference.exists() or instance.identifier.exists()).exists())
                                                                          vn-aefi-sequelae-resulting-condition: Kết cục để lại di chứng phải kèm bệnh/khuyết tật cụ thể. An outcome of resolvedWithSequelae SHALL reference the resulting condition. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and code = 'resolvedWithSequelae').empty() or resultingCondition.where(reference.exists() or identifier.exists()).exists())
                                                                          vn-aefi-severe-outcome-seriousness: Kết cục tử vong hoặc để lại di chứng buộc phải phân loại là tai biến nặng. A fatal or sequelae outcome SHALL be classified as a serious AEFI. (outcome.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adverse-event-outcome' and (code = 'fatal' or code = 'resolvedWithSequelae')).empty() or seriousness.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs' and code = 'serious-aefi').exists())
                                                                          2. AdverseEvent.id
                                                                          Definition

                                                                          The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

                                                                          ShortLogical id of this artifact
                                                                          Comments

                                                                          The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

                                                                          Control0..1
                                                                          Typeid
                                                                          Is Modifierfalse
                                                                          Summarytrue
                                                                          4. AdverseEvent.meta
                                                                          Definition

                                                                          The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

                                                                          ShortMetadata about the resource
                                                                          Control0..1
                                                                          TypeMeta
                                                                          Is Modifierfalse
                                                                          Summarytrue
                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          6. AdverseEvent.implicitRules
                                                                          Definition

                                                                          A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

                                                                          ShortA set of rules under which this content was created
                                                                          Comments

                                                                          Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

                                                                          Control0..1
                                                                          Typeuri
                                                                          Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                          Summarytrue
                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          8. AdverseEvent.language
                                                                          Definition

                                                                          The base language in which the resource is written.

                                                                          ShortLanguage of the resource content
                                                                          Comments

                                                                          Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

                                                                          Control0..1
                                                                          BindingThe codes SHOULD be taken from CommonLanguages
                                                                          (preferred to http://hl7.org/fhir/ValueSet/languages|4.0.1)

                                                                          A human language.

                                                                          Additional BindingsPurpose
                                                                          AllLanguagesMax Binding
                                                                          Typecode
                                                                          Is Modifierfalse
                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                          Summaryfalse
                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          10. AdverseEvent.text
                                                                          Definition

                                                                          A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

                                                                          ShortText summary of the resource, for human interpretation
                                                                          Comments

                                                                          Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

                                                                          Control0..1
                                                                          TypeNarrative
                                                                          Is Modifierfalse
                                                                          Summaryfalse
                                                                          Alternate Namesnarrative, html, xhtml, display
                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          12. AdverseEvent.contained
                                                                          Definition

                                                                          These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

                                                                          ShortContained, inline Resources
                                                                          Comments

                                                                          This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.

                                                                          Control0..*
                                                                          TypeResource
                                                                          Is Modifierfalse
                                                                          Summaryfalse
                                                                          Alternate Namesinline resources, anonymous resources, contained resources
                                                                          14. AdverseEvent.extension
                                                                          Definition

                                                                          An Extension

                                                                          ShortExtension
                                                                          Control0..*
                                                                          TypeExtension
                                                                          Is Modifierfalse
                                                                          Summaryfalse
                                                                          Invariantsele-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())
                                                                          SlicingThis element introduces a set of slices on AdverseEvent.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                                          • value @ url
                                                                          • 16. AdverseEvent.extension:relatedImmunization
                                                                            Slice NamerelatedImmunization
                                                                            Definition

                                                                            Đường liên kết trung tính cho ca chưa có (hoặc không có) nghi ngờ nhân quả — ví dụ sự cố trùng hợp do bệnh lý khác xảy ra sau tiêm. Khi có nghi ngờ nhân quả thực sự, dùng suspectEntity.

                                                                            ShortMũi tiêm liên quan theo thời gian — không hàm ý nhân quả
                                                                            Control0..*
                                                                            This element is affected by the following invariants: ele-1
                                                                            TypeExtension(Mũi tiêm liên quan theo thời gian — VN AEFI Related Immunization) (Extension Type: Reference(Tiêm chủng — VN Core Immunization))
                                                                            Is Modifierfalse
                                                                            Must Supporttrue
                                                                            Obligations
                                                                              ObligationsActor
                                                                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                              Summaryfalse
                                                                              Invariantsele-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())
                                                                              18. AdverseEvent.modifierExtension
                                                                              Definition

                                                                              May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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 is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                              ShortExtensions that cannot be ignored
                                                                              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.

                                                                              Control0..*
                                                                              TypeExtension
                                                                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
                                                                              Summaryfalse
                                                                              Requirements

                                                                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                              Alternate Namesextensions, user content
                                                                              Invariantsele-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())
                                                                              20. AdverseEvent.identifier
                                                                              Definition

                                                                              Business identifiers assigned to this adverse event by the performer or other systems which remain constant as the resource is updated and propagates from server to server.

                                                                              ShortBusiness identifier for the event
                                                                              Comments

                                                                              This is a business identifier, not a resource identifier (see discussion). It is best practice for the identifier to only appear on a single resource instance, however business practices may occasionally dictate that multiple resource instances with the same identifier can exist - possibly even with different resource types. For example, multiple Patient and a Person resource instance might share the same social insurance number.

                                                                              NoteThis is a business identifier, not a resource identifier (see discussion)
                                                                              Control0..1
                                                                              TypeIdentifier
                                                                              Is Modifierfalse
                                                                              Summarytrue
                                                                              Requirements

                                                                              Allows identification of the adverse event as it is known by various participating systems and in a way that remains consistent across servers.

                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                              22. AdverseEvent.actuality
                                                                              Definition

                                                                              Whether the event actually happened, or just had the potential to. Note that this is independent of whether anyone was affected or harmed or how severely.

                                                                              ShortLuôn là sự cố đã xảy ra
                                                                              Control1..1
                                                                              BindingThe codes SHALL be taken from AdverseEventActuality
                                                                              (required to http://hl7.org/fhir/ValueSet/adverse-event-actuality|4.0.1)

                                                                              Overall nature of the adverse event, e.g. real or potential.

                                                                              Typecode
                                                                              Is Modifiertrue because This element is labeled as a modifier because it has a potential code that indicates the adverse event did not actually happen.
                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                              Must Supporttrue
                                                                              Obligations
                                                                                ObligationsActor
                                                                                SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                Summarytrue
                                                                                Fixed Valueactual
                                                                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                24. AdverseEvent.category
                                                                                Definition

                                                                                The overall type of event, intended for search and filtering purposes.

                                                                                ShortMiền báo cáo — luôn chứa mã sự cố bất lợi sau tiêm chủng
                                                                                Control1..*
                                                                                BindingUnless not suitable, these codes SHALL be taken from AdverseEventCategory
                                                                                (extensible to http://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1)

                                                                                Overall categorization of the event, e.g. product-related or situational.

                                                                                TypeCodeableConcept
                                                                                Is Modifierfalse
                                                                                Must Supporttrue
                                                                                Obligations
                                                                                  ObligationsActor
                                                                                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                  Summarytrue
                                                                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                  SlicingThis element introduces a set of slices on AdverseEvent.category. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                                                  • pattern @ $this
                                                                                  • 26. AdverseEvent.category:aefiDomain
                                                                                    Slice NameaefiDomain
                                                                                    Definition

                                                                                    The overall type of event, intended for search and filtering purposes.

                                                                                    ShortĐánh dấu bản ghi thuộc miền AEFI (tầng cha của cây phân loại)
                                                                                    Control1..1
                                                                                    BindingUnless not suitable, these codes SHALL be taken from AdverseEventCategory
                                                                                    (extensible to http://hl7.org/fhir/ValueSet/adverse-event-category|4.0.1)

                                                                                    Overall categorization of the event, e.g. product-related or situational.

                                                                                    TypeCodeableConcept
                                                                                    Is Modifierfalse
                                                                                    Must Supporttrue
                                                                                    Obligations
                                                                                      ObligationsActor
                                                                                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                      Summarytrue
                                                                                      Pattern Value{
                                                                                        "coding" : [{
                                                                                          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-aefi-classification-cs",
                                                                                          "code" : "aefi"
                                                                                        }]
                                                                                      }
                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      28. AdverseEvent.event
                                                                                      Definition

                                                                                      Sự cố là GÌ. Cố ý để coding mở: TT 13/2026/TT-BYT không ban hành danh mục biểu hiện AEFI, và hướng dẫn chuyên môn của Cục Phòng bệnh chưa công bố. Khuyến nghị dùng ICD-10 hoặc SNOMED CT khi có.

                                                                                      ShortBiểu hiện lâm sàng của sự cố — triệu chứng hoặc chẩn đoán cụ thể
                                                                                      Control1..1
                                                                                      BindingFor example codes, see SNOMEDCTClinicalFindings
                                                                                      (example to http://hl7.org/fhir/ValueSet/adverse-event-type|4.0.1)

                                                                                      Detailed type of event.

                                                                                      TypeCodeableConcept
                                                                                      Is Modifierfalse
                                                                                      Must Supporttrue
                                                                                      Obligations
                                                                                        ObligationsActor
                                                                                        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                        Summarytrue
                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        30. AdverseEvent.subject
                                                                                        Definition

                                                                                        This subject or group impacted by the event.

                                                                                        ShortNgười được tiêm chủng gặp sự cố
                                                                                        Comments

                                                                                        If AdverseEvent.resultingCondition differs among members of the group, then use Patient as the subject.

                                                                                        Control1..1
                                                                                        TypeReference(Bệnh nhân VN Core — VN Core Patient Profile)
                                                                                        Is Modifierfalse
                                                                                        Must Supporttrue
                                                                                        Obligations
                                                                                          ObligationsActor
                                                                                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Allows for exposure of biohazard (such as legionella) to a group of individuals in a hospital.

                                                                                          Alternate Namespatient
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          32. AdverseEvent.encounter
                                                                                          Definition

                                                                                          The Encounter during which AdverseEvent was created or to which the creation of this record is tightly associated.

                                                                                          ShortEncounter created as part of
                                                                                          Comments

                                                                                          This will typically be the encounter the event occurred within, but some activities may be initiated prior to or after the official completion of an encounter but still be tied to the context of the encounter. For example, if a medication administration was considered an adverse event because it resulted in a rash, then the encounter when the medication administration was given is the context. If the patient reports the AdverseEvent during a second encounter, that second encounter is not the context.

                                                                                          Control0..1
                                                                                          TypeReference(Encounter)
                                                                                          Is Modifierfalse
                                                                                          Summarytrue
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          34. AdverseEvent.date
                                                                                          Definition

                                                                                          The date (and perhaps time) when the adverse event occurred.

                                                                                          ShortThời điểm sự cố xảy ra
                                                                                          Control1..1
                                                                                          TypedateTime
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Must Supporttrue
                                                                                          Obligations
                                                                                            ObligationsActor
                                                                                            SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                            SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                            Summarytrue
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            36. AdverseEvent.detected
                                                                                            Definition

                                                                                            Estimated or actual date the AdverseEvent began, in the opinion of the reporter.

                                                                                            ShortThời điểm phát hiện sự cố — có thể sau thời điểm xảy ra
                                                                                            Control0..1
                                                                                            TypedateTime
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Must Supporttrue
                                                                                            Obligations
                                                                                              ObligationsActor
                                                                                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                              Summarytrue
                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              38. AdverseEvent.recordedDate
                                                                                              Definition

                                                                                              The date on which the existence of the AdverseEvent was first recorded.

                                                                                              ShortThời điểm ghi nhận vào hồ sơ; mốc tính hạn báo cáo 24 giờ với tai biến nặng
                                                                                              Comments

                                                                                              The recordedDate represents the date when this particular AdverseEvent record was created in the system, not the date of the most recent update. The date of the last record modification can be retrieved from the resource metadata.

                                                                                              Control0..1
                                                                                              TypedateTime
                                                                                              Is Modifierfalse
                                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                              Must Supporttrue
                                                                                              Obligations
                                                                                                ObligationsActor
                                                                                                SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                Summarytrue
                                                                                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                40. AdverseEvent.resultingCondition
                                                                                                Definition

                                                                                                Includes information about the reaction that occurred as a result of exposure to a substance (for example, a drug or a chemical).

                                                                                                ShortDi chứng để lại — bắt buộc khi kết cục là để lại di chứng
                                                                                                Control0..*
                                                                                                TypeReference(Chẩn đoán VN Core — VN Core Condition Profile)
                                                                                                Is Modifierfalse
                                                                                                Must Supporttrue
                                                                                                Obligations
                                                                                                  ObligationsActor
                                                                                                  SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                  SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                  Summarytrue
                                                                                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                  42. AdverseEvent.location
                                                                                                  Definition

                                                                                                  The information about where the adverse event occurred.

                                                                                                  ShortNơi ghi nhận sự cố — điểm tiêm chủng hoặc cơ sở KCB tiếp nhận
                                                                                                  Control0..1
                                                                                                  TypeReference(Location)
                                                                                                  Is Modifierfalse
                                                                                                  Must Supporttrue
                                                                                                  Obligations
                                                                                                    ObligationsActor
                                                                                                    SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                    SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                    Summarytrue
                                                                                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                    44. AdverseEvent.seriousness
                                                                                                    Definition

                                                                                                    Trục quyết định nghĩa vụ pháp lý: tai biến nặng kích hoạt trách nhiệm báo cáo trong 24 giờ (TT 13/2026/TT-BYT Điều 15 khoản 5 điểm a) và có thể dẫn tới bồi thường nhà nước (NĐ 165/2026/NĐ-CP Điều 50).

                                                                                                    ShortPhân loại pháp lý: phản ứng thông thường hay tai biến nặng
                                                                                                    Comments

                                                                                                    0..1 chứ không 1..1 (kiểm toán 07/08/2026, mục 1.9): tại thời điểm ghi nhận ban đầu có thể CHƯA đủ căn cứ phân loại, và ép nhị phân sớm sẽ sinh dữ liệu đoán mò. VẮNG seriousness nghĩa là CHƯA PHÂN LOẠI — hệ thống tiếp nhận không được suy diễn thành phản ứng thông thường, và phải xử lý bản ghi chưa phân loại như chưa loại trừ tai biến nặng cho tới khi có phân loại. Khi kết cục đã là tử vong hoặc để lại di chứng, invariant vn-aefi-severe-outcome-seriousness buộc phân loại tai biến nặng ngay.

                                                                                                    Control0..1
                                                                                                    BindingThe codes SHALL be taken from Mức độ nghiêm trọng sự cố sau tiêm chủng — VN AEFI Seriousness ValueSet
                                                                                                    (required to http://fhir.hl7.org.vn/core/ValueSet/vn-aefi-seriousness-vs)
                                                                                                    TypeCodeableConcept
                                                                                                    Is Modifierfalse
                                                                                                    Must Supporttrue
                                                                                                    Obligations
                                                                                                      ObligationsActor
                                                                                                      SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                      SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                      Summarytrue
                                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                      46. AdverseEvent.severity
                                                                                                      Definition

                                                                                                      Describes the severity of the adverse event, in relation to the subject. Contrast to AdverseEvent.seriousness - a severe rash might not be serious, but a mild heart problem is.

                                                                                                      ShortMức độ nặng nhẹ lâm sàng — KHÔNG thay cho seriousness
                                                                                                      Control0..1
                                                                                                      BindingThe codes SHALL be taken from AdverseEventSeverity
                                                                                                      (required to http://hl7.org/fhir/ValueSet/adverse-event-severity|4.0.1)

                                                                                                      The severity of the adverse event itself, in direct relation to the subject.

                                                                                                      TypeCodeableConcept
                                                                                                      Is Modifierfalse
                                                                                                      Must Supporttrue
                                                                                                      Obligations
                                                                                                        ObligationsActor
                                                                                                        SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                        SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                        Summarytrue
                                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                        48. AdverseEvent.outcome
                                                                                                        Definition

                                                                                                        Describes the type of outcome from the adverse event.

                                                                                                        ShortKết cục: khỏi | đang hồi phục | còn tiếp diễn | để lại di chứng | tử vong | chưa rõ
                                                                                                        Control0..1
                                                                                                        BindingThe codes SHALL be taken from AdverseEventOutcome
                                                                                                        (required to http://hl7.org/fhir/ValueSet/adverse-event-outcome|4.0.1)

                                                                                                        TODO (and should this be required?).

                                                                                                        TypeCodeableConcept
                                                                                                        Is Modifierfalse
                                                                                                        Must Supporttrue
                                                                                                        Obligations
                                                                                                          ObligationsActor
                                                                                                          SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                          SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                          Summarytrue
                                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                          50. AdverseEvent.recorder
                                                                                                          Definition

                                                                                                          Information on who recorded the adverse event. May be the patient or a practitioner.

                                                                                                          ShortNgười ghi nhận báo cáo
                                                                                                          Control0..1
                                                                                                          TypeReference(Patient, Practitioner, PractitionerRole, RelatedPerson)
                                                                                                          Is Modifierfalse
                                                                                                          Must Supporttrue
                                                                                                          Must Support TypesNo must-support rules about the choice of types/profiles
                                                                                                          Obligations
                                                                                                            ObligationsActor
                                                                                                            SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                            SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                            Summarytrue
                                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                            52. AdverseEvent.contributor
                                                                                                            Definition

                                                                                                            Parties that may or should contribute or have contributed information to the adverse event, which can consist of one or more activities. Such information includes information leading to the decision to perform the activity and how to perform the activity (e.g. consultant), information that the activity itself seeks to reveal (e.g. informant of clinical history), or information about what activity was performed (e.g. informant witness).

                                                                                                            ShortWho was involved in the adverse event or the potential adverse event
                                                                                                            Control0..*
                                                                                                            TypeReference(Practitioner, PractitionerRole, Device)
                                                                                                            Is Modifierfalse
                                                                                                            Summarytrue
                                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                            54. AdverseEvent.suspectEntity
                                                                                                            Definition

                                                                                                            Describes the entity that is suspected to have caused the adverse event.

                                                                                                            ShortMũi tiêm NGHI NGỜ gây ra sự cố — chỉ khai khi thực sự có nghi ngờ
                                                                                                            Comments

                                                                                                            0..* chứ không 1..* (kiểm toán 07/08/2026, mục 1.9): suspectEntity theo R4 là thực thể nghi gây ra sự cố; ép tối thiểu 1 biến mọi ca 'xảy ra sau tiêm' thành nghi ngờ nhân quả, trái định nghĩa AEFI tại TT 13/2026/TT-BYT Điều 2 khoản 2. Ca chưa/không nghi ngờ liên kết mũi tiêm qua extension relatedImmunization; invariant vn-aefi-immunization-linked bảo đảm luôn truy được ít nhất một mũi tiêm.

                                                                                                            Control0..*
                                                                                                            TypeBackboneElement
                                                                                                            Is Modifierfalse
                                                                                                            Must Supporttrue
                                                                                                            Obligations
                                                                                                              ObligationsActor
                                                                                                              SHALL:populate-if-knownNguồn tạo hồ sơ lâm sàng (Document Source)
                                                                                                              SHALL:no-error & SHALL:persistKho hồ sơ EMR (Repository)
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              56. AdverseEvent.suspectEntity.id
                                                                                                              Definition

                                                                                                              Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                                              ShortUnique id for inter-element referencing
                                                                                                              Control0..1
                                                                                                              Typestring
                                                                                                              Is Modifierfalse
                                                                                                              XML FormatIn the XML format, this property is represented as an attribute.
                                                                                                              Summaryfalse
                                                                                                              58. AdverseEvent.suspectEntity.extension
                                                                                                              Definition

                                                                                                              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.

                                                                                                              ShortAdditional 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.

                                                                                                              Control0..*
                                                                                                              TypeExtension
                                                                                                              Is Modifierfalse
                                                                                                              Summaryfalse
                                                                                                              Alternate Namesextensions, user content
                                                                                                              Invariantsele-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())
                                                                                                              60. AdverseEvent.suspectEntity.modifierExtension
                                                                                                              Definition

                                                                                                              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions.

                                                                                                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                                              ShortExtensions that cannot be ignored even if unrecognized
                                                                                                              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.

                                                                                                              Control0..*
                                                                                                              TypeExtension
                                                                                                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                                              Summarytrue
                                                                                                              Requirements

                                                                                                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                                              Alternate Namesextensions, user content, modifiers
                                                                                                              Invariantsele-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())
                                                                                                              62. AdverseEvent.suspectEntity.instance
                                                                                                              Definition

                                                                                                              Chỉ trỏ tới VNCoreImmunization: đây là profile cho sự cố SAU TIÊM CHỦNG, mọi đối tượng nghi ngờ đều là một mũi tiêm đã thực hiện. Sự cố nghi do thuốc hoặc thiết bị dùng AdverseEvent gốc, không dùng profile này.

                                                                                                              ShortLượt tiêm chủng nghi ngờ
                                                                                                              Control1..1
                                                                                                              TypeReference(Tiêm chủng — VN Core Immunization)
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Alternate NamesSubstance or Medication or Device
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              64. AdverseEvent.suspectEntity.causality
                                                                                                              Definition

                                                                                                              Information on the possible cause of the event.

                                                                                                              ShortĐánh giá nhân quả — KHÔNG bắt buộc tại thời điểm ghi nhận
                                                                                                              Control0..*
                                                                                                              TypeBackboneElement
                                                                                                              Is Modifierfalse
                                                                                                              Must Supporttrue
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              66. AdverseEvent.suspectEntity.causality.id
                                                                                                              Definition

                                                                                                              Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                                              ShortUnique id for inter-element referencing
                                                                                                              Control0..1
                                                                                                              Typestring
                                                                                                              Is Modifierfalse
                                                                                                              XML FormatIn the XML format, this property is represented as an attribute.
                                                                                                              Summaryfalse
                                                                                                              68. AdverseEvent.suspectEntity.causality.extension
                                                                                                              Definition

                                                                                                              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.

                                                                                                              ShortAdditional 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.

                                                                                                              Control0..*
                                                                                                              TypeExtension
                                                                                                              Is Modifierfalse
                                                                                                              Summaryfalse
                                                                                                              Alternate Namesextensions, user content
                                                                                                              Invariantsele-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())
                                                                                                              70. AdverseEvent.suspectEntity.causality.modifierExtension
                                                                                                              Definition

                                                                                                              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions.

                                                                                                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                                              ShortExtensions that cannot be ignored even if unrecognized
                                                                                                              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.

                                                                                                              Control0..*
                                                                                                              TypeExtension
                                                                                                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                                              Summarytrue
                                                                                                              Requirements

                                                                                                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                                              Alternate Namesextensions, user content, modifiers
                                                                                                              Invariantsele-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())
                                                                                                              72. AdverseEvent.suspectEntity.causality.assessment
                                                                                                              Definition

                                                                                                              Assessment of if the entity caused the event.

                                                                                                              ShortAssessment of if the entity caused the event
                                                                                                              Control0..1
                                                                                                              BindingFor example codes, see AdverseEventCausalityAssessment
                                                                                                              (example to http://hl7.org/fhir/ValueSet/adverse-event-causality-assess|4.0.1)

                                                                                                              Codes for the assessment of whether the entity caused the event.

                                                                                                              TypeCodeableConcept
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              74. AdverseEvent.suspectEntity.causality.productRelatedness
                                                                                                              Definition

                                                                                                              AdverseEvent.suspectEntity.causalityProductRelatedness.

                                                                                                              ShortAdverseEvent.suspectEntity.causalityProductRelatedness
                                                                                                              Control0..1
                                                                                                              Typestring
                                                                                                              Is Modifierfalse
                                                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              76. AdverseEvent.suspectEntity.causality.author
                                                                                                              Definition

                                                                                                              AdverseEvent.suspectEntity.causalityAuthor.

                                                                                                              ShortAdverseEvent.suspectEntity.causalityAuthor
                                                                                                              Control0..1
                                                                                                              TypeReference(Practitioner, PractitionerRole)
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              78. AdverseEvent.suspectEntity.causality.method
                                                                                                              Definition

                                                                                                              ProbabilityScale | Bayesian | Checklist.

                                                                                                              ShortProbabilityScale | Bayesian | Checklist
                                                                                                              Control0..1
                                                                                                              BindingFor example codes, see AdverseEventCausalityMethod
                                                                                                              (example to http://hl7.org/fhir/ValueSet/adverse-event-causality-method|4.0.1)

                                                                                                              TODO.

                                                                                                              TypeCodeableConcept
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              80. AdverseEvent.subjectMedicalHistory
                                                                                                              Definition

                                                                                                              AdverseEvent.subjectMedicalHistory.

                                                                                                              ShortAdverseEvent.subjectMedicalHistory
                                                                                                              Control0..*
                                                                                                              TypeReference(Condition, Observation, AllergyIntolerance, FamilyMemberHistory, Immunization, Procedure, Media, DocumentReference)
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              82. AdverseEvent.referenceDocument
                                                                                                              Definition

                                                                                                              AdverseEvent.referenceDocument.

                                                                                                              ShortAdverseEvent.referenceDocument
                                                                                                              Control0..*
                                                                                                              TypeReference(DocumentReference)
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                                              84. AdverseEvent.study
                                                                                                              Definition

                                                                                                              AdverseEvent.study.

                                                                                                              ShortAdverseEvent.study
                                                                                                              Control0..*
                                                                                                              TypeReference(ResearchStudy)
                                                                                                              Is Modifierfalse
                                                                                                              Summarytrue
                                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))