Swedish Base Profiles Implementation Guide
1.0.0 - release

This page is part of the HL7 Sweden base profiles (v1.0.0: Release) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Resource Profile: SE base profile for organization ( Experimental )

Official URL: http://hl7.se/fhir/ig/base/StructureDefinition/SEBaseOrganization Version: 1.0.0
Draft as of 2023-03-08 Computable Name: SEBaseOrganization

This is the base Organization profile to be used when profiling on Organization in a Swedish context

Use of organization.type

There are multiple code systems describing organization types in Sweden.

  • The National Board of Health and Welfare are maintaining a code system called “Verksamhetsområden” that is used for reporting quality data to national quality registries: Verksamhetskoder
  • The Health and Social Care Inspectorate (IVO) also have a code system describing health care organizations that is used when reporting irregularities or register complaints.
  • The only code system that has been found with a clear namespace that can be identified and that is widely used in an interoperablilty context is the HSA Verksamhetskoder. Therefore the only code system used in the organization base profile is the HSA Verksamhetskoder. If necessary, other code systems can be used when suitable.

Use of identifiers

There are currently different ways of representing the master source of the HSA identifier. HSA identifiers are used to identify a number of different kinds of objects, such as people, organisations and assigments. Each of these object types have their own OID, but that OID does not uniquely scope the identifier part, but the entire object. The OID chosen in the Swedish base profiles is the one referring to the identifiers as a whole, no matter what object class they represent. Unfortunately, this will lead to cases where the OID used here will differ from the OID used in other formal specifications.
This can be very important to keep in mind for implementors that get their HSA-ids from different sources and use them in different interactions.

Usage:

Formal Views of Profile Content

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

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*OrganizationA grouping of people or organizations with a common purpose
... Slices for identifier 0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid 0..1IdentifierIdentifies this organization across multiple systems
..... type 0..1CodeableConceptDescription of identifier
Fixed Value: As shown (Provider number)
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
..... system 1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
.... identifier:organizationIdentifier 0..1IdentifierIdentifies this organization across multiple systems
..... type 0..1CodeableConceptDescription of identifier
Fixed Value: As shown (Organization identifier)
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
..... system 1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
... type 0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)
NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization C0..*OrganizationA grouping of people or organizations with a common purpose
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for identifier ΣC0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid ΣC0..1IdentifierIdentifies this organization across multiple systems
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Provider number)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
.... identifier:organizationIdentifier ΣC0..1IdentifierIdentifies this organization across multiple systems
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Organization identifier)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
... type Σ0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Organization.identifier:hsaid.userequiredIdentifierUse
Organization.identifier:hsaid.typeextensibleFixed Value: PRN
Organization.identifier:organizationIdentifier.userequiredIdentifierUse
Organization.identifier:organizationIdentifier.typeextensibleFixed Value: XX
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)
NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization C0..*OrganizationA grouping of people or organizations with a common purpose
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for identifier ΣC0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid ΣC0..1IdentifierIdentifies this organization across multiple systems
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Provider number)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
..... value Σ0..1stringThe value that is unique
Example General: 123456
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
.... identifier:organizationIdentifier ΣC0..1IdentifierIdentifies this organization across multiple systems
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Organization identifier)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
..... value Σ0..1stringThe value that is unique
Example General: 123456
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type Σ0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)
... name ΣC0..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom C0..*ContactPointA contact detail for the organization
... address C0..*AddressAn address for the organization
... partOf Σ0..1Reference(Organization)The organization of which this organization forms a part
... contact 0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.

.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Organization.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Organization.identifier:hsaid.userequiredIdentifierUse
Organization.identifier:hsaid.typeextensibleFixed Value: PRN
Organization.identifier:organizationIdentifier.userequiredIdentifierUse
Organization.identifier:organizationIdentifier.typeextensibleFixed Value: XX
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)
Organization.contact.purposeextensibleContactEntityType

This structure is derived from Organization

