Organization R5 (FHIR) at fhirtruck

Path

Organization

Id

Organization

Cardinality

0 - *

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, payer/insurer, etc.

Comment

Constraint

dom-2 [error]

If the resource is contained in another resource, it SHALL NOT contain nested Resources

dom-3 [error]

If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource

dom-4 [error]

If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated

dom-5 [error]

If a resource is contained in another resource, it SHALL NOT have a security label

dom-6 [warning]

A resource should have narrative for robust management

org-1 [error]

The organization SHALL at least have a name or an identifier, and possibly more than one

Path

Organization.identifier

Id

Organization.identifier

Type

Identifier

Cardinality

0 - *

Definition

Identifier for the organization that is used to identify the organization across multiple disparate systems.

Comment

Requirements

Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

org-1

use

Summary: The element appears in the summary view

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

coding

List: This element is a list and more than one value can be provided

Coding

Code defined by a terminology system

system

uri

Identity of the terminology system

version

string

Version of the system - if relevant

code

Symbol in syntax defined by the system

display

string

Representation defined by the system

userSelected

boolean

If this coding was chosen directly by the user

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

assigner

Reference

Organization that issued id (may be just text)

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.identifier.Identifier.assigner.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

assigner

Reference

Organization that issued id (may be just text)

display

string

Text alternative for the resource

Path

Organization.active

Id

Organization.active

Type

boolean

Cardinality

0 - 1

Definition

Whether the organization's record is still in active use.

Comment

This active flag is not intended to be used to mark an organization as temporarily closed or under construction. Instead the Location(s) within the Organization should have the suspended status. If further details of the reason for the suspension are required, then an extension on this element should be used. This element is labeled as a modifier because it may be used to mark that the resource was created in error.

Requirements

Need a flag to indicate a record is no longer to be used and should generally be hidden for the user in the UI.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Path

Organization.type

Id

Organization.type

Type

CodeableConcept

Cardinality

0 - *

Definition

The kind(s) of organization that this is.

Comment

Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center. We expect that some jurisdictions will profile this optionality to be a single cardinality.

Requirements

Need to be able to track the kind of organization that this is - different organization types have different uses.

Binding

Strength

example

Description

Used to categorize the organization.

ValueSet

http://hl7.org/fhir/ValueSet/organization-type

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

coding

Coding

Code defined by a terminology system

system

uri

Identity of the terminology system

version

string

Version of the system - if relevant

code

Symbol in syntax defined by the system

display

string

Representation defined by the system

userSelected

boolean

If this coding was chosen directly by the user

Path

Organization.name

Id

Organization.name

Type

string

Cardinality

0 - 1

Definition

A name associated with the organization.

Comment

If the name of an organization changes, consider putting the old name in the alias column so that it can still be located through searches.

Requirements

Need to use the name as the label of the organization.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

org-1

Path

Organization.alias

Id

Organization.alias

Type

string

Cardinality

0 - *

Definition

A list of alternate names that the organization is known as, or was known as in the past.

Comment

There are no dates associated with the alias/historic names, as this is not intended to track when names were used, but to assist in searching so that older names can still result in identifying the organization.

Requirements

Over time locations and organizations go through many changes and can be known by different names. For searching knowing previous names that the organization was known by can be very useful.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Path

Organization.description

Id

Organization.description

Type

markdown

Cardinality

0 - 1

Definition

Description of the organization, which helps provide additional general context on the organization to ensure that the correct organization is selected.

Comment

Requirements

Humans need additional information to verify a correct Organization has been selected.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Path

Organization.contact

Id

Organization.contact

Type

ExtendedContactDetail

Cardinality

0 - *

Definition

The contact details of communication devices available relevant to the specific Organization. This can include addresses, phone numbers, fax numbers, mobile numbers, email addresses and web sites.

Comment

The address/telecom use code 'home' are not to be used. Note that these contacts are not the contact details of people who provide the service (that would be through PractitionerRole), these are official contacts for the Organization itself for specific purposes. E.g. Mailing Addresses, Billing Addresses, Contact numbers for Booking or Billing Enquiries, general web address, web address for online bookings etc.

Requirements

Need to keep track of assigned contact points within bigger organization.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

org-3 [error]

The telecom of an organization can never be of use 'home'

org-4 [error]

The address of an organization can never be of use 'home'

purpose

CodeableConcept

The type of contact

coding

Coding

Code defined by a terminology system

system

uri

Identity of the terminology system

version

string

Version of the system - if relevant

code

Symbol in syntax defined by the system

display

string

Representation defined by the system

userSelected

boolean

If this coding was chosen directly by the user

name

HumanName

Name of an individual to contact

use

code

family

string

Family name (often called 'Surname')

given

string

Given names (not always 'first'). Includes middle names

prefix

string

Parts that come before the name

suffix

string

Parts that come after the name

