<status value="active"/> <experimental value="false"/> <date value="2026-03-17T16:03:23.1728085-05:00"/> <contact> <name value="FHIR Infrastructure"/> <telecom> <system value="url"/> <value value="http://www.hl7.org/Special/committees/fiwg"/> </telecom> </contact> <description value="This ConceptMap represents cross-version mappings for elements from a FHIR STU3 Bundle to FHIR R4."/> <jurisdiction> <coding> <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/> <code value="001"/> <display value="World"/> </coding> </jurisdiction> <sourceCanonical value="http://hl7.org/fhir/3.0"/> <targetUri value="http://hl7.org/fhir/4.0"/> <group> <source value="http://hl7.org/fhir/StructureDefinition/Bundle"/> <sourceVersion value="3.0.2"/> <target value="http://hl7.org/fhir/StructureDefinition/Bundle"/> <targetVersion value="4.0.1"/> <element> <code value="Bundle.meta"/> <display value="meta"/> <target> <code value="Bundle.meta"/> <display value="Bundle.meta"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.meta` is mapped to FHIR R4 element `Bundle.meta` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.implicitRules"/> <display value="implicitRules"/> <target> <code value="Bundle.implicitRules"/> <display value="Bundle.implicitRules"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.implicitRules` is mapped to FHIR R4 element `Bundle.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. This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation."/> </target> </element> <element> <code value="Bundle.language"/> <display value="language"/> <target> <code value="Bundle.language"/> <display value="Bundle.language"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.language` is mapped to FHIR R4 element `Bundle.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)."/> </target> </element> <element> <code value="Bundle.identifier"/> <display value="identifier"/> <target> <code value="Bundle.identifier"/> <display value="Bundle.identifier"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.identifier` is mapped to FHIR R4 element `Bundle.identifier` as `Equivalent`. Persistent identity generally only matters for batches of type Document, Message, and Collection. It would not normally be populated for search and history results, and servers ignore Bundle.identifier when processing batches and transactions. For Documents the .identifier SHALL be populated such that the .identifier is globally unique."/> </target> </element> <element> <code value="Bundle.type"/> <display value="type"/> <target> <code value="Bundle.type"/> <display value="Bundle.type"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.type` is mapped to FHIR R4 element `Bundle.type` as `Equivalent`. It's possible to use a bundle for other purposes (e.g. a document can be accepted as a transaction). This is primarily defined so that there can be specific rules for some of the bundle types."/> </target> </element> <element> <code value="Bundle.total"/> <display value="total"/> <target> <code value="Bundle.total"/> <display value="Bundle.total"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.total` is mapped to FHIR R4 element `Bundle.total` as `Equivalent`. Only used if the bundle is a search result set. The total does not include resources such as OperationOutcome and included resources, only the total number of matching resources."/> </target> </element> <element> <code value="Bundle.link"/> <display value="link"/> <target> <code value="Bundle.link"/> <display value="Bundle.link"/> <equivalence value="wider"/> <comment value="Element `Bundle.link` is mapped to FHIR R4 element `Bundle.link` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.link.relation"/> <display value="relation"/> <target> <code value="Bundle.link.relation"/> <display value="Bundle.link.relation"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.link.relation` is mapped to FHIR R4 element `Bundle.link.relation` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.link.url"/> <display value="url"/> <target> <code value="Bundle.link.url"/> <display value="Bundle.link.url"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.link.url` is mapped to FHIR R4 element `Bundle.link.url` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry"/> <display value="entry"/> <target> <code value="Bundle.entry"/> <display value="Bundle.entry"/> <equivalence value="wider"/> <comment value="Element `Bundle.entry` is mapped to FHIR R4 element `Bundle.entry` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.link"/> <display value="link"/> <target> <code value="Bundle.entry.link"/> <display value="Bundle.entry.link"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.link` is mapped to FHIR R4 element `Bundle.entry.link` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.fullUrl"/> <display value="fullUrl"/> <target> <code value="Bundle.entry.fullUrl"/> <display value="Bundle.entry.fullUrl"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.fullUrl` is mapped to FHIR R4 element `Bundle.entry.fullUrl` as `Equivalent`. fullUrl may not be [unique in the context of a resource](https://hl7.org/fhir/bundle.html#bu.html#bundle-unique). Note that since [FHIR resources do not need to be served through the FHIR API](https://hl7.org/fhir/references.html), the absolute URL may not end with the logical id of the resource (Resource.id), but if the fullUrl does look like a RESTful server URL (e.g. meets the [regex](https://hl7.org/fhir/refere.html#regex), then it SHALL end with the Resource.id."/> </target> </element> <element> <code value="Bundle.entry.resource"/> <display value="resource"/> <target> <code value="Bundle.entry.resource"/> <display value="Bundle.entry.resource"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.resource` is mapped to FHIR R4 element `Bundle.entry.resource` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.search"/> <display value="search"/> <target> <code value="Bundle.entry.search"/> <display value="Bundle.entry.search"/> <equivalence value="wider"/> <comment value="Element `Bundle.entry.search` is mapped to FHIR R4 element `Bundle.entry.search` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.search.mode"/> <display value="mode"/> <target> <code value="Bundle.entry.search.mode"/> <display value="Bundle.entry.search.mode"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.search.mode` is mapped to FHIR R4 element `Bundle.entry.search.mode` as `Equivalent`. There is only one mode. In some corner cases, a resource may be included because it is both a match and an include. In these circumstances, 'match' takes precedence."/> </target> </element> <element> <code value="Bundle.entry.search.score"/> <display value="score"/> <target> <code value="Bundle.entry.search.score"/> <display value="Bundle.entry.search.score"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.search.score` is mapped to FHIR R4 element `Bundle.entry.search.score` as `Equivalent`. Servers are not required to return a ranking score. 1 is most relevant, and 0 is least relevant. Often, search results are sorted by score, but the client may specify a different sort order."/> </target> </element> <element> <code value="Bundle.entry.request"/> <display value="request"/> <target> <code value="Bundle.entry.request"/> <display value="Bundle.entry.request"/> <equivalence value="wider"/> <comment value="Element `Bundle.entry.request` is mapped to FHIR R4 element `Bundle.entry.request` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.request.method"/> <display value="method"/> <target> <code value="Bundle.entry.request.method"/> <display value="Bundle.entry.request.method"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.method` is mapped to FHIR R4 element `Bundle.entry.request.method` as `SourceIsNarrowerThanTarget`. The mappings for `Bundle.entry.request.method` do not allow expression of the necessary codes, per the bindings on the source and target."/> </target> </element> <element> <code value="Bundle.entry.request.url"/> <display value="url"/> <target> <code value="Bundle.entry.request.url"/> <display value="Bundle.entry.request.url"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.url` is mapped to FHIR R4 element `Bundle.entry.request.url` as `Equivalent`. E.g. for a Patient Create, the method would be "POST" and the URL would be "Patient". For a Patient Update, the method would be PUT, and the URL would be "Patient/[id]"."/> </target> </element> <element> <code value="Bundle.entry.request.ifNoneMatch"/> <display value="ifNoneMatch"/> <target> <code value="Bundle.entry.request.ifNoneMatch"/> <display value="Bundle.entry.request.ifNoneMatch"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.ifNoneMatch` is mapped to FHIR R4 element `Bundle.entry.request.ifNoneMatch` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.request.ifModifiedSince"/> <display value="ifModifiedSince"/> <target> <code value="Bundle.entry.request.ifModifiedSince"/> <display value="Bundle.entry.request.ifModifiedSince"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.ifModifiedSince` is mapped to FHIR R4 element `Bundle.entry.request.ifModifiedSince` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.request.ifMatch"/> <display value="ifMatch"/> <target> <code value="Bundle.entry.request.ifMatch"/> <display value="Bundle.entry.request.ifMatch"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.ifMatch` is mapped to FHIR R4 element `Bundle.entry.request.ifMatch` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.request.ifNoneExist"/> <display value="ifNoneExist"/> <target> <code value="Bundle.entry.request.ifNoneExist"/> <display value="Bundle.entry.request.ifNoneExist"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.request.ifNoneExist` is mapped to FHIR R4 element `Bundle.entry.request.ifNoneExist` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.response"/> <display value="response"/> <target> <code value="Bundle.entry.response"/> <display value="Bundle.entry.response"/> <equivalence value="wider"/> <comment value="Element `Bundle.entry.response` is mapped to FHIR R4 element `Bundle.entry.response` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.response.status"/> <display value="status"/> <target> <code value="Bundle.entry.response.status"/> <display value="Bundle.entry.response.status"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.response.status` is mapped to FHIR R4 element `Bundle.entry.response.status` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.response.location"/> <display value="location"/> <target> <code value="Bundle.entry.response.location"/> <display value="Bundle.entry.response.location"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.response.location` is mapped to FHIR R4 element `Bundle.entry.response.location` as `Equivalent`."/> </target> </element> <element> <code value="Bundle.entry.response.etag"/> <display value="etag"/> <target> <code value="Bundle.entry.response.etag"/> <display value="Bundle.entry.response.etag"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.response.etag` is mapped to FHIR R4 element `Bundle.entry.response.etag` as `Equivalent`. Etags match the Resource.meta.versionId. The ETag has to match the version id in the header if a resource is included."/> </target> </element> <element> <code value="Bundle.entry.response.lastModified"/> <display value="lastModified"/> <target> <code value="Bundle.entry.response.lastModified"/> <display value="Bundle.entry.response.lastModified"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.response.lastModified` is mapped to FHIR R4 element `Bundle.entry.response.lastModified` as `Equivalent`. This has to match the same time in the meta header if a resource is included."/> </target> </element> <element> <code value="Bundle.entry.response.outcome"/> <display value="outcome"/> <target> <code value="Bundle.entry.response.outcome"/> <display value="Bundle.entry.response.outcome"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.entry.response.outcome` is mapped to FHIR R4 element `Bundle.entry.response.outcome` as `Equivalent`. For a POST/PUT operation, this is the equivalent outcome that would be returned for prefer = operationoutcome - except that the resource is always returned whether or not the outcome is returned."/> </target> </element> <element> <code value="Bundle.signature"/> <display value="signature"/> <target> <code value="Bundle.signature"/> <display value="Bundle.signature"/> <equivalence value="equivalent"/> <comment value="Element `Bundle.signature` is mapped to FHIR R4 element `Bundle.signature` as `Equivalent`. The signature could be created by the "author" of the bundle or by the originating device. Requirements around inclusion of a signature, verification of signatures and treatment of signed/non-signed bundles is implementation-environment specific."/> </target> </element> </group> </ConceptMap>

Generated Narrative: ConceptMap R3-Bundle-element-map-to-R4

Mapping from http://hl7.org/fhir/3.0 to http://hl7.org/fhir/4.0

Group 1 Mapping from http://hl7.org/fhir/StructureDefinition/Bundle|3.0.2 to Bundleversion: 4.0.1)

Source Code

Relationship

Target Code

Comment

Bundle.meta (meta)

is equivalent to

Bundle.meta

Element `Bundle.meta` is mapped to FHIR R4 element `Bundle.meta` as `Equivalent`.

Bundle.implicitRules (implicitRules)

is equivalent to

Bundle.implicitRules

Element `Bundle.implicitRules` is mapped to FHIR R4 element `Bundle.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. This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

Bundle.language (language)

is equivalent to

Bundle.language

Element `Bundle.language` is mapped to FHIR R4 element `Bundle.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).

