FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.uv.xver-r4b.r5
Resource TypeConceptMap
IdConceptMap-R4B-Organization-element-map-to-R5.json
FHIR VersionR5
Sourcehttp://hl7.org/fhir/uv/xver-r4b.r5/0.1.0/ConceptMap-R4B-Organization-element-map-to-R5.html
URLhttp://hl7.org/fhir/uv/xver/ConceptMap/R4B-Organization-element-map-to-R5
Version0.1.0
Statusactive
Date2026-03-17T16:03:51.5834706-05:00
NameR4BOrganizationElementMapToR5
TitleCross-version mapping for FHIR R4B Organization to FHIR R5 Organization
Realmuv
Authorityhl7
DescriptionThis ConceptMap represents cross-version mappings for elements from a FHIR R4B Organization to FHIR R5.

Resources that use this resource

No resources found


Resources that this resource uses

StructureDefinition
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.addressR4B: An address for the organization (new)
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.contact.addressR4B: Visiting or postal addresses for the contact (new)
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.contact.nameR4B: A name associated with the contact (new)
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.contact.purposeR4B: The type of contact (new)
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.contact.telecomR4B: Contact details (telephone, email, etc.) for a contact (new)
hl7.fhir.uv.xver-r4b.r5#0.1.0extension-Organization.telecomR4B: A contact detail for the organization (new)

Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: ConceptMap R4B-Organization-element-map-to-R5

Mapping from http://hl7.org/fhir/4.3 to http://hl7.org/fhir/5.0


Group 1 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to Organizationversion: 5.0.0)

Source CodeRelationshipTarget CodeComment
Organization.meta (meta)is equivalent toOrganization.metaElement `Organization.meta` is mapped to FHIR R5 element `Organization.meta` as `Equivalent`.
Organization.implicitRules (implicitRules)is equivalent toOrganization.implicitRulesElement `Organization.implicitRules` is mapped to FHIR R5 element `Organization.implicitRules` as `Equivalent`. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.
Organization.language (language)is equivalent toOrganization.languageElement `Organization.language` is mapped to FHIR R5 element `Organization.language` as `Equivalent`. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).
Organization.text (text)is equivalent toOrganization.textElement `Organization.text` is mapped to FHIR R5 element `Organization.text` as `Equivalent`. Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.
Organization.contained (contained)is equivalent toOrganization.containedElement `Organization.contained` is mapped to FHIR R5 element `Organization.contained` as `Equivalent`. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
Organization.identifier (identifier)is equivalent toOrganization.identifierElement `Organization.identifier` is mapped to FHIR R5 element `Organization.identifier` as `Equivalent`.
Organization.active (active)is equivalent toOrganization.activeElement `Organization.active` is mapped to FHIR R5 element `Organization.active` as `Equivalent`. 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.
Organization.type (type)is equivalent toOrganization.typeElement `Organization.type` is mapped to FHIR R5 element `Organization.type` as `Equivalent`. 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.
Organization.name (name)is equivalent toOrganization.nameElement `Organization.name` is mapped to FHIR R5 element `Organization.name` as `Equivalent`. 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.
Organization.alias (alias)is equivalent toOrganization.aliasElement `Organization.alias` is mapped to FHIR R5 element `Organization.alias` as `Equivalent`. 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.
Organization.partOf (partOf)is equivalent toOrganization.partOfElement `Organization.partOf` is mapped to FHIR R5 element `Organization.partOf` as `Equivalent`.
Organization.contact (contact)is broader thanOrganization.contactElement `Organization.contact` is mapped to FHIR R5 element `Organization.contact` as `Equivalent`. Where multiple contacts for the same purpose are provided there is a standard extension that can be used to determine which one is the preferred contact to use.
Organization.endpoint (endpoint)is equivalent toOrganization.endpointElement `Organization.endpoint` is mapped to FHIR R5 element `Organization.endpoint` as `Equivalent`.

Group 2 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: A contact detail for the organization (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.telecom (telecom)is broader thanExtension (R4B: A contact detail for the organization (new))Element `Organization.telecom` has a context of Organization based on following the parent source element upwards and mapping to `Organization`. Element `Organization.telecom` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element). 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.

