The formal definitions for the elements in the organization resource. Also available as an XML file.
| Organization |
| Definition | For any company/corporation/institution/government department that has relevance to the care process |
| Control | 1..1 |
| RIM Mapping | Organization(classCode=ORG, determinerCode=INST) |
| 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..* |
| Type | string |
| 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.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.telecom |
| 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.type |
| Definition | The kind of organization that this is |
| Control | 0..1 |
| Type | CodeableConcept from OrganizationType |
| 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 |
| Organization.status |
| Definition | Indication of whether this organization's record is still active. |
| Control | 0..1 |
| Type | code from RecordStatus |
| Must Understand | true |
| Comments | Default is "active". |
| RIM Mapping | .status |
| To Do | This isn't data we record about an organization but is data about this organization's record. I would argue about including this metadata here. It also implies effects on functionality, like not showing up in queries anymore, which cannot be guaranteed. All in all, this belongs to record infrastructure, not data |
| Organization.accreditation |
| Definition | The qualifications/certifications an organization has, including format educational achievements, accreditations, and current certifications. All these qualifications may be used to determine what roles the organization may play in a healthcare environment |
| Control | 0..* |
| Requirements | For many organizations in healthcare, it is necessary to track the qualifications an organization has - formal. |
| RIM Mapping | .plays[Role](classCode='QUAL') |
| To Do | 1) Not sure if qualified & accredited are the same. 2) Could potentially propose a new classCode. We wonder if Accreditation is in the 80%. Accreditation is not part of the current PA domain, it was in Personnel Management but this has been retracted. The PM version also had many more attributes, so is this Accreditation good enough? We (current participants) do not use it. We decide to keep it, to see what happens in ballot |
| Organization.accreditation.identifier |
| Definition | The identifier of the accreditation |
| Control | 0..1 |
| Type | Identifier |
| Requirements | Allows a link back to a accreditation registry, if one exists |
| RIM Mapping | .identifier |
| Organization.accreditation.code |
| Definition | The type of the accreditation |
| Control | 0..1 |
| Type | CodeableConcept from OrganizationAccreditation |
| Requirements | commonly used to determine the roles an organization may perform |
| RIM Mapping | .code |
| Organization.accreditation.institution |
| Definition | The organization that conferred/confers the accreditation |
| Control | 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 | 0..1 |
| Type | Period |
| 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 that are related to this organization. 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 | TODO: No more "contains" or "part of"? |
| Organization.relatedOrganization.organization |
| Definition | The organization that is related to this organization |
| Control | 1..1 |
| Type | Resource(Organization) |
| Must Understand | true |
| Requirements | Need to know to which organization a relationship exists |
| Organization.relatedOrganization.type |
| Definition | Code that specifies how this organization is related to the subject. A code is required. |
| Control | 1..1 |
| Type | CodeableConcept from OrganizationRelationship |
| Requirements | Need to know how the organization is related |
| To Do | TODO: If we use CodeableConcept to codify the relationships, it is hard to compute what which organization is "part of" and which "contains". Furthermore, the current v3 binding (to RoleClass) uses the terms "player" and "scoper" to define the direction of the relationship. So, we would have to define that the current organization is the scoper, and the related organization the player? |
| Organization.contactPerson |
| Definition | Contact details for a person acting as a contact for the organization |
| Control | 0..* |
| Requirements | Apart from the address/contact of the organization itself, systems need to track which persons are acting as contact persons |
| RIM Mapping | .contactParty |
| Organization.contactPerson.type |
| Definition | Indicates a purpose for which the person can be contacted. |
| Control | 0..1 |
| Type | CodeableConcept from ContactPersonType |
| Requirements | Need to distinguish between multiple contact persons. |
| Organization.contactPerson.address |
| Definition | Address to use when contacting the contact person for this organization |
| Control | 0..1 |
| Type | Address |
| Comments | The use code home is not to be used. |
| RIM Mapping | .addr |
| Organization.contactPerson.telecom |
| Definition | Telecom details for the contact person at this organization |
| Control | 0..* |
| Type | Contact |
| Comments | The use code home is not to be used. |
| RIM Mapping | .telecom |
| Organization.contactPerson.name |
| Definition | Name of the contact person |
| Control | 0..1 |
| Type | HumanName |
| RIM Mapping | .contactPerson.name |
| Organization.contactPerson.person |
| Definition | Link to the actual person that is a contact person for the organization |
| Control | 0..1 |
| Type | Resource(Person) |
| RIM Mapping | .contactPerson |
| Organization.extension |
| Definition | See Extensions |
| Control | 0..* |
| Type | Extension |
| RIM Mapping | [varies] |
| Organization.text |
| Definition | Text summary of resource (for human interpretation) |
| Control | 1..1 |
| Type | Narrative |
| RIM Mapping | .text |
. Page versions: R5 R4B R4 R3 R2
This is an old version of FHIR retained for archive purposes. Do not use for anything else