period

Period

Time period when name was/is in use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

telecom

ContactPoint

Contact details (e.g.phone/fax/url)

system

code

phone | fax | email | pager | url | sms | other

value

string

The actual contact point details

use

code

home | work | temp | old | mobile - purpose of this contact point

rank

positiveInt

Specify preferred order of use (1 = highest)

period

Period

Time period when the contact point was/is in use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

address

Address

Address for the contact

use

code

home | work | temp | old | billing - purpose of this address

type

code

postal | physical | both

line

string

Street name, number, direction & P.O. Box etc.

city

string

Name of city, town etc.

district

string

District name (aka county)

state

string

Sub-unit of country (abbreviations ok)

postalCode

string

Postal code for area

country

string

Country (e.g. may be ISO 3166 2 or 3 letter code)

period

Period

Time period when address was/is in use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

organization

Reference

This contact detail is handled/monitored by a specific organization

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.contact.ExtendedContactDetail.organization.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

assigner

Reference

Organization that issued id (may be just text)

display

string

Text alternative for the resource

period

Period

Period that this contact was valid for usage

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

Path

Organization.partOf

Id

Organization.partOf

Type

Reference

Cardinality

0 - 1

Definition

The organization of which this organization forms a part.

Comment

Requirements

Need to be able to track the hierarchy of organizations within an organization.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.partOf.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

assigner

Reference

Organization that issued id (may be just text)

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.partOf.Reference.identifier.Identifier.assigner.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

display

string

Text alternative for the resource

display

string

Text alternative for the resource

Path

Organization.endpoint

Id

Organization.endpoint

Type

Reference

Cardinality

0 - *

Definition

Technical endpoints providing access to services operated for the organization.

Comment

Requirements

Organizations have multiple systems that provide various services and need to be able to define the technical connection details for how to connect to them, and for what purpose.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.endpoint.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

assigner

Reference

Organization that issued id (may be just text)

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.endpoint.Reference.identifier.Identifier.assigner.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

display

string

Text alternative for the resource

display

string

Text alternative for the resource

Path

Organization.qualification

Id

Organization.qualification

Type

BackboneElement

Cardinality

0 - *

Definition

The official certifications, accreditations, training, designations and licenses that authorize and/or otherwise endorse the provision of care by the organization. For example, an approval to provide a type of services issued by a certifying body (such as the US Joint Commission) to an organization.

Comment

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Path

Organization.qualification.identifier

Id

Organization.qualification.identifier

Type

Identifier

Cardinality

0 - *

Definition

An identifier allocated to this qualification for this organization.

Comment

Requirements

Often, specific identities are assigned for the qualification by the assigning organization.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

assigner

Reference

Organization that issued id (may be just text)

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.qualification.identifier.Identifier.assigner.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

display

string

Text alternative for the resource

Path

Organization.qualification.code

Id

Organization.qualification.code

Type

CodeableConcept

Cardinality

1 - 1

Definition

Coded representation of the qualification.

Comment

Binding

Strength

example

Description

Specific qualification the organization has to provide a service.

ValueSet

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

coding

Coding

Code defined by a terminology system

system

uri

Identity of the terminology system

version

string

Version of the system - if relevant

code

Symbol in syntax defined by the system

display

string

Representation defined by the system

userSelected

boolean

If this coding was chosen directly by the user

Path

Organization.qualification.period

Id

Organization.qualification.period

Type

Period

Cardinality

0 - 1

Definition

Period during which the qualification is valid.

Comment

Requirements

Qualifications are often for a limited period of time, and can be revoked.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

start

dateTime

Starting time with inclusive boundary

end

dateTime

End time with inclusive boundary, if not ongoing

Path

Organization.qualification.issuer

Id

Organization.qualification.issuer

Type

Reference

Cardinality

0 - 1

Definition

Organization that regulates and issues the qualification.

Comment

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

reference

string

Literal reference, Relative, internal or absolute URL

type

uri

Type the reference refers to (e.g. "Patient") - must be a resource in resources

identifier

Identifier

Logical reference, when literal reference is not known

Path

Organization.qualification.issuer.Reference.identifier

Id

Reference.identifier

Type

Identifier

Cardinality

0 - 1

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comment

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). This element only allows for a single identifier. In the case where additional identifers are required, use the [http://hl7.org/fhir/StructureDefinition/additionalIdentifier](http://hl7.org/fhir/extensions/StructureDefinition-additionalIdentifier.html) extension.

Constraint

ele-1 [error]

All FHIR elements must have a @value or children

Condition

ref-2

use

code

usual | official | temp | secondary | old (If known)

type

CodeableConcept

Description of identifier

system

uri

The namespace for the identifier value

value

string

The value that is unique

period

Period

Time period when id is/was valid for use

assigner

Reference

Organization that issued id (may be just text)

display

string

Text alternative for the resource