Group 3 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: An address for the organization (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.address (address)is broader thanExtension (R4B: An address for the organization (new))Element `Organization.address` has a context of Organization based on following the parent source element upwards and mapping to `Organization`. Element `Organization.address` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element). Organization may have multiple addresses with different uses or applicable periods. The use code 'home' is not to be used.

Group 4 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: The type of contact (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.contact.purpose (purpose)is broader thanExtension (R4B: The type of contact (new))Element `Organization.contact.purpose` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`. Element `Organization.contact.purpose` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).

Group 5 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: A name associated with the contact (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.contact.name (name)is broader thanExtension (R4B: A name associated with the contact (new))Element `Organization.contact.name` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`. Element `Organization.contact.name` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).

Group 6 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: Contact details (telephone, email, etc.) for a contact (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.contact.telecom (telecom)is broader thanExtension (R4B: Contact details (telephone, email, etc.) for a contact (new))Element `Organization.contact.telecom` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`. Element `Organization.contact.telecom` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).

Group 7 Mapping from http://hl7.org/fhir/StructureDefinition/Organization|4.3.0 to R4B: Visiting or postal addresses for the contact (new)version: 0.1.0)

Source CodeRelationshipTarget CodeComment
Organization.contact.address (address)is broader thanExtension (R4B: Visiting or postal addresses for the contact (new))Element `Organization.contact.address` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`. Element `Organization.contact.address` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).

Source1