Summary

Mandatory: 0 element (2 nested mandatory elements)
Fixed Value: 4 elements

Slices

This structure defines the following Slices:

  • The element Organization.identifier is sliced based on the value of value:system

Differential View

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*OrganizationA grouping of people or organizations with a common purpose
... Slices for identifier 0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid 0..1IdentifierIdentifies this organization across multiple systems
..... type 0..1CodeableConceptDescription of identifier
Fixed Value: As shown (Provider number)
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
..... system 1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
.... identifier:organizationIdentifier 0..1IdentifierIdentifies this organization across multiple systems
..... type 0..1CodeableConceptDescription of identifier
Fixed Value: As shown (Organization identifier)
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
..... system 1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
... type 0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization C0..*OrganizationA grouping of people or organizations with a common purpose
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for identifier ΣC0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid ΣC0..1IdentifierIdentifies this organization across multiple systems
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Provider number)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
.... identifier:organizationIdentifier ΣC0..1IdentifierIdentifies this organization across multiple systems
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Organization identifier)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
... type Σ0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Organization.identifier:hsaid.userequiredIdentifierUse
Organization.identifier:hsaid.typeextensibleFixed Value: PRN
Organization.identifier:organizationIdentifier.userequiredIdentifierUse
Organization.identifier:organizationIdentifier.typeextensibleFixed Value: XX
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization C0..*OrganizationA grouping of people or organizations with a common purpose
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... Slices for identifier ΣC0..*IdentifierIdentifies this organization across multiple systems
Slice: Unordered, Open by value:system
.... identifier:hsaid ΣC0..1IdentifierIdentifies this organization across multiple systems
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Provider number)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: PRN
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:1.2.752.29.4.19
..... value Σ0..1stringThe value that is unique
Example General: 123456
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
.... identifier:organizationIdentifier ΣC0..1IdentifierIdentifies this organization across multiple systems
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ0..1codeusual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription 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.


Fixed Value: As shown (Organization identifier)
...... id0..0idUnique id for inter-element referencing
...... extension0..0ExtensionAdditional content defined by implementations
...... coding1..1CodingCode defined by a terminology system
Fixed Value: (complex)
....... id0..0idUnique id for inter-element referencing
....... extension0..0ExtensionAdditional content defined by implementations
....... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
....... version0..0stringVersion of the system - if relevant
....... code1..1codeSymbol in syntax defined by the system
Fixed Value: XX
....... display0..0stringRepresentation defined by the system
....... userSelected0..0booleanIf this coding was chosen directly by the user
...... text0..0stringPlain text representation of the concept
..... system Σ1..1uriThe namespace for the identifier value
Fixed Value: urn:oid:2.5.4.97
..... value Σ0..1stringThe value that is unique
Example General: 123456
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type Σ0..*CodeableConceptKind of organization
Binding: SEBaseHSAVerksamhetVS (extensible)
... name ΣC0..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom C0..*ContactPointA contact detail for the organization
... address C0..*AddressAn address for the organization
... partOf Σ0..1Reference(Organization)The organization of which this organization forms a part
... contact 0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.

.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint 0..*Reference(Endpoint)Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Organization.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Organization.identifier:hsaid.userequiredIdentifierUse
Organization.identifier:hsaid.typeextensibleFixed Value: PRN
Organization.identifier:organizationIdentifier.userequiredIdentifierUse
Organization.identifier:organizationIdentifier.typeextensibleFixed Value: XX
Organization.typeextensibleSEBaseHSAVerksamhetVS (a valid code from urn:oid:1.2.752.129.2.2.1.3)
Organization.contact.purposeextensibleContactEntityType

This structure is derived from Organization

Summary

Mandatory: 0 element (2 nested mandatory elements)
Fixed Value: 4 elements

Slices

This structure defines the following Slices:

  • The element Organization.identifier is sliced based on the value of value:system

 

Other representations of profile: CSV, Excel, Schematron