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

# Organization

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

The relative url is /organizations

## Content

    <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.