{
  "resourceType": "ConceptMap",
  "id": "R4B-Organization-element-map-to-R5",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 0,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r4b.r5"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r4b.r5"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/xver/ConceptMap/R4B-Organization-element-map-to-R5",
  "version": "0.1.0",
  "name": "R4BOrganizationElementMapToR5",
  "title": "Cross-version mapping for FHIR R4B Organization to FHIR R5 Organization",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:03:51.5834706-05:00",
  "contact": [
    {
      "name": "FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "This ConceptMap represents cross-version mappings for elements from a FHIR R4B Organization to FHIR R5.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "sourceScopeCanonical": "http://hl7.org/fhir/4.3",
  "targetScopeUri": "http://hl7.org/fhir/5.0",
  "group": [
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/StructureDefinition/Organization|5.0.0",
      "element": [
        {
          "code": "Organization.meta",
          "display": "meta",
          "target": [
            {
              "code": "Organization.meta",
              "display": "Organization.meta",
              "relationship": "equivalent",
              "comment": "Element `Organization.meta` is mapped to FHIR R5 element `Organization.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Organization.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "Organization.implicitRules",
              "display": "Organization.implicitRules",
              "relationship": "equivalent",
              "comment": "Element `Organization.implicitRules` is mapped to FHIR R5 element `Organization.implicitRules` as `Equivalent`.\nAsserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc."
            }
          ]
        },
        {
          "code": "Organization.language",
          "display": "language",
          "target": [
            {
              "code": "Organization.language",
              "display": "Organization.language",
              "relationship": "equivalent",
              "comment": "Element `Organization.language` is mapped to FHIR R5 element `Organization.language` as `Equivalent`.\nLanguage is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies  to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute)."
            }
          ]
        },
        {
          "code": "Organization.text",
          "display": "text",
          "target": [
            {
              "code": "Organization.text",
              "display": "Organization.text",
              "relationship": "equivalent",
              "comment": "Element `Organization.text` is mapped to FHIR R5 element `Organization.text` as `Equivalent`.\nContained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).  This may be necessary for data from legacy systems where information is captured as a \"text blob\" or where text is additionally entered raw or narrated and encoded information is added later."
            }
          ]
        },
        {
          "code": "Organization.contained",
          "display": "contained",
          "target": [
            {
              "code": "Organization.contained",
              "display": "Organization.contained",
              "relationship": "equivalent",
              "comment": "Element `Organization.contained` is mapped to FHIR R5 element `Organization.contained` as `Equivalent`.\nThis should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels."
            }
          ]
        },
        {
          "code": "Organization.identifier",
          "display": "identifier",
          "target": [
            {
              "code": "Organization.identifier",
              "display": "Organization.identifier",
              "relationship": "equivalent",
              "comment": "Element `Organization.identifier` is mapped to FHIR R5 element `Organization.identifier` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Organization.active",
          "display": "active",
          "target": [
            {
              "code": "Organization.active",
              "display": "Organization.active",
              "relationship": "equivalent",
              "comment": "Element `Organization.active` is mapped to FHIR R5 element `Organization.active` as `Equivalent`.\nThis 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.\n\nThis element is labeled as a modifier because it may be used to mark that the resource was created in error."
            }
          ]
        },
        {
          "code": "Organization.type",
          "display": "type",
          "target": [
            {
              "code": "Organization.type",
              "display": "Organization.type",
              "relationship": "equivalent",
              "comment": "Element `Organization.type` is mapped to FHIR R5 element `Organization.type` as `Equivalent`.\nOrganizations 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\n\nWhen 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.\n\nWe expect that some jurisdictions will profile this optionality to be a single cardinality."
            }
          ]
        },
        {
          "code": "Organization.name",
          "display": "name",
          "target": [
            {
              "code": "Organization.name",
              "display": "Organization.name",
              "relationship": "equivalent",
              "comment": "Element `Organization.name` is mapped to FHIR R5 element `Organization.name` as `Equivalent`.\nIf the name of an organization changes, consider putting the old name in the alias column so that it can still be located through searches."
            }
          ]
        },
        {
          "code": "Organization.alias",
          "display": "alias",
          "target": [
            {
              "code": "Organization.alias",
              "display": "Organization.alias",
              "relationship": "equivalent",
              "comment": "Element `Organization.alias` is mapped to FHIR R5 element `Organization.alias` as `Equivalent`.\nThere 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."
            }
          ]
        },
        {
          "code": "Organization.partOf",
          "display": "partOf",
          "target": [
            {
              "code": "Organization.partOf",
              "display": "Organization.partOf",
              "relationship": "equivalent",
              "comment": "Element `Organization.partOf` is mapped to FHIR R5 element `Organization.partOf` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Organization.contact",
          "display": "contact",
          "target": [
            {
              "code": "Organization.contact",
              "display": "Organization.contact",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.contact` is mapped to FHIR R5 element `Organization.contact` as `Equivalent`.\nWhere multiple contacts for the same purpose are provided there is a standard extension that can be used to determine which one is the preferred contact to use."
            }
          ]
        },
        {
          "code": "Organization.endpoint",
          "display": "endpoint",
          "target": [
            {
              "code": "Organization.endpoint",
              "display": "Organization.endpoint",
              "relationship": "equivalent",
              "comment": "Element `Organization.endpoint` is mapped to FHIR R5 element `Organization.endpoint` as `Equivalent`."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.telecom|0.1.0",
      "element": [
        {
          "code": "Organization.telecom",
          "display": "telecom",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.telecom` has a context of Organization based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.telecom` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).\nThe 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."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.address|0.1.0",
      "element": [
        {
          "code": "Organization.address",
          "display": "address",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.address` has a context of Organization based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.address` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).\nOrganization may have multiple addresses with different uses or applicable periods. The use code 'home' is not to be used."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.contact.purpose|0.1.0",
      "element": [
        {
          "code": "Organization.contact.purpose",
          "display": "purpose",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.contact.purpose` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.contact.purpose` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element)."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.contact.name|0.1.0",
      "element": [
        {
          "code": "Organization.contact.name",
          "display": "name",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.contact.name` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.contact.name` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element)."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.contact.telecom|0.1.0",
      "element": [
        {
          "code": "Organization.contact.telecom",
          "display": "telecom",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.contact.telecom` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.contact.telecom` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element)."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Organization|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Organization.contact.address|0.1.0",
      "element": [
        {
          "code": "Organization.contact.address",
          "display": "address",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Organization.contact.address` has a context of Organization.contact based on following the parent source element upwards and mapping to `Organization`.\nElement `Organization.contact.address` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element)."
            }
          ]
        }
      ]
    }
  ]
}