Shared Health Specification and Guide Version 2.0 Revision F

 

The official URL for this profile is:

http://sharedhealth.exchange/fhir/StructureDefinition/profile-organization-tpr

Download Excel representation

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

>

This structure is derived from Shared Health Organization - Base

NameCard.TypeConstraints and Usage
.  Organization 0..*org-1: The organization SHALL at least have a name or an id, and possibly more than one
Definition:
A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.

..  id 1..1idDefinition:
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.


Comments:
Conformance Rule: This is the full url returned in the Provider Registry Query response. Example: https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/somepharmacy1CPRID Value = somepharmacy1CPRID

..  meta 1..1MetaDefinition:
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.

...  tag 1..*CodingSlice: Unordered, Open by value:system
Binding: (unbound) (example)
Definition:
Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource.


Comments:
The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored.

...  tag
       (version)
1..1CodingBinding: SharedSpecificationVersion (required)
Definition:
Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource.


Comments:
The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored.

....  system 1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion

....  code 1..1codeDefinition:
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).

..  extension 0..*ExtensionSlice: Unordered, Open by value:url
Definition:
An Extension

..  extension
     (service)
0..*Entity ServiceDefinition:
Identifies a electronic communication service offered by a service location or practitioner


Comments:
Entity Service is used at this level, when the service registration requires participation at both the Organization level and the Practitioner level. Both levels must be validated to confirm the outcome.

This is returned in the response when the service is determined to be active. It will be absent from the response when the service is no longer active.

..  identifier 1..1IdentifierDefinition:
Unique identifier for a healthcare service location


Comments:
Usage Note: This will convey the Organization ID (Clinic or Pharmacy) as assigned by the Shared Health Provider Registration service. This is known as the CPR ID and will be provided to each successfully registered Clinic or Pharmacy and can be stored in the local system.

Conformance Rule: The receiving system must use this field and insert as the"Receiver SERVICE_LOCATION_ENTITY_ID in a response message.

Usage Note: It has a one to one mapping to each SENDING_APPLICATION_INSTANCE_ID. This is also used by the Central Service to discover the application instance ID when routing the response message.hl7 MAPPING : SERVICE_LOCATION_IDENTIFIER

..  type 0..1Shared Health CodeableConcept CodeBinding: SharedOrganizationType (required)
Definition:
Describes the basic type or category of the service delivery location


Comments:
Distinguishes clinics from pharmacies. Binding value set. (PROFF - Provider's Office, OUTPHARM - outpatient pharmacy)

..  name 1..1stringMax Length: 100
Definition:
The name assigned to the service location.


Comments:
..  telecom 0..3Shared Health ContactPointcpt-2: A system is required if a value is provided.
org-3: The telecom of an organization can never be of use 'home'
Definition:
The phone numbers and/or electronic mail addresses by which a service location may be contacted.


Comments:
Conformance Rule: This is mandatory because the phone number is part of the written presciption.

Usage Note: This is used to specify the public Clinic or Pharmacy telephone number and/or a number of a private office number.

Conformance Rule: This is mandatory because the phone number is part of the written prescription. System (binding value set) + value + use (binding value set) must be provided.

Conformance Rule: Telecom structure is defined by Shared Health ContactPoint data type. There is a defined format to follow. Please refer to Shared Health Contact Point data type.

..  address 0..20Shared Health Addressorg-2: An address of an organization can never be of use 'home'
Definition:
An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations and which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.


Comments:
Conformance Rule: Address structure is defined by Shared Health Address data type. There are specific formats defined for string values as well as specific province and country codes to be used. Please refer to Shared Health Address data type profile.

Conformance Rule: Though the cardinality is 1..20, EMR and PMS must only include a single instance of address. Note: in future releases this may change to 1..1 formally.

..  partOf 0..1Reference(Organization)Definition:
The organization of which this organization forms a part.

...  display 0..1stringDefinition:
Plain text narrative that identifies the resource in addition to the resource reference.


Comments:
Usage Note: If present in the Provider Registry query response, it may be populated here.

This structure is derived from Shared Health Organization - Base

Summary

Mandatory: 5 elements
Must-Support: 10 elements
Fixed Value: 1 element

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

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

This structure is derived from Shared Health Organization - Base

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization S0..*
... meta S1..1Meta
.... tag SCodingSlice: Unordered, Open by value:system
.... tag S1..1CodingBinding: SharedSpecificationVersion (required)
..... system S1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
..... code S1..1code
... extension S0..*ExtensionSlice: Unordered, Open by value:url
... ext-entity-service S0..*(Complex)Entity Service
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-entity-service
... name S1..1string
... partOf S0..1Reference(Organization)
.... display S0..1stringParent Organization name

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization SI0..*Clinic, Pharmacy or clinic/pharmacy chain
... id SΣ1..1idLogical id of this artifact
... meta SΣ1..1MetaMetadata about the resource
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ0..1instantWhen the resource version last changed
.... profile Σ0..*uriProfiles this resource claims to conform to
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible)
.... tag SΣCodingTags applied to this resource
Slice: Unordered, Open by value:system
Binding: (unbound) (example)
.... tag SΣ1..1CodingTags applied to this resource
Binding: SharedSpecificationVersion (required)
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... system SΣ1..1uriIdentity of the terminology system
Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
..... version Σ0..1stringVersion of the system - if relevant
..... code SΣ1..1codeSymbol in syntax defined by the system
..... display Σ0..1stringRepresentation defined by the system
..... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: http://tools.ietf.org/html/bcp47 (required)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ext-entity-service S0..*(Complex)Entity Service
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-entity-service
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣI1..1IdentifierIdentifies this organization across multiple systems
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type S0..1Shared Health CodeableConcept CodeConcept - reference to a terminology or just text
Binding: SharedOrganizationType (required)
... name SΣI1..1stringName used for the organization
Max Length: 100
... telecom SI0..3Shared Health ContactPointDetails of a Technology mediated contact point (phone, fax, email, etc.)
... address SI0..20Shared Health AddressAn address expressed using postal conventions (as opposed to GPS or other location definition formats)
... partOf SΣ0..1Reference(Organization)The organization of which this organization forms a part
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... reference ΣI0..1stringRelative, internal or absolute URL reference
.... display SΣ0..1stringParent Organization name
... contact 0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... 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

