{
  "resourceType": "StructureDefinition",
  "id": "allergyintolerance-ca-ps",
  "url": "http://fhir.infoway-inforoute.ca/io/psca/StructureDefinition/allergyintolerance-ca-ps",
  "name": "AllergyIntolerancePSCA",
  "title": "Allergy Intolerance (PS-CA)",
  "status": "draft",
  "experimental": false,
  "date": "2023-12-08T08:00:00+00:00",
  "description": "This profile represents the constraints applied to the Allergyintolerance resource by the PS-CA project, which is informed by the constraints of the [AllergyIntolerance IPS-UV profile](http://hl7.org/fhir/uv/ips/StructureDefinition-AllergyIntolerance-uv-ips.html) and the [Canadian Baseline Profile](http://build.fhir.org/ig/HL7-Canada/ca-baseline/branches/master/StructureDefinition-profile-allergyintolerance.html) to allow for cross-border and cross-jurisdiction sharing of Allergies and Intolerances. It documents the relevant allergies or intolerances (conditions) for a patient, describing the kind of reaction (e.g. rash, anaphylaxis,..); preferably the agents that cause it; and optionally the criticality and the certainty of the allergy.",
  "copyright": "Copyright © 2021,2022 Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "AllergyIntolerance",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "AllergyIntolerance.extension",
        "path": "AllergyIntolerance.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        }
      },
      {
        "id": "AllergyIntolerance.extension:abatement-datetime",
        "path": "AllergyIntolerance.extension",
        "sliceName": "abatement-datetime",
        "short": "Extension for representing Abatement datetime",
        "definition": "The date or estimated date that the condition resolved or went into remission.",
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/uv/ips/StructureDefinition/abatement-dateTime-uv-ips"
            ]
          }
        ]
      },
      {
        "id": "AllergyIntolerance.clinicalStatus",
        "path": "AllergyIntolerance.clinicalStatus",
        "comment": "IPS-UV no longer flags this as a Must Support Element. It is not currently flagged as Must Support in PS-CA, as stakeholders have indicated the element may not be supported by the majority of systems today. Systems that do support the element are encouraged to include it in generated Patient Summary documents, and support it when received.\n\nFHIR Base Note: This element is a modifier element with a required vocabulary binding in the base FHIR specification.\n\nIPS-UV Note: In the scope of the IPS-UV the entered-in-error concept is not allowed and so the modifier on this element has been removed."
      },
      {
        "id": "AllergyIntolerance.clinicalStatus.coding",
        "path": "AllergyIntolerance.clinicalStatus.coding",
        "comment": "Many Canadian systems currently use the [AllergyIntoleranceStatusCode](https://tgateway.infoway-inforoute.ca/vs/allergyintolerancestatuscode) value set comprised of SNOMED CT codes. Additionally, some Canadian systems that have implemented HL7 V3 are currently using [HL7 v3 Value Set ActStatus](http://hl7.org/fhir/R4/v3/ActStatus/vs.html). Both can be mapped and provided as additional codings to the required FHIR allergyIntolerance clinicalStatus codes. The element is sliced to express the required population of at least the HL7AllergyIntoleranceClinicalStatus slice since it is a required coding.",
        "slicing": {
          "discriminator": [
            {
              "type": "pattern",
              "path": "$this"
            }
          ],
          "description": "Discriminated by the bound value set",
          "rules": "open"
        },
        "min": 1
      },
      {
        "id": "AllergyIntolerance.clinicalStatus.coding:HL7AllergyIntoleranceClinicalStatus",
        "path": "AllergyIntolerance.clinicalStatus.coding",
        "sliceName": "HL7AllergyIntoleranceClinicalStatus",
        "short": "Required value set for AllergyIntolerance Clinical Status.",
        "definition": "The clinical status of an allergy or intolerance.",
        "min": 1,
        "binding": {
          "strength": "required",
          "description": "HL7 required value set for AllergyIntolerance Clinical Status.",
          "valueSet": "http://hl7.org/fhir/ValueSet/allergyintolerance-clinical"
        }
      },
      {
        "id": "AllergyIntolerance.clincalStatus.coding:statusCodeSCTCA",
        "path": "AllergyIntolerance.clinicalStatus.coding",
        "sliceName": "statusCodeSCTCA",
        "short": "Code for allergy or intolerance status",
        "definition": "Code for an allergy or intolerance statement. Represents whether an allergy/intolerance is active or resolved (indicating no longer active).",
        "comment": "This value set combines concepts that can be mapped to clinical status as well as verification status concepts. Implementers are expected to utilize concept maps to ensure the code captured in the source is appropriately mapped to the correct allergy intolerance element.",
        "binding": {
          "strength": "required",
          "description": "Represents whether an allergy/intolerance is “active” or resolved (indicating no longer active).",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/allergyintolerancestatuscode"
        }
      },
      {
        "id": "AllergyIntolerance.clincalStatus.coding:ActStatusCodeV3",
        "path": "AllergyIntolerance.clinicalStatus.coding",
        "sliceName": "ActStatusCodeV3",
        "short": "HL7 V3 ActStatus code",
        "definition": "Codes representing the defined possible states of an Act, as defined by the Act class state machine.",
        "binding": {
          "strength": "required",
          "description": "Represents an ActStatus code used by systems implementing HL7 V3.",
          "valueSet": "http://terminology.hl7.org/ValueSet/v3-ActStatus"
        }
      },
      {
        "id": "AllergyIntolerance.verificationStatus",
        "path": "AllergyIntolerance.verificationStatus",
        "comment": "IPS-UV no longer flags this as a Must Support Element. It is not currently flagged as Must Support in PS-CA, as stakeholders have indicated the element may not be supported by the majority of systems today. Systems that do support the element are encouraged to include it in generated Patient Summary documents, and support it when received.\n\nFHIR Base Note: This element is a modifier element with a required vocabulary binding in the base FHIR specification.\n\nIPS-UV Note: In the scope of the IPS-UV the entered-in-error concept is not allowed and so the modifier on this element has been removed."
      },
      {
        "id": "AllergyIntolerance.verificationStatus.coding",
        "path": "AllergyIntolerance.verificationStatus.coding",
        "comment": "Many Canadian systems currently use the [AllergyIntoleranceStatusCode](https://tgateway.infoway-inforoute.ca/vs/allergyintolerancestatuscode) value set comprised of SNOMED CT codes that can be mapped and provided as additional codings to the required FHIR allergyIntolerance-verification codes. The element is sliced to express the required population of at least the HL7VerificationStatus slice since it is a required coding.",
        "slicing": {
          "discriminator": [
            {
              "type": "pattern",
              "path": "$this"
            }
          ],
          "description": "Discriminated by the bound value set",
          "rules": "open"
        },
        "min": 1
      },
      {
        "id": "AllergyIntolerance.verificationStatus.coding:HL7VerificationStatus",
        "path": "AllergyIntolerance.verificationStatus.coding",
        "sliceName": "HL7VerificationStatus",
        "short": "Required value set for AllergyIntolerance Verification Status.",
        "definition": "Code for an allergy or intolerance statement. Represents whether an allergy/intolerance is active or resolved (indicating no longer active).",
        "min": 1,
        "binding": {
          "strength": "required",
          "description": "HL7 required value set for AllergyIntolerance Verification Status.",
          "valueSet": "http://hl7.org/fhir/ValueSet/allergyintolerance-verification"
        }
      },
      {
        "id": "AllergyIntolerance.verificationStatus.coding:statusCodeSCTCA",
        "path": "AllergyIntolerance.verificationStatus.coding",
        "sliceName": "statusCodeSCTCA",
        "short": "Code for allergy or intolerance status",
        "definition": "Code for an allergy or intolerance statement. Represents whether an allergy/intolerance is active or resolved but also includes values like confirmed present and refuted",
        "comment": "This value set combines concepts that can be mapped to clinical status as well as verification status concepts. Implementers are expected to utilize concept maps to ensure the code captured in the source is appropriately mapped to the correct allergy intolerance element.",
        "binding": {
          "strength": "required",
          "description": "Represents whether an allergy/intolerance is “active” or resolved (indicating no longer active).",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/allergyintolerancestatuscode"
        }
      },
      {
        "id": "AllergyIntolerance.type",
        "path": "AllergyIntolerance.type",
        "comment": "IPS-UV flags this as a Must Support element. It is not currently flagged as Must Support in PS-CA, as stakeholders have indicated the element may not be supported by the majority of systems today. Systems that do support the element are encouraged to include it in generated Patient Summary documents, and support it when received. Vendors should expect that some jurisdictions may add a Must Support requirement within the context of their own jurisdictional content."
      },
      {
        "id": "AllergyIntolerance.code",
        "path": "AllergyIntolerance.code",
        "short": "Concept - reference to a terminology or just text",
        "comment": "Many Canadian implementations use codes from either SNOMED CT and the SNOMED CT Canada Extension to describe this concept, while others may still be using localized code systems or text descriptions. The AllergyIntolleranceSubstanceCondition - IPS ValueSet contains codes that are subsumed within the SNOMED CT CA SubstanceAndPharmaceuticalBiologicProductCode ValueSet that is preferred for this element.\n\n  See additionalBinding extension.\r\n\r\n Future releases of PS-CA may require use of coded entries. In this release, however, implementations that support codings are encouraged to send the codings for codeable concepts if they are available. Consistent with FHIR best practice, receivers should not produce failures or rejections if codings are received. Vendors should expect that some jurisdictions may further constrain support of this element within the context of their own jurisdictional content.",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "CodeableConcept",
            "profile": [
              "http://fhir.infoway-inforoute.ca/io/psca/StructureDefinition/CodeableConcept-ca-ps"
            ]
          }
        ],
        "mustSupport": true,
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "AllergyIntoleranceCode"
            },
            {
              "extension": [
                {
                  "url": "purpose",
                  "valueCode": "candidate"
                },
                {
                  "url": "valueSet",
                  "valueCanonical": "http://fhir.infoway-inforoute.ca/io/psca/ValueSet/hc-CCDD"
                },
                {
                  "url": "documentation",
                  "valueMarkdown": "Canadian Clinical Drug Data Set providing codes for identification of medications and medical devices in Canada. While not the preferred terminology for broader pan-Canadian exchange use cases, this additional binding is surfaced to socialize the value sets that may be more commonly in use. Where multiple codings can be supplied, it is encouraged to supply the original coding alongside the pan-Canadian preferred terminology."
                }
              ],
              "url": "http://hl7.org/fhir/tools/StructureDefinition/additional-binding"
            },
            {
              "extension": [
                {
                  "url": "purpose",
                  "valueCode": "candidate"
                },
                {
                  "url": "valueSet",
                  "valueCanonical": "http://fhir.infoway-inforoute.ca/io/psca/ValueSet/LicensedNaturalHealthProducts"
                },
                {
                  "url": "documentation",
                  "valueMarkdown": "All concepts represented in the Licensed Natural Health Products Database. While not the preferred terminology for broader pan-Canadian exchange use cases, this additional binding is surfaced to socialize the value sets that may be more commonly in use. Where multiple codings can be supplied, it is encouraged to supply the original coding alongside the pan-Canadian preferred terminology."
                }
              ],
              "url": "http://hl7.org/fhir/tools/StructureDefinition/additional-binding"
            },
            {
              "extension": [
                {
                  "url": "purpose",
                  "valueCode": "candidate"
                },
                {
                  "url": "valueSet",
                  "valueCanonical": "http://fhir.infoway-inforoute.ca/io/psca/ValueSet/ICD10CA"
                },
                {
                  "url": "documentation",
                  "valueMarkdown": "Any code from ICD-10 CA. While not the preferred terminology for broader pan-Canadian exchange use cases, this additional binding is surfaced to socialize the value sets that may be more commonly in use. Where multiple codings can be supplied, it is encouraged to supply the original coding alongside the pan-Canadian preferred terminology."
                }
              ],
              "url": "http://hl7.org/fhir/tools/StructureDefinition/additional-binding"
            },
            {
              "extension": [
                {
                  "url": "purpose",
                  "valueCode": "candidate"
                },
                {
                  "url": "valueSet",
                  "valueCanonical": "http://hl7.org/fhir/uv/ips/ValueSet/absent-or-unknown-allergies-uv-ips"
                },
                {
                  "url": "documentation",
                  "valueMarkdown": "Negation/exclusion codes for reporting no known allergies or not available data."
                }
              ],
              "url": "http://hl7.org/fhir/tools/StructureDefinition/additional-binding"
            }
          ],
          "strength": "preferred",
          "description": "Codes for that combine substance and pharmaceuticalbiologicproduct value sets from the SNOMED CT Canadian edition",
          "valueSet": "http://fhir.infoway-inforoute.ca/io/psca/ValueSet/substanceandpharmaceuticalbiologicproductcode"
        }
      },
      {
        "id": "AllergyIntolerance.patient",
        "path": "AllergyIntolerance.patient",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://fhir.infoway-inforoute.ca/io/psca/StructureDefinition/patient-ca-ps"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "AllergyIntolerance.patient.reference",
        "path": "AllergyIntolerance.patient.reference",
        "min": 1,
        "mustSupport": true
      },
      {
        "id": "AllergyIntolerance.onset[x]",
        "path": "AllergyIntolerance.onset[x]",
        "slicing": {
          "discriminator": [
            {
              "type": "type",
              "path": "$this"
            }
          ],
          "ordered": false,
          "rules": "open"
        }
      },
      {
        "id": "AllergyIntolerance.onsetDateTime",
        "path": "AllergyIntolerance.onsetDateTime",
        "mustSupport": true
      },
      {
        "id": "AllergyIntolerance.reaction",
        "path": "AllergyIntolerance.reaction",
        "mustSupport": true
      },
      {
        "id": "AllergyIntolerance.reaction.substance",
        "path": "AllergyIntolerance.reaction.substance",
        "comment": "The IPS-UV does not consider this element Must Support, however some Canadian systems may capture allergen substances separately from allergyIntolerance.code. Further investigation is required to determine what approaches are in use by participating jurisdictions."
      },
      {
        "id": "AllergyIntolerance.reaction.manifestation",
        "path": "AllergyIntolerance.reaction.manifestation",
        "comment": "Future releases of PS-CA may require use of coded entries. In this release, however, implementers that support codings are encouraged to send the codings for codeable concepts if they are available. Consistent with FHIR best practice, receivers should not produce failures or rejections if codings are received. Vendors should expect that some jurisdictions may further constrain support of this element within the context of their own jurisdictional content.",
        "type": [
          {
            "code": "CodeableConcept",
            "profile": [
              "http://fhir.infoway-inforoute.ca/io/psca/StructureDefinition/CodeableConcept-ca-ps"
            ]
          }
        ],
        "mustSupport": true,
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ReactionManifestationCode"
            }
          ],
          "strength": "preferred",
          "description": "Codes for the allergy or intolerance reaction manifestation from the SNOMED CT Canadian edition value set",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/clinicalfindingcode"
        }
      },
      {
        "id": "AllergyIntolerance.reaction.severity",
        "path": "AllergyIntolerance.reaction.severity",
        "comment": "IPS-UV flags this as a Must Support element. It is not currently flagged as Must Support in PS-CA, as stakeholders have indicated the element may not be supported by the majority of systems today. Systems that do support the element are encouraged to include it in generated Patient Summary documents, and support it when received. Vendors should expect that some jurisdictions may add a Must Support requirement within the context of their own jurisdictional content."
      }
    ]
  }
}