1.0.0 - release

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

Extension: CommonHsaHierarchy

Official URL: https://commonprofiles.care/StructureDefinition/common-hsaHierarchy/v1 Version: 1.0.0
Active as of 2025-10-27 Computable Name: CommonHsaHierarchy

Intended Use

This extension is used to describe a unit's (Location or Organization) place in the Swedish HSA hierarchy. There are two important levels in the hierarchy:

  • HSA Vårdgivare (eng HSA Care Provider) - This is often a region or private healthcare provider and the highest defined level in the hierarchy.

  • HSA Vårdenhet (eng HSA Department) - This is often a department within a region or private healthcare provider and the lower defined level in the hierarchy.

All official healthcare units in Sweden will have a representation in the national HSA catalogue, and all will have a relationship to a parent HSA Vårdenhet (lower level) and/or HSA Vårdgivare (highest level).

This can among other things be used to evaluate PDL (Patientdatalagen, eng Patient Data Law) rules.

Current Use Cases

  • QuestionnaireResponseSe - to indicate to which care provider and care unit the data belongs when the author is the patient.

Context of Use

    This extension may be used on the following element(s)

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:hsaCareProvider 0..1 Extension Extension
..... extension 0..0
..... url 1..1 uri "hsaCareProvider"
..... value[x] 1..1 Reference(Organization) Value of extension
...... type 0..1 uri Type the reference refers to (e.g. "Patient")
Fixed Value: Organization
...... identifier
....... system 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value 1..1 string The value that is unique
.... extension:hsaCareUnit 0..1 Extension Extension
..... extension 0..0
..... url 1..1 uri "hsaCareUnit"
..... value[x] 1..1 Reference(Organization) Value of extension
...... type 0..1 uri Type the reference refers to (e.g. "Patient")
Fixed Value: Organization
...... identifier
....... system 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value 1..1 string The value that is unique
... url 1..1 uri "https://commonprofiles.care/StructureDefinition/common-hsaHierarchy/v1"
... value[x] 0..0

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:hsaCareProvider 0..1 Extension Extension
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0
..... url 1..1 uri "hsaCareProvider"
..... value[x] 1..1 Reference(Organization) Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... reference ΣC 0..1 string Literal reference, Relative, internal or absolute URL
...... type Σ 0..1 uri Type the reference refers to (e.g. "Patient")
Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
Fixed Value: Organization
...... identifier Σ 0..1 Identifier Logical reference, when literal reference is not known
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
....... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
....... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
....... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value Σ 1..1 string The value that is unique
Example General: 123456
....... period Σ 0..1 Period Time period when id is/was valid for use
....... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
...... display Σ 0..1 string Text alternative for the resource
.... extension:hsaCareUnit 0..1 Extension Extension
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0
..... url 1..1 uri "hsaCareUnit"
..... value[x] 1..1 Reference(Organization) Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... reference ΣC 0..1 string Literal reference, Relative, internal or absolute URL
...... type Σ 0..1 uri Type the reference refers to (e.g. "Patient")
Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
Fixed Value: Organization
...... identifier Σ 0..1 Identifier Logical reference, when literal reference is not known
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
....... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
....... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
....... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value Σ 1..1 string The value that is unique
Example General: 123456
....... period Σ 0..1 Period Time period when id is/was valid for use
....... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
...... display Σ 0..1 string Text alternative for the resource
... url 1..1 uri "https://commonprofiles.care/StructureDefinition/common-hsaHierarchy/v1"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension:

Intended Use

This extension is used to describe a unit's (Location or Organization) place in the Swedish HSA hierarchy. There are two important levels in the hierarchy:
  • HSA Vårdgivare (eng HSA Care Provider) - This is often a region or private healthcare provider and the highest defined level in the hierarchy.
  • HSA Vårdenhet (eng HSA Department) - This is often a department within a region or private healthcare provider and the lower defined level in the hierarchy.
All official healthcare units in Sweden will have a representation in the national HSA catalogue, and all will have a relationship to a parent HSA Vårdenhet (lower level) and/or HSA Vårdgivare (highest level). This can among other things be used to evaluate PDL (Patientdatalagen, eng Patient Data Law) rules.