Bundle.identifier (identifier)

is equivalent to

Bundle.identifier

Element `Bundle.identifier` is mapped to FHIR R4 element `Bundle.identifier` as `Equivalent`. Persistent identity generally only matters for batches of type Document, Message, and Collection. It would not normally be populated for search and history results, and servers ignore Bundle.identifier when processing batches and transactions. For Documents the .identifier SHALL be populated such that the .identifier is globally unique.

Bundle.type (type)

is equivalent to

Bundle.type

Element `Bundle.type` is mapped to FHIR R4 element `Bundle.type` as `Equivalent`. It's possible to use a bundle for other purposes (e.g. a document can be accepted as a transaction). This is primarily defined so that there can be specific rules for some of the bundle types.

Bundle.total (total)

is equivalent to

Bundle.total

Element `Bundle.total` is mapped to FHIR R4 element `Bundle.total` as `Equivalent`. Only used if the bundle is a search result set. The total does not include resources such as OperationOutcome and included resources, only the total number of matching resources.

Bundle.link (link)

maps to wider concept

Bundle.link

Element `Bundle.link` is mapped to FHIR R4 element `Bundle.link` as `Equivalent`.

Bundle.link.relation (relation)

is equivalent to

Bundle.link.relation

Element `Bundle.link.relation` is mapped to FHIR R4 element `Bundle.link.relation` as `Equivalent`.