doco Documentation for this format

Grid View

This structure is derived from Shared Health Organization - Base

NameCard.TypeConstraints and Usage
.  Organization 0..*org-1: The organization SHALL at least have a name or an id, and possibly more than one
Definition:
A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.

..  id 1..1idDefinition:
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.


Comments:
Conformance Rule: This is the full url returned in the Provider Registry Query response. Example: https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/somepharmacy1CPRID Value = somepharmacy1CPRID

..  meta 1..1MetaDefinition:
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.

...  tag 1..*CodingSlice: Unordered, Open by value:system
Binding: (unbound) (example)
Definition:
Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource.


Comments:
The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored.

...  tag
       (version)
1..1CodingBinding: SharedSpecificationVersion (required)
Definition:
Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource.


Comments:
The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored.

....  system 1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion

....  code 1..1codeDefinition:
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).

..  extension 0..*ExtensionSlice: Unordered, Open by value:url
Definition:
An Extension

..  extension
     (service)
0..*Entity ServiceDefinition:
Identifies a electronic communication service offered by a service location or practitioner


Comments:
Entity Service is used at this level, when the service registration requires participation at both the Organization level and the Practitioner level. Both levels must be validated to confirm the outcome.

This is returned in the response when the service is determined to be active. It will be absent from the response when the service is no longer active.

..  identifier 1..1IdentifierDefinition:
Unique identifier for a healthcare service location


Comments:
Usage Note: This will convey the Organization ID (Clinic or Pharmacy) as assigned by the Shared Health Provider Registration service. This is known as the CPR ID and will be provided to each successfully registered Clinic or Pharmacy and can be stored in the local system.

Conformance Rule: The receiving system must use this field and insert as the"Receiver SERVICE_LOCATION_ENTITY_ID in a response message.

Usage Note: It has a one to one mapping to each SENDING_APPLICATION_INSTANCE_ID. This is also used by the Central Service to discover the application instance ID when routing the response message.hl7 MAPPING : SERVICE_LOCATION_IDENTIFIER

..  type 0..1Shared Health CodeableConcept CodeBinding: SharedOrganizationType (required)
Definition:
Describes the basic type or category of the service delivery location


