ERA FHIR specification
1.0.0 - draft

ERA FHIR specification - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Extension: DosageChanges - Detailed Descriptions

Draft as of 2026-10-28

Definitions for the Extension-dosageChanges extension.

See the documentation on how to interpret the contents of this table

0. Extension
Definition

Additional information on the change and correction of medication: Justification of the correction of prescription Additional notes for the correction of prescription The reason for the change in medication Further information on the change in medication


Optional Extension Element - found in all resources.

ShortAdditional information on the change and correction of medicationOptional Extensions Element
Control0..*
This element is affected by the following invariants: ele-1
Is Modifierfalse
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())
2. Extension.extension
Definition

An Extension


May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

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 Extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them

    4. Extension.extension:modificationReasonCode
    Slice NamemodificationReasonCode
    Definition

    Justification for correcting the prescription. Reason for correcting the prescription, when the prescription message is 3 = correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

    ShortJustification of the correction of prescriptionAdditional content defined by implementations
    Control0..1*
    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())
    6. Extension.extension:modificationReasonCode.url
    Definition

    Source of the definition for the extension code - a logical name or a URL.

    Shortidentifies the meaning of the extension
    Comments

    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

    Control1..1
    Typeuri
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    Fixed Value
    {
      "url" : "modificationReasonCode"
    }
    <url value="modificationReasonCode"/>
    8. Extension.extension:modificationReasonCode.value[x]
    Definition

    Justification for correcting the prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.


    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

    ShortJustification of the correction of prescriptionValue of extension
    Control10..1
    TypeCoding, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    Is Modifierfalse
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    10. Extension.extension:modificationReasonCode.value[x].system
    Definition

    OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.


    The identification of the code system that defines the meaning of the symbol in the code.

    ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'Identity of the terminology system
    Comments

    The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

    Control10..1
    Typeuri
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to be unambiguous about the source of the definition of the symbol.

    Fixed Value
    {
      "system" : "urn:oid:1.2.246.537.6.600.2013"
    }
    <system value="urn:oid:1.2.246.537.6.600.2013"/>
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    12. Extension.extension:modificationReasonCode.value[x].code
    Definition

    Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.


    A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

    ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'Symbol in syntax defined by the system
    Control10..1
    Typecode
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to refer to a particular code in the system.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    14. Extension.extension:modificationReasonText
    Slice NamemodificationReasonText
    Definition

    Further information on the justification of the correction of prescription.

    ShortFurther information on correction of prescriptionAdditional content defined by implementations
    Control0..1*
    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())
    16. Extension.extension:modificationReasonText.url
    Definition

    Source of the definition for the extension code - a logical name or a URL.

    Shortidentifies the meaning of the extension
    Comments

    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

    Control1..1
    Typeuri
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    Fixed Value
    {
      "url" : "modificationReasonText"
    }
    <url value="modificationReasonText"/>
    18. Extension.extension:modificationReasonText.value[x]
    Definition

    Further information on the justification of the correction of prescription.


    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

    ShortValue of extension
    Control10..1
    Typestring, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    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()))
    20. Extension.extension:dosageChangeReasonCode
    Slice NamedosageChangeReasonCode
    Definition

    The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

    ShortThe reason for the change in medicationAdditional content defined by implementations
    Control0..1*
    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())
    22. Extension.extension:dosageChangeReasonCode.url
    Definition

    Source of the definition for the extension code - a logical name or a URL.

    Shortidentifies the meaning of the extension
    Comments

    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

    Control1..1
    Typeuri
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    Fixed Value
    {
      "url" : "dosageChangeReasonCode"
    }
    <url value="dosageChangeReasonCode"/>
    24. Extension.extension:dosageChangeReasonCode.value[x]
    Definition

    The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.


    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

    ShortThe reason for the change in medicationValue of extension
    Control10..1
    TypeCoding, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    Is Modifierfalse
    Summaryfalse
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    26. Extension.extension:dosageChangeReasonCode.value[x].system
    Definition

    OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'


    The identification of the code system that defines the meaning of the symbol in the code.

    ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'Identity of the terminology system
    Comments

    The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

    Control10..1
    Typeuri
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to be unambiguous about the source of the definition of the symbol.

    Fixed Value
    {
      "system" : "urn:oid:1.2.246.537.6.600.2013"
    }
    <system value="urn:oid:1.2.246.537.6.600.2013"/>
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    28. Extension.extension:dosageChangeReasonCode.value[x].code
    Definition

    Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.


    A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

    ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'Symbol in syntax defined by the system
    Control10..1
    Typecode
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to refer to a particular code in the system.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    30. Extension.extension:dosageChangeReasonText
    Slice NamedosageChangeReasonText
    Definition

    Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.

    ShortFurther information on the change in medicationAdditional content defined by implementations
    Control0..1*
    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())
    32. Extension.extension:dosageChangeReasonText.url
    Definition

    Source of the definition for the extension code - a logical name or a URL.

    Shortidentifies the meaning of the extension
    Comments

    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

    Control1..1
    Typeuri
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    Fixed Value
    {
      "url" : "dosageChangeReasonText"
    }
    <url value="dosageChangeReasonText"/>
    34. Extension.extension:dosageChangeReasonText.value[x]
    Definition

    Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.


    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

    ShortFurther information on the change in medicationValue of extension
    Control10..1
    Typestring, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    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()))
    36. Extension.url
    Definition

    Source of the definition for the extension code - a logical name or a URL.

    Shortidentifies the meaning of the extension
    Comments

    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

    Control1..1
    Typeuri
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    Fixed Value
    {
      "url" : "http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"
    }
    <url value="http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"/>
    38. Extension.value[x]
    Definition

    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

    ShortValue of extension
    Control0..01
    TypeChoice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
    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()))

    See the documentation on how to interpret the contents of this table

    0. Extension
    Definition

    Additional information on the change and correction of medication: Justification of the correction of prescription Additional notes for the correction of prescription The reason for the change in medication Further information on the change in medication

    ShortAdditional information on the change and correction of medication
    2. Extension.extension
    Control0..?
    SlicingThis element introduces a set of slices on Extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them

      4. Extension.extension:modificationReasonCode
      Slice NamemodificationReasonCode
      Definition

      Justification for correcting the prescription. Reason for correcting the prescription, when the prescription message is 3 = correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortJustification of the correction of prescription
      Control0..1
      6. Extension.extension:modificationReasonCode.url
      Fixed Value
      {
        "url" : "modificationReasonCode"
      }
      <url value="modificationReasonCode"/>
      8. Extension.extension:modificationReasonCode.value[x]
      Definition

      Justification for correcting the prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortJustification of the correction of prescription
      Control1..?
      TypeCoding
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      10. Extension.extension:modificationReasonCode.value[x].system
      Definition

      OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
      Control1..?
      Fixed Value
      {
        "system" : "urn:oid:1.2.246.537.6.600.2013"
      }
      <system value="urn:oid:1.2.246.537.6.600.2013"/>
      12. Extension.extension:modificationReasonCode.value[x].code
      Definition

      Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
      Control1..?
      14. Extension.extension:modificationReasonText
      Slice NamemodificationReasonText
      Definition

      Further information on the justification of the correction of prescription.

      ShortFurther information on correction of prescription
      Control0..1
      16. Extension.extension:modificationReasonText.url
      Fixed Value
      {
        "url" : "modificationReasonText"
      }
      <url value="modificationReasonText"/>
      18. Extension.extension:modificationReasonText.value[x]
      Definition

      Further information on the justification of the correction of prescription.

      Control1..?
      Typestring
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      20. Extension.extension:dosageChangeReasonCode
      Slice NamedosageChangeReasonCode
      Definition

      The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortThe reason for the change in medication
      Control0..1
      22. Extension.extension:dosageChangeReasonCode.url
      Fixed Value
      {
        "url" : "dosageChangeReasonCode"
      }
      <url value="dosageChangeReasonCode"/>
      24. Extension.extension:dosageChangeReasonCode.value[x]
      Definition

      The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortThe reason for the change in medication
      Control1..?
      TypeCoding
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      26. Extension.extension:dosageChangeReasonCode.value[x].system
      Definition

      OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'

      ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
      Control1..?
      Fixed Value
      {
        "system" : "urn:oid:1.2.246.537.6.600.2013"
      }
      <system value="urn:oid:1.2.246.537.6.600.2013"/>
      28. Extension.extension:dosageChangeReasonCode.value[x].code
      Definition

      Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

      ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
      Control1..?
      30. Extension.extension:dosageChangeReasonText
      Slice NamedosageChangeReasonText
      Definition

      Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.

      ShortFurther information on the change in medication
      Control0..1
      32. Extension.extension:dosageChangeReasonText.url
      Fixed Value
      {
        "url" : "dosageChangeReasonText"
      }
      <url value="dosageChangeReasonText"/>
      34. Extension.extension:dosageChangeReasonText.value[x]
      Definition

      Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.

      ShortFurther information on the change in medication
      Control1..?
      Typestring
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      36. Extension.url
      Fixed Value
      {
        "url" : "http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"
      }
      <url value="http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"/>
      38. Extension.value[x]
      Control0..0

      See the documentation on how to interpret the contents of this table

      0. Extension
      Definition

      Additional information on the change and correction of medication: Justification of the correction of prescription Additional notes for the correction of prescription The reason for the change in medication Further information on the change in medication

      ShortAdditional information on the change and correction of medication
      Control0..*
      This element is affected by the following invariants: ele-1
      Is Modifierfalse
      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())
      2. Extension.id
      Definition

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

      ShortUnique id for inter-element referencing
      Control0..1
      Typestring
      Is Modifierfalse
      XML FormatIn the XML format, this property is represented as an attribute.
      Summaryfalse
      4. Extension.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 Extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them

        6. Extension.extension:modificationReasonCode
        Slice NamemodificationReasonCode
        Definition

        Justification for correcting the prescription. Reason for correcting the prescription, when the prescription message is 3 = correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

        ShortJustification of the correction of prescription
        Control0..1
        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())
        8. Extension.extension:modificationReasonCode.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
        10. Extension.extension:modificationReasonCode.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())
        SlicingThis element introduces a set of slices on Extension.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • value @ url
        • 12. Extension.extension:modificationReasonCode.url
          Definition

          Source of the definition for the extension code - a logical name or a URL.

          Shortidentifies the meaning of the extension
          Comments

          The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

          Control1..1
          Typeuri
          Is Modifierfalse
          XML FormatIn the XML format, this property is represented as an attribute.
          Summaryfalse
          Fixed Value
          {
            "url" : "modificationReasonCode"
          }
          <url value="modificationReasonCode"/>
          14. Extension.extension:modificationReasonCode.value[x]
          Definition

          Justification for correcting the prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

          ShortJustification of the correction of prescription
          Control1..1
          TypeCoding
          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
          Is Modifierfalse
          Summaryfalse
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          16. Extension.extension:modificationReasonCode.value[x].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
          18. Extension.extension:modificationReasonCode.value[x].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())
          SlicingThis element introduces a set of slices on Extension.extension.value[x].extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ url
          • 20. Extension.extension:modificationReasonCode.value[x].system
            Definition

            OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

            ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
            Comments

            The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

            Control1..1
            Typeuri
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to be unambiguous about the source of the definition of the symbol.

            Fixed Value
            {
              "system" : "urn:oid:1.2.246.537.6.600.2013"
            }
            <system value="urn:oid:1.2.246.537.6.600.2013"/>
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            22. Extension.extension:modificationReasonCode.value[x].version
            Definition

            The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

            ShortVersion of the system - if relevant
            Comments

            Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

            NoteThis is a business version Id, not a resource version Id (see discussion)
            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()))
            24. Extension.extension:modificationReasonCode.value[x].code
            Definition

            Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

            ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
            Control1..1
            Typecode
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to refer to a particular code in the system.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            26. Extension.extension:modificationReasonCode.value[x].display
            Definition

            A representation of the meaning of the code in the system, following the rules of the system.

            ShortRepresentation defined by the system
            Control0..1
            Typestring
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            28. Extension.extension:modificationReasonCode.value[x].userSelected
            Definition

            Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

            ShortIf this coding was chosen directly by the user
            Comments

            Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

            Control0..1
            Typeboolean
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            30. Extension.extension:modificationReasonText
            Slice NamemodificationReasonText
            Definition

            Further information on the justification of the correction of prescription.

            ShortFurther information on correction of prescription
            Control0..1
            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())
            32. Extension.extension:modificationReasonText.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
            34. Extension.extension:modificationReasonText.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())
            SlicingThis element introduces a set of slices on Extension.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
            • value @ url
            • 36. Extension.extension:modificationReasonText.url
              Definition

              Source of the definition for the extension code - a logical name or a URL.

              Shortidentifies the meaning of the extension
              Comments

              The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

              Control1..1
              Typeuri
              Is Modifierfalse
              XML FormatIn the XML format, this property is represented as an attribute.
              Summaryfalse
              Fixed Value
              {
                "url" : "modificationReasonText"
              }
              <url value="modificationReasonText"/>
              38. Extension.extension:modificationReasonText.value[x]
              Definition

              Further information on the justification of the correction of prescription.

              ShortValue of extension
              Control1..1
              Typestring
              [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
              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()))
              40. Extension.extension:dosageChangeReasonCode
              Slice NamedosageChangeReasonCode
              Definition

              The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

              ShortThe reason for the change in medication
              Control0..1
              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())
              42. Extension.extension:dosageChangeReasonCode.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
              44. Extension.extension:dosageChangeReasonCode.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())
              SlicingThis element introduces a set of slices on Extension.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
              • value @ url
              • 46. Extension.extension:dosageChangeReasonCode.url
                Definition

                Source of the definition for the extension code - a logical name or a URL.

                Shortidentifies the meaning of the extension
                Comments

                The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                Control1..1
                Typeuri
                Is Modifierfalse
                XML FormatIn the XML format, this property is represented as an attribute.
                Summaryfalse
                Fixed Value
                {
                  "url" : "dosageChangeReasonCode"
                }
                <url value="dosageChangeReasonCode"/>
                48. Extension.extension:dosageChangeReasonCode.value[x]
                Definition

                The reason for a change in medication, such as a change of dosage or product, and a correction of prescription. According to the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

                ShortThe reason for the change in medication
                Control1..1
                TypeCoding
                [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                Is Modifierfalse
                Summaryfalse
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                50. Extension.extension:dosageChangeReasonCode.value[x].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
                52. Extension.extension:dosageChangeReasonCode.value[x].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())
                SlicingThis element introduces a set of slices on Extension.extension.value[x].extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                • value @ url
                • 54. Extension.extension:dosageChangeReasonCode.value[x].system
                  Definition

                  OID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'

                  ShortOID of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
                  Comments

                  The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

                  Control1..1
                  Typeuri
                  Is Modifierfalse
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  Summarytrue
                  Requirements

                  Need to be unambiguous about the source of the definition of the symbol.

                  Fixed Value
                  {
                    "system" : "urn:oid:1.2.246.537.6.600.2013"
                  }
                  <system value="urn:oid:1.2.246.537.6.600.2013"/>
                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  56. Extension.extension:dosageChangeReasonCode.value[x].version
                  Definition

                  The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

                  ShortVersion of the system - if relevant
                  Comments

                  Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

                  NoteThis is a business version Id, not a resource version Id (see discussion)
                  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()))
                  58. Extension.extension:dosageChangeReasonCode.value[x].code
                  Definition

                  Code of the Kanta code system 'THL - Lääkehoidon muutoksen syy'.

                  ShortCode of the Kanta code system 'THL - Lääkehoidon muutoksen syy'
                  Control1..1
                  Typecode
                  Is Modifierfalse
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  Summarytrue
                  Requirements

                  Need to refer to a particular code in the system.

                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  60. Extension.extension:dosageChangeReasonCode.value[x].display
                  Definition

                  A representation of the meaning of the code in the system, following the rules of the system.

                  ShortRepresentation defined by the system
                  Control0..1
                  Typestring
                  Is Modifierfalse
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  Summarytrue
                  Requirements

                  Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  62. Extension.extension:dosageChangeReasonCode.value[x].userSelected
                  Definition

                  Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

                  ShortIf this coding was chosen directly by the user
                  Comments

                  Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

                  Control0..1
                  Typeboolean
                  Is Modifierfalse
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  Summarytrue
                  Requirements

                  This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  64. Extension.extension:dosageChangeReasonText
                  Slice NamedosageChangeReasonText
                  Definition

                  Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.

                  ShortFurther information on the change in medication
                  Control0..1
                  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())
                  66. Extension.extension:dosageChangeReasonText.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. Extension.extension:dosageChangeReasonText.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())
                  SlicingThis element introduces a set of slices on Extension.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                  • value @ url
                  • 70. Extension.extension:dosageChangeReasonText.url
                    Definition

                    Source of the definition for the extension code - a logical name or a URL.

                    Shortidentifies the meaning of the extension
                    Comments

                    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                    Control1..1
                    Typeuri
                    Is Modifierfalse
                    XML FormatIn the XML format, this property is represented as an attribute.
                    Summaryfalse
                    Fixed Value
                    {
                      "url" : "dosageChangeReasonText"
                    }
                    <url value="dosageChangeReasonText"/>
                    72. Extension.extension:dosageChangeReasonText.value[x]
                    Definition

                    Additional information related to the change in medication. The further clarification of the adverse effect behind the change may have been recorded here.

                    ShortFurther information on the change in medication
                    Control1..1
                    Typestring
                    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                    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()))
                    74. Extension.url
                    Definition

                    Source of the definition for the extension code - a logical name or a URL.

                    Shortidentifies the meaning of the extension
                    Comments

                    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                    Control1..1
                    Typeuri
                    Is Modifierfalse
                    XML FormatIn the XML format, this property is represented as an attribute.
                    Summaryfalse
                    Fixed Value
                    {
                      "url" : "http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"
                    }
                    <url value="http://resepti.kanta.fi/fhir/StructureDefinition/extension/dosageChanges"/>
                    76. Extension.value[x]
                    Definition

                    Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

                    ShortValue of extension
                    Control0..0
                    TypeChoice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
                    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()))