Bundle.link.url (url)

is equivalent to

Bundle.link.url

Element `Bundle.link.url` is mapped to FHIR R4 element `Bundle.link.url` as `Equivalent`.

Bundle.entry (entry)

maps to wider concept

Bundle.entry

Element `Bundle.entry` is mapped to FHIR R4 element `Bundle.entry` as `Equivalent`.

Bundle.entry.link (link)

is equivalent to

Bundle.entry.link

Element `Bundle.entry.link` is mapped to FHIR R4 element `Bundle.entry.link` as `Equivalent`.

Bundle.entry.fullUrl (fullUrl)

is equivalent to

Bundle.entry.fullUrl

Element `Bundle.entry.fullUrl` is mapped to FHIR R4 element `Bundle.entry.fullUrl` as `Equivalent`. fullUrl may not be [unique in the context of a resource](https://hl7.org/fhir/bundle.html#bu.html#bundle-unique). Note that since [FHIR resources do not need to be served through the FHIR API](https://hl7.org/fhir/references.html), the absolute URL may not end with the logical id of the resource (Resource.id), but if the fullUrl does look like a RESTful server URL (e.g. meets the [regex](https://hl7.org/fhir/refere.html#regex), then it SHALL end with the Resource.id.

Bundle.entry.resource (resource)

is equivalent to

Bundle.entry.resource

Element `Bundle.entry.resource` is mapped to FHIR R4 element `Bundle.entry.resource` as `Equivalent`.

Bundle.entry.search (search)

maps to wider concept

Bundle.entry.search

Element `Bundle.entry.search` is mapped to FHIR R4 element `Bundle.entry.search` as `Equivalent`.

Bundle.entry.search.mode (mode)

is equivalent to

Bundle.entry.search.mode

Element `Bundle.entry.search.mode` is mapped to FHIR R4 element `Bundle.entry.search.mode` as `Equivalent`. There is only one mode. In some corner cases, a resource may be included because it is both a match and an include. In these circumstances, 'match' takes precedence.

Bundle.entry.search.score (score)

is equivalent to

Bundle.entry.search.score

Element `Bundle.entry.search.score` is mapped to FHIR R4 element `Bundle.entry.search.score` as `Equivalent`. Servers are not required to return a ranking score. 1 is most relevant, and 0 is least relevant. Often, search results are sorted by score, but the client may specify a different sort order.

Bundle.entry.request (request)

maps to wider concept

Bundle.entry.request

Element `Bundle.entry.request` is mapped to FHIR R4 element `Bundle.entry.request` as `Equivalent`.

Bundle.entry.request.method (method)

is equivalent to

Bundle.entry.request.method

Element `Bundle.entry.request.method` is mapped to FHIR R4 element `Bundle.entry.request.method` as `SourceIsNarrowerThanTarget`. The mappings for `Bundle.entry.request.method` do not allow expression of the necessary codes, per the bindings on the source and target.

Bundle.entry.request.url (url)

is equivalent to

Bundle.entry.request.url

Element `Bundle.entry.request.url` is mapped to FHIR R4 element `Bundle.entry.request.url` as `Equivalent`. E.g. for a Patient Create, the method would be "POST" and the URL would be "Patient". For a Patient Update, the method would be PUT, and the URL would be "Patient/[id]".

Bundle.entry.request.ifNoneMatch (ifNoneMatch)

is equivalent to

Bundle.entry.request.ifNoneMatch

Element `Bundle.entry.request.ifNoneMatch` is mapped to FHIR R4 element `Bundle.entry.request.ifNoneMatch` as `Equivalent`.

Bundle.entry.request.ifModifiedSince (ifModifiedSince)

is equivalent to

Bundle.entry.request.ifModifiedSince

Element `Bundle.entry.request.ifModifiedSince` is mapped to FHIR R4 element `Bundle.entry.request.ifModifiedSince` as `Equivalent`.

Bundle.entry.request.ifMatch (ifMatch)

is equivalent to

Bundle.entry.request.ifMatch

Element `Bundle.entry.request.ifMatch` is mapped to FHIR R4 element `Bundle.entry.request.ifMatch` as `Equivalent`.

Bundle.entry.request.ifNoneExist (ifNoneExist)

is equivalent to

Bundle.entry.request.ifNoneExist

Element `Bundle.entry.request.ifNoneExist` is mapped to FHIR R4 element `Bundle.entry.request.ifNoneExist` as `Equivalent`.

Bundle.entry.response (response)

maps to wider concept

Bundle.entry.response

Element `Bundle.entry.response` is mapped to FHIR R4 element `Bundle.entry.response` as `Equivalent`.

Bundle.entry.response.status (status)

is equivalent to

Bundle.entry.response.status

Element `Bundle.entry.response.status` is mapped to FHIR R4 element `Bundle.entry.response.status` as `Equivalent`.

Bundle.entry.response.location (location)

is equivalent to

Bundle.entry.response.location

Element `Bundle.entry.response.location` is mapped to FHIR R4 element `Bundle.entry.response.location` as `Equivalent`.

Bundle.entry.response.etag (etag)

is equivalent to

Bundle.entry.response.etag

Element `Bundle.entry.response.etag` is mapped to FHIR R4 element `Bundle.entry.response.etag` as `Equivalent`. Etags match the Resource.meta.versionId. The ETag has to match the version id in the header if a resource is included.

Bundle.entry.response.lastModified (lastModified)

is equivalent to

Bundle.entry.response.lastModified

Element `Bundle.entry.response.lastModified` is mapped to FHIR R4 element `Bundle.entry.response.lastModified` as `Equivalent`. This has to match the same time in the meta header if a resource is included.

Bundle.entry.response.outcome (outcome)

is equivalent to

Bundle.entry.response.outcome

Element `Bundle.entry.response.outcome` is mapped to FHIR R4 element `Bundle.entry.response.outcome` as `Equivalent`. For a POST/PUT operation, this is the equivalent outcome that would be returned for prefer = operationoutcome - except that the resource is always returned whether or not the outcome is returned.

Bundle.signature (signature)

is equivalent to

Bundle.signature

Element `Bundle.signature` is mapped to FHIR R4 element `Bundle.signature` as `Equivalent`. The signature could be created by the "author" of the bundle or by the originating device. Requirements around inclusion of a signature, verification of signatures and treatment of signed/non-signed bundles is implementation-environment specific.