FHIR IG analytics

Resources that use this resource

No resources found

Resources that this resource uses

Narrative

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

Source1

{
  "resourceType": "ConceptMap",
  "id": "R4B-Appointment-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-Appointment-element-map-to-R5",
  "version": "0.1.0",
  "name": "R4BAppointmentElementMapToR5",
  "title": "Cross-version mapping for FHIR R4B Appointment to FHIR R5 Appointment",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:03:50.0593296-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 Appointment 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/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/StructureDefinition/Appointment|5.0.0",
      "element": [
        {
          "code": "Appointment.meta",
          "display": "meta",
          "target": [
            {
              "code": "Appointment.meta",
              "display": "Appointment.meta",
              "relationship": "equivalent",
              "comment": "Element `Appointment.meta` is mapped to FHIR R5 element `Appointment.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "Appointment.implicitRules",
              "display": "Appointment.implicitRules",
              "relationship": "equivalent",
              "comment": "Element `Appointment.implicitRules` is mapped to FHIR R5 element `Appointment.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": "Appointment.language",
          "display": "language",
          "target": [
            {
              "code": "Appointment.language",
              "display": "Appointment.language",
              "relationship": "equivalent",
              "comment": "Element `Appointment.language` is mapped to FHIR R5 element `Appointment.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": "Appointment.text",
          "display": "text",
          "target": [
            {
              "code": "Appointment.text",
              "display": "Appointment.text",
              "relationship": "equivalent",
              "comment": "Element `Appointment.text` is mapped to FHIR R5 element `Appointment.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": "Appointment.contained",
          "display": "contained",
          "target": [
            {
              "code": "Appointment.contained",
              "display": "Appointment.contained",
              "relationship": "equivalent",
              "comment": "Element `Appointment.contained` is mapped to FHIR R5 element `Appointment.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": "Appointment.identifier",
          "display": "identifier",
          "target": [
            {
              "code": "Appointment.identifier",
              "display": "Appointment.identifier",
              "relationship": "equivalent",
              "comment": "Element `Appointment.identifier` is mapped to FHIR R5 element `Appointment.identifier` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.status",
          "display": "status",
          "target": [
            {
              "code": "Appointment.status",
              "display": "Appointment.status",
              "relationship": "equivalent",
              "comment": "Element `Appointment.status` is mapped to FHIR R5 element `Appointment.status` as `Equivalent`.\nIf the Appointment's status is \"cancelled\" then all participants are expected to have their calendars released for the appointment period, and as such any Slots that were marked as BUSY can be re-set to FREE.\n\nThis element is labeled as a modifier because the status contains the code entered-in-error that mark the Appointment as not currently valid."
            }
          ]
        },
        {
          "code": "Appointment.cancelationReason",
          "display": "cancelationReason",
          "target": [
            {
              "code": "Appointment.cancellationReason",
              "display": "Appointment.cancellationReason",
              "relationship": "equivalent",
              "comment": "Element `Appointment.cancelationReason` is mapped to FHIR R5 element `Appointment.cancellationReason` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.serviceCategory",
          "display": "serviceCategory",
          "target": [
            {
              "code": "Appointment.serviceCategory",
              "display": "Appointment.serviceCategory",
              "relationship": "equivalent",
              "comment": "Element `Appointment.serviceCategory` is mapped to FHIR R5 element `Appointment.serviceCategory` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.serviceType",
          "display": "serviceType",
          "target": [
            {
              "code": "Appointment.serviceType",
              "display": "Appointment.serviceType",
              "relationship": "equivalent",
              "comment": "Element `Appointment.serviceType` is mapped to FHIR R5 element `Appointment.serviceType` as `SourceIsNarrowerThanTarget`.\nFor a provider to provider appointment the code \"FOLLOWUP\" may be appropriate, as this is expected to be discussing some patient that was seen in the past."
            }
          ]
        },
        {
          "code": "Appointment.specialty",
          "display": "specialty",
          "target": [
            {
              "code": "Appointment.specialty",
              "display": "Appointment.specialty",
              "relationship": "equivalent",
              "comment": "Element `Appointment.specialty` is mapped to FHIR R5 element `Appointment.specialty` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.appointmentType",
          "display": "appointmentType",
          "target": [
            {
              "code": "Appointment.appointmentType",
              "display": "Appointment.appointmentType",
              "relationship": "equivalent",
              "comment": "Element `Appointment.appointmentType` is mapped to FHIR R5 element `Appointment.appointmentType` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.reasonCode",
          "display": "reasonCode",
          "target": [
            {
              "code": "Appointment.reason",
              "display": "Appointment.reason",
              "relationship": "source-is-narrower-than-target",
              "comment": "Element `Appointment.reasonCode` is mapped to FHIR R5 element `Appointment.reason` as `SourceIsNarrowerThanTarget`."
            }
          ]
        },
        {
          "code": "Appointment.priority",
          "display": "priority",
          "target": [
            {
              "code": "Appointment.priority",
              "display": "Appointment.priority",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.priority` is mapped to FHIR R5 element `Appointment.priority` as `SourceIsBroaderThanTarget`.\nThe mappings for `Appointment.priority` do not cover the following types: unsignedInt.\nThe mappings for `Appointment.priority` do not cover the following types based on type expansion: value.\nSeeking implementer feedback on this property and how interoperable it is.\r\rUsing an extension to record a CodeableConcept for named values may be tested at a future connectathon."
            }
          ]
        },
        {
          "code": "Appointment.description",
          "display": "description",
          "target": [
            {
              "code": "Appointment.description",
              "display": "Appointment.description",
              "relationship": "equivalent",
              "comment": "Element `Appointment.description` is mapped to FHIR R5 element `Appointment.description` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.supportingInformation",
          "display": "supportingInformation",
          "target": [
            {
              "code": "Appointment.supportingInformation",
              "display": "Appointment.supportingInformation",
              "relationship": "equivalent",
              "comment": "Element `Appointment.supportingInformation` is mapped to FHIR R5 element `Appointment.supportingInformation` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.start",
          "display": "start",
          "target": [
            {
              "code": "Appointment.start",
              "display": "Appointment.start",
              "relationship": "equivalent",
              "comment": "Element `Appointment.start` is mapped to FHIR R5 element `Appointment.start` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.end",
          "display": "end",
          "target": [
            {
              "code": "Appointment.end",
              "display": "Appointment.end",
              "relationship": "equivalent",
              "comment": "Element `Appointment.end` is mapped to FHIR R5 element `Appointment.end` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.minutesDuration",
          "display": "minutesDuration",
          "target": [
            {
              "code": "Appointment.minutesDuration",
              "display": "Appointment.minutesDuration",
              "relationship": "equivalent",
              "comment": "Element `Appointment.minutesDuration` is mapped to FHIR R5 element `Appointment.minutesDuration` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.slot",
          "display": "slot",
          "target": [
            {
              "code": "Appointment.slot",
              "display": "Appointment.slot",
              "relationship": "equivalent",
              "comment": "Element `Appointment.slot` is mapped to FHIR R5 element `Appointment.slot` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.created",
          "display": "created",
          "target": [
            {
              "code": "Appointment.created",
              "display": "Appointment.created",
              "relationship": "equivalent",
              "comment": "Element `Appointment.created` is mapped to FHIR R5 element `Appointment.created` as `Equivalent`.\nThis property is required for many use cases where the age of an appointment is considered in processing workflows for scheduling and billing of appointments."
            }
          ]
        },
        {
          "code": "Appointment.comment",
          "display": "comment",
          "target": [
            {
              "code": "Appointment.note",
              "display": "Appointment.note",
              "relationship": "related-to",
              "comment": "Element `Appointment.comment` is mapped to FHIR R5 element `Appointment.note` as `RelatedTo`.\nThe mappings for `Appointment.comment` do not cover the following types: string.\nThe mappings for `Appointment.comment` do not cover the following types based on type expansion: value.\nAdditional text to aid in facilitating the appointment. For instance, a comment might be, \"patient should proceed immediately to infusion room upon arrival\"\r\rWhere this is a planned appointment and the start/end dates are not set then this field can be used to provide additional guidance on the details of the appointment request, including any restrictions on when to book it."
            }
          ]
        },
        {
          "code": "Appointment.patientInstruction",
          "display": "patientInstruction",
          "target": [
            {
              "code": "Appointment.patientInstruction",
              "display": "Appointment.patientInstruction",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.patientInstruction` is mapped to FHIR R5 element `Appointment.patientInstruction` as `RelatedTo`.\nThe mappings for `Appointment.patientInstruction` do not cover the following types: string.\nThe mappings for `Appointment.patientInstruction` do not cover the following types based on type expansion: value."
            }
          ]
        },
        {
          "code": "Appointment.basedOn",
          "display": "basedOn",
          "target": [
            {
              "code": "Appointment.basedOn",
              "display": "Appointment.basedOn",
              "relationship": "equivalent",
              "comment": "Element `Appointment.basedOn` is mapped to FHIR R5 element `Appointment.basedOn` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.participant",
          "display": "participant",
          "target": [
            {
              "code": "Appointment.participant",
              "display": "Appointment.participant",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.participant` is mapped to FHIR R5 element `Appointment.participant` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.participant.type",
          "display": "type",
          "target": [
            {
              "code": "Appointment.participant.type",
              "display": "Appointment.participant.type",
              "relationship": "equivalent",
              "comment": "Element `Appointment.participant.type` is mapped to FHIR R5 element `Appointment.participant.type` as `Equivalent`.\nThe role of the participant can be used to declare what the actor will be doing in the scope of this appointment.\r\rIf the actor is not specified, then it is expected that the actor will be filled in at a later stage of planning.\r\rThis value SHALL be the same when creating an AppointmentResponse so that they can be matched, and subsequently update the Appointment."
            }
          ]
        },
        {
          "code": "Appointment.participant.actor",
          "display": "actor",
          "target": [
            {
              "code": "Appointment.participant.actor",
              "display": "Appointment.participant.actor",
              "relationship": "equivalent",
              "comment": "Element `Appointment.participant.actor` is mapped to FHIR R5 element `Appointment.participant.actor` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.participant.required",
          "display": "required",
          "target": [
            {
              "code": "Appointment.participant.required",
              "display": "Appointment.participant.required",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.participant.required` is mapped to FHIR R5 element `Appointment.participant.required` as `SourceIsBroaderThanTarget`.\nThe mappings for `Appointment.participant.required` do not cover the following types: code.\nThe mappings for `Appointment.participant.required` do not cover the following types based on type expansion: value."
            }
          ]
        },
        {
          "code": "Appointment.participant.status",
          "display": "status",
          "target": [
            {
              "code": "Appointment.participant.status",
              "display": "Appointment.participant.status",
              "relationship": "equivalent",
              "comment": "Element `Appointment.participant.status` is mapped to FHIR R5 element `Appointment.participant.status` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.participant.period",
          "display": "period",
          "target": [
            {
              "code": "Appointment.participant.period",
              "display": "Appointment.participant.period",
              "relationship": "equivalent",
              "comment": "Element `Appointment.participant.period` is mapped to FHIR R5 element `Appointment.participant.period` as `Equivalent`."
            }
          ]
        },
        {
          "code": "Appointment.requestedPeriod",
          "display": "requestedPeriod",
          "target": [
            {
              "code": "Appointment.requestedPeriod",
              "display": "Appointment.requestedPeriod",
              "relationship": "equivalent",
              "comment": "Element `Appointment.requestedPeriod` is mapped to FHIR R5 element `Appointment.requestedPeriod` as `Equivalent`.\nThis does not introduce a capacity for recurring appointments."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Appointment.reasonReference|0.1.0",
      "element": [
        {
          "code": "Appointment.reasonReference",
          "display": "reasonReference",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.reasonReference` has a context of Appointment based on following the parent source element upwards and mapping to `Appointment`.\nElement `Appointment.reasonReference` 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/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Appointment.priority|0.1.0",
      "element": [
        {
          "code": "Appointment.priority",
          "display": "priority",
          "target": [
            {
              "code": "Extension",
              "relationship": "equivalent",
              "comment": "Element `Appointment.priority` is mapped to FHIR R5 element `Appointment.priority` as `SourceIsBroaderThanTarget`.\nThe mappings for `Appointment.priority` do not cover the following types: unsignedInt.\nThe mappings for `Appointment.priority` do not cover the following types based on type expansion: value.\nSeeking implementer feedback on this property and how interoperable it is.\r\rUsing an extension to record a CodeableConcept for named values may be tested at a future connectathon."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Appointment.comment|0.1.0",
      "element": [
        {
          "code": "Appointment.comment",
          "display": "comment",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `Appointment.comment` is mapped to FHIR R5 element `Appointment.note` as `RelatedTo`.\nThe mappings for `Appointment.comment` do not cover the following types: string.\nThe mappings for `Appointment.comment` do not cover the following types based on type expansion: value.\nAdditional text to aid in facilitating the appointment. For instance, a comment might be, \"patient should proceed immediately to infusion room upon arrival\"\r\rWhere this is a planned appointment and the start/end dates are not set then this field can be used to provide additional guidance on the details of the appointment request, including any restrictions on when to book it."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Appointment.patientInstruction|0.1.0",
      "element": [
        {
          "code": "Appointment.patientInstruction",
          "display": "patientInstruction",
          "target": [
            {
              "code": "Extension",
              "relationship": "equivalent",
              "comment": "Element `Appointment.patientInstruction` is mapped to FHIR R5 element `Appointment.patientInstruction` as `RelatedTo`.\nThe mappings for `Appointment.patientInstruction` do not cover the following types: string.\nThe mappings for `Appointment.patientInstruction` do not cover the following types based on type expansion: value."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/Appointment|4.3.0",
      "target": "http://hl7.org/fhir/4.3/StructureDefinition/extension-Appointment.participant.required|0.1.0",
      "element": [
        {
          "code": "Appointment.participant.required",
          "display": "required",
          "target": [
            {
              "code": "Extension",
              "relationship": "equivalent",
              "comment": "Element `Appointment.participant.required` is mapped to FHIR R5 element `Appointment.participant.required` as `SourceIsBroaderThanTarget`.\nThe mappings for `Appointment.participant.required` do not cover the following types: code.\nThe mappings for `Appointment.participant.required` do not cover the following types based on type expansion: value."
            }
          ]
        }
      ]
    }
  ]
}