Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreAllergyIntolerance | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.22 | |||||
Profile AllergyIntolerance cho ghi nhận dị ứng và bất dung nạp tại Việt Nam. Sử dụng SNOMED CT IPS Terminology (miễn phí, CC-BY-4.0) cho mã hoá chất gây dị ứng. Việt Nam không có bộ mã dị ứng quốc gia riêng, nhưng QĐ 2805/QĐ-BYT (04/9/2025) đã ban hành danh mục 1.327 mã SNOMED CT nhánh dị ứng kèm tên tiếng Việt chính thức — xem VNTranslatedAllergyCodeVS. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật 15/2023/QH15, QĐ 2805/QĐ-BYT (Đợt 3 — nhánh dị ứng).
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
  AllergyIntolerance |
||||
  clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
 type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
 patient |
|
| ||
| recordedDate |
|
| ||
 reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.clinicalStatus | Base | required | AllergyIntolerance Clinical Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.verificationStatus | Base | required | AllergyIntolerance Verification Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.type | Base | required | AllergyIntoleranceType | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.category | Base | required | AllergyIntoleranceCategory | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.criticality | Base | required | AllergyIntoleranceCriticality | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
| AllergyIntolerance.reaction.substance | Base | example | Substance Code | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.manifestation | Base | example | SNOMED CT Clinical Findings | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.severity | Base | required | AllergyIntoleranceSeverity | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ait-1 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error. |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').exists() or clinicalStatus.exists()
|
| ait-2 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').empty() or clinicalStatus.empty()
|
| dom-2 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | AllergyIntolerance | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter:   | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AllergyIntolerance |
0..* | AllergyIntolerance | Allergy or Intolerance (generally: Risk of adverse reaction to a substance) | |||||||||||
 clinicalStatus |
SO | 0..1 | CodeableConcept | Trạng thái lâm sàng (active, inactive, resolved)
| ||||||||||
| verificationStatus |
SO | 0..1 | CodeableConcept | Trạng thái xác minh
| ||||||||||
| type |
SO | 0..1 | code | Loại: dị ứng (allergy) hay bất dung nạp (intolerance)
| ||||||||||
| category |
SO | 0..* | code | Phân loại: thức ăn, thuốc, môi trường, sinh học
| ||||||||||
| criticality |
SO | 0..1 | code | Mức độ nguy hiểm (low, high, unable-to-assess)
| ||||||||||
| code |
SO | 1..1 | CodeableConcept | Chất gây dị ứng/bất dung nạp Binding: Mã dị ứng — VN Core Allergy Code ValueSet (extensible)
| ||||||||||
| patient |
SO | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân
| ||||||||||
| encounter |
0..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám phát hiện dị ứng | |||||||||||
| onset[x] |
0..1 | dateTime, Age, Period, Range, string | Thời điểm khởi phát | |||||||||||
| recordedDate |
SO | 0..1 | dateTime | Ngày ghi nhận
| ||||||||||
| recorder |
0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile) | Người ghi nhận | |||||||||||
 reaction |
SO | 0..* | BackboneElement | Phản ứng dị ứng cụ thể
| ||||||||||
 substance |
0..1 | CodeableConcept | Chất cụ thể gây phản ứng | |||||||||||
| manifestation |
S | 1..* | CodeableConcept | Biểu hiện lâm sàng (buồn nôn, ban đỏ, phù nề...) | ||||||||||
| severity |
S | 0..1 | code | Mức độ (mild, moderate, severe) | ||||||||||
| Documentation for this format | ||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AllergyIntolerance |
C | 0..* | AllergyIntolerance | Allergy or Intolerance (generally: Risk of adverse reaction to a substance) Constraints: ait-1, ait-2 | ||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||||
 extension |