Comments:
Distinguishes clinics from pharmacies. Binding value set. (PROFF - Provider's Office, OUTPHARM - outpatient pharmacy)

..  name 1..1stringMax Length: 100
Definition:
The name assigned to the service location.


Comments:
..  telecom 0..3Shared Health ContactPointcpt-2: A system is required if a value is provided.
org-3: The telecom of an organization can never be of use 'home'
Definition:
The phone numbers and/or electronic mail addresses by which a service location may be contacted.


Comments:
Conformance Rule: This is mandatory because the phone number is part of the written presciption.

Usage Note: This is used to specify the public Clinic or Pharmacy telephone number and/or a number of a private office number.

Conformance Rule: This is mandatory because the phone number is part of the written prescription. System (binding value set) + value + use (binding value set) must be provided.

Conformance Rule: Telecom structure is defined by Shared Health ContactPoint data type. There is a defined format to follow. Please refer to Shared Health Contact Point data type.

..  address 0..20Shared Health Addressorg-2: An address of an organization can never be of use 'home'
Definition:
An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations and which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.


Comments:
Conformance Rule: Address structure is defined by Shared Health Address data type. There are specific formats defined for string values as well as specific province and country codes to be used. Please refer to Shared Health Address data type profile.

Conformance Rule: Though the cardinality is 1..20, EMR and PMS must only include a single instance of address. Note: in future releases this may change to 1..1 formally.

..  partOf 0..1Reference(Organization)Definition:
The organization of which this organization forms a part.

...  display 0..1stringDefinition:
Plain text narrative that identifies the resource in addition to the resource reference.


Comments:
Usage Note: If present in the Provider Registry query response, it may be populated here.

This structure is derived from Shared Health Organization - Base

Summary

Mandatory: 5 elements
Must-Support: 10 elements
Fixed Value: 1 element

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

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

Differential View

This structure is derived from Shared Health Organization - Base

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization S0..*
... meta S1..1Meta
.... tag SCodingSlice: Unordered, Open by value:system
.... tag S1..1CodingBinding: SharedSpecificationVersion (required)
..... system S1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
..... code S1..1code
... extension S0..*ExtensionSlice: Unordered, Open by value:url
... ext-entity-service S0..*(Complex)Entity Service
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-entity-service
... name S1..1string
... partOf S0..1Reference(Organization)
.... display S0..1stringParent Organization name

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization SI0..*Clinic, Pharmacy or clinic/pharmacy chain
... id SΣ1..1idLogical id of this artifact
... meta SΣ1..1MetaMetadata about the resource
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ0..1instantWhen the resource version last changed
.... profile Σ0..*uriProfiles this resource claims to conform to
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible)
.... tag SΣCodingTags applied to this resource
Slice: Unordered, Open by value:system
Binding: (unbound) (example)
.... tag SΣ1..1CodingTags applied to this resource
Binding: SharedSpecificationVersion (required)
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... system SΣ1..1uriIdentity of the terminology system
Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion
..... version Σ0..1stringVersion of the system - if relevant
..... code SΣ1..1codeSymbol in syntax defined by the system
..... display Σ0..1stringRepresentation defined by the system
..... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: http://tools.ietf.org/html/bcp47 (required)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ext-entity-service S0..*(Complex)Entity Service
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-entity-service
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣI1..1IdentifierIdentifies this organization across multiple systems
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type S0..1Shared Health CodeableConcept CodeConcept - reference to a terminology or just text
Binding: SharedOrganizationType (required)
... name SΣI1..1stringName used for the organization
Max Length: 100
... telecom SI0..3Shared Health ContactPointDetails of a Technology mediated contact point (phone, fax, email, etc.)
... address SI0..20Shared Health AddressAn address expressed using postal conventions (as opposed to GPS or other location definition formats)
... partOf SΣ0..1Reference(Organization)The organization of which this organization forms a part
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... reference ΣI0..1stringRelative, internal or absolute URL reference
.... display SΣ0..1stringParent Organization name
... contact 0..*BackboneElementContact for the organization for a certain purpose
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... 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

doco Documentation for this format

 

Other representations of profile: Schematron

Terminology Bindings

PathNameConformanceValueSet
Organization.meta.securityAll Security LabelsextensibleAll Security Labels
Organization.meta.tagSharedSpecificationVersionrequiredSharedSpecificationVersion
Organization.meta.tagSharedSpecificationVersionrequiredSharedSpecificationVersion
Organization.language?extrequiredhttp://tools.ietf.org/html/bcp47
Organization.typeSharedOrganizationTyperequiredSharedOrganizationType
Organization.contact.purposeContactEntityTypeextensibleContactEntityType

Constraints

IdPathDetailsRequirements
org-1OrganizationThe organization SHALL at least have a name or an id, and possibly more than one
: identifier.exists() or name.exists()
cpt-2Organization.telecomA system is required if a value is provided.
: value.empty() or system.exists()
org-3Organization.telecomThe telecom of an organization can never be of use 'home'
: where(use = 'home').empty()
org-2Organization.addressAn address of an organization can never be of use 'home'
: where(use = 'home').empty()