Current Use Cases

  • QuestionnaireResponseSe - to indicate to which care provider and care unit the data belongs when the author is the patient.

  • hsaCareProvider: Reference: An Extension
  • hsaCareUnit: Reference: An Extension

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:hsaCareProvider 0..1 Extension Extension
..... extension 0..0
..... url 1..1 uri "hsaCareProvider"
..... value[x] 1..1 Reference(Organization) Value of extension
...... type 0..1 uri Type the reference refers to (e.g. "Patient")
Fixed Value: Organization
...... identifier
....... system 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value 1..1 string The value that is unique
.... extension:hsaCareUnit 0..1 Extension Extension
..... extension 0..0
..... url 1..1 uri "hsaCareUnit"
..... value[x] 1..1 Reference(Organization) Value of extension
...... type 0..1 uri Type the reference refers to (e.g. "Patient")
Fixed Value: Organization
...... identifier
....... system 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value 1..1 string The value that is unique
... url 1..1 uri "https://commonprofiles.care/StructureDefinition/common-hsaHierarchy/v1"
... value[x] 0..0

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:hsaCareProvider 0..1 Extension Extension
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0
..... url 1..1 uri "hsaCareProvider"
..... value[x] 1..1 Reference(Organization) Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... reference ΣC 0..1 string Literal reference, Relative, internal or absolute URL
...... type Σ 0..1 uri Type the reference refers to (e.g. "Patient")
Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
Fixed Value: Organization
...... identifier Σ 0..1 Identifier Logical reference, when literal reference is not known
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
....... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
....... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
....... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value Σ 1..1 string The value that is unique
Example General: 123456
....... period Σ 0..1 Period Time period when id is/was valid for use
....... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
...... display Σ 0..1 string Text alternative for the resource
.... extension:hsaCareUnit 0..1 Extension Extension
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0
..... url 1..1 uri "hsaCareUnit"
..... value[x] 1..1 Reference(Organization) Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... reference ΣC 0..1 string Literal reference, Relative, internal or absolute URL
...... type Σ 0..1 uri Type the reference refers to (e.g. "Patient")
Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
Fixed Value: Organization
...... identifier Σ 0..1 Identifier Logical reference, when literal reference is not known
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
....... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
....... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
....... system Σ 1..1 uri The namespace for the identifier value
Fixed Value: urn:oid:1.2.752.129.2.1.4.1
....... value Σ 1..1 string The value that is unique
Example General: 123456
....... period Σ 0..1 Period Time period when id is/was valid for use
....... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
...... display Σ 0..1 string Text alternative for the resource
... url 1..1 uri "https://commonprofiles.care/StructureDefinition/common-hsaHierarchy/v1"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension:

Intended Use

This extension is used to describe a unit's (Location or Organization) place in the Swedish HSA hierarchy. There are two important levels in the hierarchy:
  • HSA Vårdgivare (eng HSA Care Provider) - This is often a region or private healthcare provider and the highest defined level in the hierarchy.
  • HSA Vårdenhet (eng HSA Department) - This is often a department within a region or private healthcare provider and the lower defined level in the hierarchy.
All official healthcare units in Sweden will have a representation in the national HSA catalogue, and all will have a relationship to a parent HSA Vårdenhet (lower level) and/or HSA Vårdgivare (highest level). This can among other things be used to evaluate PDL (Patientdatalagen, eng Patient Data Law) rules.

Current Use Cases

  • QuestionnaireResponseSe - to indicate to which care provider and care unit the data belongs when the author is the patient.

  • hsaCareProvider: Reference: An Extension
  • hsaCareUnit: Reference: An Extension

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSet / CodeURI
Extension.extension:hsaCareProvider.value[x].typeextensibleFixed Value: Organization
http://hl7.org/fhir/ValueSet/resource-types
From the FHIR Standard
Extension.extension:hsaCareProvider.value[x].identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
From the FHIR Standard
Extension.extension:hsaCareProvider.value[x].identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
From the FHIR Standard
Extension.extension:hsaCareUnit.value[x].typeextensibleFixed Value: Organization
http://hl7.org/fhir/ValueSet/resource-types
From the FHIR Standard
Extension.extension:hsaCareUnit.value[x].identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
From the FHIR Standard
Extension.extension:hsaCareUnit.value[x].identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()