This page is part of the FHIR Specification (v0.01: Historical Archive Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Organization

For any organization/institution/government department that has relevance to the care process.

The relative url is /organizations

Content

UML Image

<Organization xmlns="http://www.hl7.org/fhir">
  <id> mand id Master Resource Id, always first in all resources</id>
  <identifier> Zero+ HumanId Identifier for this organization</identifier>
  <name>  <!-- Zero+ -->
   <value> mand string A name associated with the organization</value>
   <period> opt Interval(date) When this name is/was in use</period>
  </name>
  <address> Zero+ Address An address for the organization</address>
  <contact> Zero+ Contact A contact detail for the organization</contact>
  <code> opt CodeableConcept kind of organisation</code>
  <industryCode> opt CodeableConcept kind of industry</industryCode>
  <accreditation>  <!-- Zero+ -->
   <id> opt Identifier Identifier for the accreditation</id>
   <code> opt CodeableConcept What kind of accreditation</code>
   <institution> opt (Organization) Who conferred it</institution>
   <period> opt Interval(date) When the accreditation is valid</period>
  </accreditation>
  <relatedOrganization>  <!-- Zero+ sub-, super-, and partner organisations -->
   <id> opt HumanId Identifier for the organization</id>
   <code> mand CodeableConcept How the organizations are related</code>
   <name> opt string Name of the organization</name>
   <address> Zero+ Address An address for the organization</address>
   <contact> Zero+ Contact General contact details for the organization</contact>
   <period> opt Interval(date) When the organizations were related</period>
  </relatedOrganization>
  <extensions> opt See Extensions   See Extensions </extensions>
  <text> Narrative Text summary of organization, fall back for human interpretation</text>
</Organization>

Schema for Organization and an example (or formatted for browser)

Terminology Bindings

Organization.code is bound to the concept domain OrganisationType: "The type of an organisation". A good candidate for codes is SNOMED-CT, and the HL7 v3 Entity Code table
Organization.industryCode is bound to the concept domain Industry: "Code for the type of industry". For example values, see HL7 v3 OrganizationIndustryClass value set
Organization.accreditation.code is bound to the concept domain Accreditation: "Accreditations an organization may be granted"
Organization.relatedOrganization.code is bound to the concept domain OrganizationRelationship: "The relationship an organization has to the subject, including sub and super organizations, and other kind of relationships such as partner organisations"

Notes:

The organization references are all optional, so can be replaced by simple text rather than a full resource reference

Searching Criteria

The following simple search/filter parameters are defined for organization:

name	a portion of name in any name part
phonetic	a portion of name using some kind of phonetic matching algorithm
id	search id in any identifiers

The standard search parameters also apply (see Searching).

Formal Definitions

The formal definitions for the elements above. Also available as an XML file.

Organization
Definition	For any organization/institution/government department that has relevance to the care process
Control	Mandatory, 1..1
RIM Mapping	Organization(classCode=ORG, determinerCode=INST)
Organization.id
Definition	Master Resource Id, always first in all resources
Control	Mandatory, 1..1
Type	id
RIM Mapping	.id(scope=OBJ)
Organization.identifier
Definition	Identifier for the organization that is used to identify the organization across multiple disparate systems
Control	0..*
Type	HumanId
Must Understand	true
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.
RIM Mapping	.scopes[Role](classCode=IDENT)
Organization.name
Definition	A name associated with the organization
Control	0..*
Must Understand	true
Requirements	Need to use the name as the label of the organization
Comments	Don't use HumanName since that has many non-organization things in it
RIM Mapping	.name
Organization.name.value
Definition	The actual name of the organization
Control	Mandatory, 1..1
Type	string
Must Understand	true
RIM Mapping	.part[1](type=NULL,qualifier=NULL).value
Organization.name.period
Definition	The period that this name was in use by the organization
Control	Optional, 0..1
Type	Interval(date)
Requirements	Organizations have a habit of renaming themselves, and the current and past names are required
RIM Mapping	.validTime
To Do	This is 80%??
Organization.address
Definition	An address for the organization
Control	0..*
Type	Address
Requirements	May need to keep track of the organizations addresses for contacting, billing or reporting requirements
Comments	Organization may have multiple addresses with different uses or applicable periods. The use code home is not to be used
RIM Mapping	.address
Organization.contact
Definition	A contact detail for the organization
Control	0..*
Type	Contact
Requirements	Human contact for the organization
Comments	The use code home is not to be used. Note that these contacts are not the contact details of people who are employed by or represent the organization, but official contacts for the organization itself
RIM Mapping	.telecom
Organization.code
Definition	The kind of organization that this is
Control	Optional, 0..1
Type	CodeableConcept from OrganisationType
Requirements	Need to be able to track the kind of organization that this is - different organization types have different uses
Comments	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
RIM Mapping	.code
To Do	Name code is too RIM-like. Should be typeCode or type.
Organization.industryCode
Definition	The industry that this organization is involved in
Control	Optional, 0..1
Type	CodeableConcept from Industry
Requirements	For some organization types, an industry code is required for statistical reporting requirements
RIM Mapping	.standardIndustryClassCode
To Do	Is this really in the 80%??
Organization.accreditation
Definition	The qualifications a person has, including format educational achievements, accreditations, and current certifications. All these qualifications may be used to determine what roles a person may play in a healthcare environment
Control	0..*
Requirements	For many persons in healthcare, it is necessary to track the qualifications a person has - formal.
RIM Mapping	.plays[Role](classCode='QUAL')
To Do	Not sure if qualified & accredited are the same. Could potentially propose a new classCode
Organization.accreditation.id
Definition	The identifier of the accreditation
Control	Optional, 0..1
Type	Identifier
Requirements	Allows a link back to a accreditation registry, if one exists
RIM Mapping	.identifier
To Do	Not a humanId?
Organization.accreditation.code
Definition	The type of the accreditation
Control	Optional, 0..1
Type	CodeableConcept from Accreditation
Requirements	commonly used to determine the roles an organization may perform
RIM Mapping	.code
Organization.accreditation.institution
Definition	The organization that confered/confers the accreditation
Control	Optional, 0..1
Type	Resource(Organization)
Requirements	May determine the significance of the qualification, and allows a link back to a qualification registry, if one exists
RIM Mapping	.scopedBy[Organization]
To Do	Do we need jurisdiction as well? (The jurisdiction is often more relevant than the accrediting org.)
Organization.accreditation.period
Definition	The period for which the accreditation is held
Control	Optional, 0..1
Type	Interval(date)
Requirements	Most accreditations are only conferred for a limited time period and must be re-acquired or forfeited
RIM Mapping	.effectiveTime[IVL<TS>]
Organization.relatedOrganization
Definition	Other organizations who are related to this person. The relationship might be one of several types: sub- or super- orgnizations (i.e. ward in a hospital, owning corporation of a hospital) or partner organizations (i.e. the operating corporation for a hospital)
Control	0..*
Requirements	Need to be able to track many kinds of organizational relationships and use to determine roles and mediate workflows
To Do	There's no reason why this wouldn't point to another resource. Will map when updated accordingly.
Organization.relatedOrganization.id
Definition	Identifier the related organization - may be a full link to an Organization resource, or some other kind of identifier
Control	Optional, 0..1
Type	HumanId
Requirements	may have an identifier for the organization that can be used to source contact details
Organization.relatedOrganization.code
Definition	Code that specifies how this organization is related to the subject. A code is required.
Control	Mandatory, 1..1
Type	CodeableConcept from OrganizationRelationship
Requirements	Need to know how the organization is related
Organization.relatedOrganization.name
Definition	A name should be specified for the related organization
Control	Optional, 0..1
Type	string
Organization.relatedOrganization.address
Definition	Postal addresses may be provided for the related organization
Control	0..*
Type	Address
Organization.relatedOrganization.contact
Definition	Contact details (phone, email etc) may be provided for the related organization
Control	0..*
Type	Contact
Organization.relatedOrganization.period
Definition	The period during which the organizations were related in this fashion
Control	Optional, 0..1
Type	Interval(date)
Requirements	Organization relationships are changing all the time
Organization.extensions
Definition	See Extensions
Control	Optional, 0..1
RIM Mapping	[varies]
Organization.text
Definition	Text summary of organization, fall back for human interpretation
Control	1..1
Type	Narrative
To Do	.text

This is an old version of FHIR retained for archive purposes. Do not use for anything else
Implementers are welcome to experiment with the content defined here, but should note that the contents are subject to change without prior notice.
© HL7.org 2011 - 2012. FHIR v0.01 generated on Mon, May 14, 2012 09:48+1000.