0..* | Extension | Additional content defined by implementations | |||||||||||
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||||
| identifier |
Σ | 0..* | Identifier | External ids for this item | ||||||||||
| clinicalStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái lâm sàng (active, inactive, resolved) Binding: AllergyIntoleranceClinicalStatusCodes (required): The clinical status of the allergy or intolerance.
| ||||||||||
| verificationStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái xác minh Binding: AllergyIntoleranceVerificationStatusCodes (required): Assertion about certainty associated with a propensity, or potential risk, of a reaction to the identified substance.
| ||||||||||
| type |
SOΣ | 0..1 | code | Loại: dị ứng (allergy) hay bất dung nạp (intolerance) Binding: AllergyIntoleranceType (required): Identification of the underlying physiological mechanism for a Reaction Risk.
| ||||||||||
| category |
SOΣ | 0..* | code | Phân loại: thức ăn, thuốc, môi trường, sinh học Binding: AllergyIntoleranceCategory (required): Category of an identified substance associated with allergies or intolerances.
| ||||||||||
| criticality |
SOΣ | 0..1 | code | Mức độ nguy hiểm (low, high, unable-to-assess) Binding: AllergyIntoleranceCriticality (required): Estimate of the potential clinical harm, or seriousness, of a reaction to an identified substance.
| ||||||||||
| code |
SOΣ | 1..1 | CodeableConcept | Chất gây dị ứng/bất dung nạp Binding: Mã dị ứng — VN Core Allergy Code ValueSet (extensible)
| ||||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân
| ||||||||||
| encounter |
0..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám phát hiện dị ứng | |||||||||||
  onset[x] |
0..1 | Thời điểm khởi phát | ||||||||||||
 onsetDateTime |
dateTime | |||||||||||||
| onsetAge |
Age | |||||||||||||
| onsetPeriod |
Period | |||||||||||||
| onsetRange |
Range | |||||||||||||
| onsetString |
string | |||||||||||||
| recordedDate |
SO | 0..1 | dateTime | Ngày ghi nhận
| ||||||||||
| recorder |
0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile) | Người ghi nhận | |||||||||||
| asserter |
Σ | 0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole) | Source of the information about the allergy | ||||||||||
| lastOccurrence |
0..1 | dateTime | Date(/time) of last known occurrence of a reaction | |||||||||||
| note |
0..* | Annotation | Additional text not captured in other fields | |||||||||||
| reaction |
SO | 0..* | BackboneElement | Phản ứng dị ứng cụ thể
| ||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||||
| substance |
0..1 | CodeableConcept | Chất cụ thể gây phản ứng Binding: SubstanceCode (example): Codes defining the type of the substance (including pharmaceutical products). | |||||||||||
| manifestation |
S | 1..* | CodeableConcept | Biểu hiện lâm sàng (buồn nôn, ban đỏ, phù nề...) Binding: SNOMEDCTClinicalFindings (example): Clinical symptoms and/or signs that are observed or associated with an Adverse Reaction Event. | ||||||||||
| description |
0..1 | string | Description of the event as a whole | |||||||||||
| onset |
0..1 | dateTime | Date(/time) when manifestations showed | |||||||||||
| severity |
S | 0..1 | code | Mức độ (mild, moderate, severe) Binding: AllergyIntoleranceSeverity (required): Clinical assessment of the severity of a reaction event as a whole, potentially considering multiple different manifestations. | ||||||||||
| exposureRoute |
0..1 | CodeableConcept | How the subject was exposed to the substance Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | |||||||||||
| note |
0..* | Annotation | Text about event not captured in other fields | |||||||||||
| Documentation for this format | ||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.clinicalStatus | Base | required | AllergyIntolerance Clinical Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.verificationStatus | Base | required | AllergyIntolerance Verification Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.type | Base | required | AllergyIntoleranceType | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.category | Base | required | AllergyIntoleranceCategory | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.criticality | Base | required | AllergyIntoleranceCriticality | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
| AllergyIntolerance.reaction.substance | Base | example | Substance Code | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.manifestation | Base | example | SNOMED CT Clinical Findings | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.severity | Base | required | AllergyIntoleranceSeverity | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.exposureRoute | Base | example | SNOMED CT Route Codes | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ait-1 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error. |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').exists() or clinicalStatus.exists()
|
| ait-2 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').empty() or clinicalStatus.empty()
|
| dom-2 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | AllergyIntolerance | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
Summary
Mandatory: 1 element
Must-Support: 11 elements
Structures
This structure refers to these other structures:
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AllergyIntolerance |
C | 0..* | AllergyIntolerance | Allergy or Intolerance (generally: Risk of adverse reaction to a substance) Constraints: ait-1, ait-2 | ||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||||
| clinicalStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái lâm sàng (active, inactive, resolved) Binding: AllergyIntoleranceClinicalStatusCodes (required): The clinical status of the allergy or intolerance.
| ||||||||||
| verificationStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái xác minh Binding: AllergyIntoleranceVerificationStatusCodes (required): Assertion about certainty associated with a propensity, or potential risk, of a reaction to the identified substance.
| ||||||||||
| type |
SOΣ | 0..1 | code | Loại: dị ứng (allergy) hay bất dung nạp (intolerance) Binding: AllergyIntoleranceType (required): Identification of the underlying physiological mechanism for a Reaction Risk.
| ||||||||||
| category |
SOΣ | 0..* | code | Phân loại: thức ăn, thuốc, môi trường, sinh học Binding: AllergyIntoleranceCategory (required): Category of an identified substance associated with allergies or intolerances.
| ||||||||||
| criticality |
SOΣ | 0..1 | code | Mức độ nguy hiểm (low, high, unable-to-assess) Binding: AllergyIntoleranceCriticality (required): Estimate of the potential clinical harm, or seriousness, of a reaction to an identified substance.
| ||||||||||
| code |
SOΣ | 1..1 | CodeableConcept | Chất gây dị ứng/bất dung nạp Binding: Mã dị ứng — VN Core Allergy Code ValueSet (extensible)
| ||||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân
| ||||||||||
| encounter |
0..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám phát hiện dị ứng | |||||||||||
| onset[x] |
0..1 | Thời điểm khởi phát | ||||||||||||
| onsetDateTime |
dateTime | |||||||||||||
| onsetAge |
Age | |||||||||||||
| onsetPeriod |
Period | |||||||||||||
| onsetRange |
Range | |||||||||||||
| onsetString |
string | |||||||||||||
| recordedDate |
SO | 0..1 | dateTime | Ngày ghi nhận
| ||||||||||
| recorder |
0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile) | Người ghi nhận | |||||||||||
| reaction |
SO | 0..* | BackboneElement | Phản ứng dị ứng cụ thể
| ||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||||
| substance |
0..1 | CodeableConcept | Chất cụ thể gây phản ứng Binding: SubstanceCode (example): Codes defining the type of the substance (including pharmaceutical products). | |||||||||||
| manifestation |
S | 1..* | CodeableConcept | Biểu hiện lâm sàng (buồn nôn, ban đỏ, phù nề...) Binding: SNOMEDCTClinicalFindings (example): Clinical symptoms and/or signs that are observed or associated with an Adverse Reaction Event. | ||||||||||
| severity |
S | 0..1 | code | Mức độ (mild, moderate, severe) Binding: AllergyIntoleranceSeverity (required): Clinical assessment of the severity of a reaction event as a whole, potentially considering multiple different manifestations. | ||||||||||
| Documentation for this format | ||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.clinicalStatus | Base | required | AllergyIntolerance Clinical Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.verificationStatus | Base | required | AllergyIntolerance Verification Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.type | Base | required | AllergyIntoleranceType | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.category | Base | required | AllergyIntoleranceCategory | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.criticality | Base | required | AllergyIntoleranceCriticality | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
| AllergyIntolerance.reaction.substance | Base | example | Substance Code | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.manifestation | Base | example | SNOMED CT Clinical Findings | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.severity | Base | required | AllergyIntoleranceSeverity | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ait-1 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error. |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').exists() or clinicalStatus.exists()
|
| ait-2 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').empty() or clinicalStatus.empty()
|
| dom-2 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | AllergyIntolerance | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Dạng xem Differential
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AllergyIntolerance |
0..* | AllergyIntolerance | Allergy or Intolerance (generally: Risk of adverse reaction to a substance) | |||||||||||
| clinicalStatus |
SO | 0..1 | CodeableConcept | Trạng thái lâm sàng (active, inactive, resolved)
| ||||||||||
| verificationStatus |
SO | 0..1 | CodeableConcept | Trạng thái xác minh
| ||||||||||
| type |
SO | 0..1 | code | Loại: dị ứng (allergy) hay bất dung nạp (intolerance)
| ||||||||||
| category |
SO | 0..* | code | Phân loại: thức ăn, thuốc, môi trường, sinh học
| ||||||||||
| criticality |
SO | 0..1 | code | Mức độ nguy hiểm (low, high, unable-to-assess)
| ||||||||||
| code |
SO | 1..1 | CodeableConcept | Chất gây dị ứng/bất dung nạp Binding: Mã dị ứng — VN Core Allergy Code ValueSet (extensible)
| ||||||||||
| patient |
SO | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân
| ||||||||||
| encounter |
0..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám phát hiện dị ứng | |||||||||||
| onset[x] |
0..1 | dateTime, Age, Period, Range, string | Thời điểm khởi phát | |||||||||||
| recordedDate |
SO | 0..1 | dateTime | Ngày ghi nhận
| ||||||||||
| recorder |
0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile) | Người ghi nhận | |||||||||||
| reaction |
SO | 0..* | BackboneElement | Phản ứng dị ứng cụ thể
| ||||||||||
| substance |
0..1 | CodeableConcept | Chất cụ thể gây phản ứng | |||||||||||
| manifestation |
S | 1..* | CodeableConcept | Biểu hiện lâm sàng (buồn nôn, ban đỏ, phù nề...) | ||||||||||
| severity |
S | 0..1 | code | Mức độ (mild, moderate, severe) | ||||||||||
| Documentation for this format | ||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AllergyIntolerance |
C | 0..* | AllergyIntolerance | Allergy or Intolerance (generally: Risk of adverse reaction to a substance) Constraints: ait-1, ait-2 | ||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||||
| identifier |
Σ | 0..* | Identifier | External ids for this item | ||||||||||
| clinicalStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái lâm sàng (active, inactive, resolved) Binding: AllergyIntoleranceClinicalStatusCodes (required): The clinical status of the allergy or intolerance.
| ||||||||||
| verificationStatus |
?!SOΣC | 0..1 | CodeableConcept | Trạng thái xác minh Binding: AllergyIntoleranceVerificationStatusCodes (required): Assertion about certainty associated with a propensity, or potential risk, of a reaction to the identified substance.
| ||||||||||
| type |
SOΣ | 0..1 | code | Loại: dị ứng (allergy) hay bất dung nạp (intolerance) Binding: AllergyIntoleranceType (required): Identification of the underlying physiological mechanism for a Reaction Risk.
| ||||||||||
| category |
SOΣ | 0..* | code | Phân loại: thức ăn, thuốc, môi trường, sinh học Binding: AllergyIntoleranceCategory (required): Category of an identified substance associated with allergies or intolerances.
| ||||||||||
| criticality |
SOΣ | 0..1 | code | Mức độ nguy hiểm (low, high, unable-to-assess) Binding: AllergyIntoleranceCriticality (required): Estimate of the potential clinical harm, or seriousness, of a reaction to an identified substance.
| ||||||||||
| code |
SOΣ | 1..1 | CodeableConcept | Chất gây dị ứng/bất dung nạp Binding: Mã dị ứng — VN Core Allergy Code ValueSet (extensible)
| ||||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân
| ||||||||||
| encounter |
0..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám phát hiện dị ứng | |||||||||||
| onset[x] |
0..1 | Thời điểm khởi phát | ||||||||||||
| onsetDateTime |
dateTime | |||||||||||||
| onsetAge |
Age | |||||||||||||
| onsetPeriod |
Period | |||||||||||||
| onsetRange |
Range | |||||||||||||
| onsetString |
string | |||||||||||||
| recordedDate |
SO | 0..1 | dateTime | Ngày ghi nhận
| ||||||||||
| recorder |
0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile) | Người ghi nhận | |||||||||||
| asserter |
Σ | 0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole) | Source of the information about the allergy | ||||||||||
| lastOccurrence |
0..1 | dateTime | Date(/time) of last known occurrence of a reaction | |||||||||||
| note |
0..* | Annotation | Additional text not captured in other fields | |||||||||||
| reaction |
SO | 0..* | BackboneElement | Phản ứng dị ứng cụ thể
| ||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||||
| substance |
0..1 | CodeableConcept | Chất cụ thể gây phản ứng Binding: SubstanceCode (example): Codes defining the type of the substance (including pharmaceutical products). | |||||||||||
| manifestation |
S | 1..* | CodeableConcept | Biểu hiện lâm sàng (buồn nôn, ban đỏ, phù nề...) Binding: SNOMEDCTClinicalFindings (example): Clinical symptoms and/or signs that are observed or associated with an Adverse Reaction Event. | ||||||||||
| description |
0..1 | string | Description of the event as a whole | |||||||||||
| onset |
0..1 | dateTime | Date(/time) when manifestations showed | |||||||||||
| severity |
S | 0..1 | code | Mức độ (mild, moderate, severe) Binding: AllergyIntoleranceSeverity (required): Clinical assessment of the severity of a reaction event as a whole, potentially considering multiple different manifestations. | ||||||||||
| exposureRoute |
0..1 | CodeableConcept | How the subject was exposed to the substance Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | |||||||||||
| note |
0..* | Annotation | Text about event not captured in other fields | |||||||||||
| Documentation for this format | ||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| AllergyIntolerance.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.clinicalStatus | Base | required | AllergyIntolerance Clinical Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.verificationStatus | Base | required | AllergyIntolerance Verification Status Codes | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.type | Base | required | AllergyIntoleranceType | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.category | Base | required | AllergyIntoleranceCategory | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.criticality | Base | required | AllergyIntoleranceCriticality | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.code | Base | extensible | Mã dị ứng — VN Core Allergy Code ValueSet | 📦0.10.0 | This IG |
| AllergyIntolerance.reaction.substance | Base | example | Substance Code | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.manifestation | Base | example | SNOMED CT Clinical Findings | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.severity | Base | required | AllergyIntoleranceSeverity | 📍4.0.1 | FHIR Std. |
| AllergyIntolerance.reaction.exposureRoute | Base | example | SNOMED CT Route Codes | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ait-1 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error. |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').exists() or clinicalStatus.exists()
|
| ait-2 | error | AllergyIntolerance | AllergyIntolerance.clinicalStatus SHALL NOT be present if verification Status is entered-in-error |
verificationStatus.coding.where(system = 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification' and code = 'entered-in-error').empty() or clinicalStatus.empty()
|
| dom-2 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | AllergyIntolerance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | AllergyIntolerance | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | AllergyIntolerance | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|
| AllergyIntolerance |
||||
| clinicalStatus |
|
| ||
| verificationStatus |
|
| ||
| type |
|
| ||
| category |
|
| ||
| criticality |
|
| ||
| code |
|
| ||
| patient |
|
| ||
| recordedDate |
|
| ||
| reaction |
|
| ||
| Documentation for this format | ||||
Summary
Mandatory: 1 element
Must-Support: 11 elements
Structures
This structure refers to these other structures:
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron
