{
"description": "Logical Model: A pattern to be followed by resources that represent a specific proposal, plan and/or order for some sort of action or service.",
"_filename": "StructureDefinition-Request.json",
"package_name": "hl7.fhir.core",
"date": "2017-12-20T15:52:34+11:00",
"publisher": "Health Level Seven International fhir",
"fhirVersion": "3.2.0",
"name": "Request",
"mapping": [ {
"uri": "http://hl7.org/v2",
"name": "HL7 v2 Mapping",
"identity": "v2"
}, {
"uri": "http://hl7.org/v3",
"name": "RIM Mapping",
"identity": "rim"
}, {
"uri": "http://hl7.org/fhir/w5",
"name": "W5 Mapping",
"identity": "w5"
} ],
"abstract": false,
"type": null,
"experimental": null,
"resourceType": "StructureDefinition",
"title": "request",
"package_version": "3.2.0",
"snapshot": {
"element": [ {
"id": "Request",
"max": "*",
"min": 0,
"path": "Request",
"short": "Request Pattern",
"mapping": [ {
"map": "ORC",
"identity": "v2"
}, {
"map": "Act[moodCode<=INT]",
"identity": "rim"
} ],
"definition": "A pattern to be followed by resources that represent a specific proposal, plan and/or order for some sort of action or service."
}, {
"path": "Request.identifier",
"requirements": "Allows identification of the {{title}} as it is known by various participating systems and in a way that remains consistent across servers.",
"min": 0,
"definition": "Identifiers assigned to this {{title}} by the requester, performer and other systems.",
"short": "Business Identifier for {{title}}",
"mapping": [ {
"map": "ORC.2, ORC.3",
"identity": "v2"
}, {
"map": ".identifier",
"identity": "rim"
}, {
"map": "id",
"identity": "w5"
} ],
"type": [ {
"code": "Identifier"
} ],
"max": "*",
"id": "Request.identifier",
"comment": "The identifier.type element is used to distinguish between the identifiers assigned by the requester/placer and the performer/filler.",
"isSummary": true
}, {
"path": "Request.instantiates",
"min": 0,
"definition": "The URL pointing to a protocol, guideline, orderset or other definition that is adhered to in whole or in part by this {{title}}.",
"short": "Instantiates protocol or definition",
"mapping": [ {
"map": "Varies by domain",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=DEFN].target",
"identity": "rim"
} ],
"type": [ {
"code": "uri"
} ],
"max": "*",
"id": "Request.instantiates",
"isSummary": true
}, {
"path": "Request.basedOn",
"requirements": "Allows tracing of authorization for the request and tracking whether proposals/recommendations were acted upon.",
"min": 0,
"definition": "A plan, proposal or order that is fulfilled in whole or in part by this {{title}}.",
"short": "Fulfills plan, proposal or order",
"mapping": [ {
"map": "ORC.8 (plus others)",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=FLFS].target",
"identity": "rim"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Request"
} ],
"alias": [ "fulfills" ],
"max": "*",
"id": "Request.basedOn",
"comment": "[The allowed reference resources may be adjusted as appropriate for the request resource].",
"isSummary": true
}, {
"path": "Request.replaces",
"requirements": "Allows tracing the continuation of a therapy or administrative process instantiated through multiple requests.",
"min": 0,
"definition": "Completed or terminated request(s) whose function is taken by this new {{title}}.",
"short": "Request(s) replaced by this {{title}}",
"mapping": [ {
"map": "Handled by message location of ORC (ORC.1=RO or RU)",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=RPLC].target",
"identity": "rim"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Request"
} ],
"alias": [ "supersedes", "prior", "renewed order" ],
"max": "*",
"id": "Request.replaces",
"comment": "The replacement could be because the initial request was immediately rejected (due to an issue) or because the previous request was completed, but the need for the action described by the request remains ongoing.",
"isSummary": true
}, {
"path": "Request.groupIdentifier",
"requirements": "Some business processes need to know if multiple items were ordered as part of the same \"prescription\" or \"requisition\" for billing or other purposes.",
"min": 0,
"definition": "A shared identifier common to all requests that were authorized more or less simultaneously by a single author, representing the identifier of the requisition, prescription or similar form.",
"short": "Composite request this is part of",
"mapping": [ {
"map": "ORC.4",
"identity": "v2"
}, {
"map": ".inboundRelationship(typeCode=COMP].source[moodCode=INT].identifier",
"identity": "rim"
} ],
"type": [ {
"code": "Identifier"
} ],
"alias": [ "grouperId", "requisition" ],
"max": "1",
"id": "Request.groupIdentifier",
"comment": "Requests are linked either by a \"basedOn\" relationship (i.e. one request is fulfilling another) or by having a common requisition. Requests that are part of the same requisition are generally treated independently from the perspective of changing their state or maintaining them after initial creation.",
"isSummary": true
}, {
"path": "Request.status",
"min": 1,
"definition": "The current state of the {{title}}.",
"isModifier": true,
"short": "draft | active | suspended | cancelled | completed | entered-in-error | unknown",
"mapping": [ {
"map": "ORC.5",
"identity": "v2"
}, {
"map": ".status",
"identity": "rim"
}, {
"map": "status",
"identity": "w5"
} ],
"type": [ {
"code": "code"
} ],
"binding": {
"strength": "required",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestStatus"
} ],
"description": "Codes identifying the stage lifecycle stage of a request",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/request-status"
}
},
"max": "1",
"id": "Request.status",
"comment": "The status is generally fully in the control of the requester - they determine whether the order is draft or active and, after it has been activated, completed, cancelled or suspended. States relating to the activities of the performer are reflected on either the corresponding [Event](event.html)(s) or using the [Task](task.html) resource.\n\nA nominal state-transition diagram can be found in the [[request.html#statemachine | Request pattern]] documentation\n\nUnknown does not represent \"other\" - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is.\n\nA status of 'active' when doNotPerform is true means that the request to not perform is currently in force.",
"isSummary": true
}, {
"path": "Request.statusReason",
"min": 0,
"definition": "Captures the reason for the current state of the {{title}}.",
"short": "Reason for current status",
"mapping": [ {
"map": ".inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde",
"identity": "rim"
} ],
"type": [ {
"code": "CodeableConcept"
} ],
"binding": {
"strength": "example",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestStatusReason"
} ],
"description": "Codes identifying the reason for the current state of a request"
},
"alias": [ "Suspended Reason", "Cancelled Reason" ],
"max": "1",
"id": "Request.statusReason",
"comment": "This is generally only used for \"exception\" statuses such as \"suspended\" or \"cancelled\". The reason why the {{title}} was created at all is captured in reasonCode, not here.\n\n[distinct reason codes for different statuses can be enforced using invariants if they are universal bindings]."
}, {
"path": "Request.intent",
"requirements": "Proposals/recommendations, plans and orders all use the same structure and can exist in the same fulfillment chain.",
"min": 1,
"definition": "Indicates the level of authority/intentionality associated with the {{title}} and where the request fits into the workflow chain.",
"isModifier": true,
"short": "proposal | plan | order",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": ".moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)",
"identity": "rim"
}, {
"map": "class",
"identity": "w5"
} ],
"type": [ {
"code": "code"
} ],
"binding": {
"strength": "required",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestIntent"
} ],
"description": "Codes indicating the degree of authority/intentionality associated with a request",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/request-intent"
}
},
"alias": [ "category" ],
"max": "1",
"id": "Request.intent",
"comment": "When resources map to this element, they are free to define as many codes as necessary to cover their space and will map to \"proposal, plan or order\". Can have multiple codes that map to one of these. E.g. \"original order\", \"encoded order\", \"reflex order\" would all map to \"order\". Expectation is that the set of codes is mutually exclusive or a strict all-encompassing hierarchy.",
"isSummary": true
}, {
"path": "Request.priority",
"min": 0,
"definition": "Indicates how quickly the {{title}} should be addressed with respect to other requests.",
"short": "routine | urgent | asap | stat",
"mapping": [ {
"map": "TQ1.9",
"identity": "v2"
}, {
"map": ".priorityCode",
"identity": "rim"
}, {
"map": "grade",
"identity": "w5"
} ],
"type": [ {
"code": "code"
} ],
"meaningWhenMissing": "If missing, this task should be performed with normal priority",
"binding": {
"strength": "required",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestPriority"
} ],
"description": "Identifies the level of importance to be assigned to actioning the request",
"valueSetReference": {
"reference": "http://hl7.org/fhir/ValueSet/request-priority"
}
},
"max": "1",
"id": "Request.priority",
"isSummary": true
}, {
"path": "Request.doNotPerform",
"requirements": "Supports things like Do Not Recussitate, Nothing by mouth, etc.",
"min": 0,
"definition": "If true indicates that the {{title}} is asking for the specified action to *not* occur.",
"isModifier": true,
"short": "true if request is prohibiting action",
"type": [ {
"code": "boolean"
} ],
"defaultValueBoolean": false,
"alias": [ "prohibited" ],
"max": "1",
"id": "Request.doNotPerform",
"comment": "The attributes provided with the request qualify what is not to be done. For example, if an effectiveTime is provided, the \"do not\" request only applies within the specified time. If a performerType is specified then the \"do not\" request only applies to performers of that type. Qualifiers include: code, subject, occurrence, perormerType and performer.",
"isSummary": true
}, {
"path": "Request.code",
"min": 0,
"definition": "A code that identifies the specific service or action being asked to be done (or not done).",
"short": "What's being requested/ordered",
"mapping": [ {
"map": "Varies by domain",
"identity": "v2"
}, {
"map": ".code",
"identity": "rim"
}, {
"map": "what",
"identity": "w5"
} ],
"type": [ {
"code": "CodeableConcept"
} ],
"binding": {
"strength": "example",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestCode"
} ],
"description": "Codes indicating the details of what is being requested. These will vary significantly based on the type of request resource and will often be example/preferred rather than extensible/required."
},
"alias": [ "type" ],
"max": "1",
"id": "Request.code",
"isSummary": true
}, {
"path": "Request.subject",
"requirements": "Links the request to the Patient context.",
"min": 1,
"definition": "The individual or set of individuals the action is to be performed on or for.",
"short": "Individual the service is ordered for",
"mapping": [ {
"map": "Accompanying PID segment",
"identity": "v2"
}, {
"map": ".participation[typeCode=SBJ].role",
"identity": "rim"
}, {
"map": "who.focus",
"identity": "w5"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Patient"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Group"
} ],
"alias": [ "patient" ],
"max": "1",
"id": "Request.subject",
"comment": "[For resources that aren't patient-specific, the set of allowed resources may be extended to include other things. Group should generally be retained unless there's certainty this resource won't be used for veterinary, research or public health settings where Group may be necessary (e.g. this cage of rats/crate of chickens, group of people in a 5 mile radious of the incident, etc.)].",
"isSummary": true
}, {
"path": "Request.context",
"requirements": "Links the request to the Encounter context.",
"min": 0,
"definition": "The encounter or episode of care that establishes the context for making this request.",
"short": "Encounter / Episode associated with request",
"mapping": [ {
"map": "Accompanying PV1",
"identity": "v2"
}, {
"map": ".inboundRelationship(typeCode=COMP].source[classCode<=PCPR, moodCode=EVN]",
"identity": "rim"
}, {
"map": "context",
"identity": "w5"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Encounter"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"
} ],
"alias": [ "encounter" ],
"max": "1",
"id": "Request.context",
"comment": "This will typically be the encounter the request was created during, but some requests may be initiated prior to or after the official completion of an encounter or episode but still be tied to the context of the encounter or episode (e.g. pre-admission lab tests).",
"isSummary": true
}, {
"path": "Request.occurrence[x]",
"min": 0,
"definition": "The date or time(s) at which the activity or service is desired to occur.",
"short": "When service should occur",
"mapping": [ {
"map": "Accompanying TQ1/TQ2 segments",
"identity": "v2"
}, {
"map": ".effectiveTime",
"identity": "rim"
}, {
"map": "when.planned",
"identity": "w5"
} ],
"type": [ {
"code": "dateTime"
}, {
"code": "Period"
}, {
"code": "Timing"
} ],
"alias": [ "timing" ],
"max": "1",
"id": "Request.occurrence[x]",
"comment": "[The list of types may be constrained as appropriate for the type of event].",
"isSummary": true
}, {
"path": "Request.authoredOn",
"min": 0,
"definition": "For draft {{title}}s, indicates the date of initial creation. For requests with other statuses, indicates the date of activation.",
"short": "When request transitioned to being actionable",
"mapping": [ {
"map": "ORC.9",
"identity": "v2"
}, {
"map": ".participation[typeCode=AUT].time",
"identity": "rim"
}, {
"map": "when.recorded",
"identity": "w5"
} ],
"type": [ {
"code": "dateTime"
} ],
"alias": [ "createdOn", "signedOn" ],
"max": "1",
"id": "Request.authoredOn",
"isSummary": true
}, {
"constraint": [ {
"key": "inv-1",
"human": "onBehalfOf can only be specified if agent is practitioner or device",
"xpath": "contains(f:agent/f:reference/@value, '/Practitioner/') or contains(f:agent/f:reference/@value, '/Device/') or not(exists(f:onBehalfOf))",
"severity": "error",
"expression": "(agent.resolve().empty()) or (agent.resolve() is Device) or (agent.resolve() is Practitioner) or onBehalfOf.exists().not()"
} ],
"path": "Request.requester",
"min": 0,
"definition": "Who initiated the {{request}} and has responsibility for its activation.",
"short": "Who/what is requesting service",
"mapping": [ {
"map": "ORC.12",
"identity": "v2"
}, {
"map": ".participation[typeCode=AUT].role",
"identity": "rim"
}, {
"map": "who.author",
"identity": "w5"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Practitioner"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/PractitionerRole"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Organization"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Patient"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/RelatedPerson"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Device"
} ],
"alias": [ "author" ],
"max": "1",
"id": "Request.requester",
"comment": "[Resources may choose to constrain potential requesters, though should consider proposals and plans as well as orders].",
"isSummary": true
}, {
"path": "Request.performerType",
"min": 0,
"definition": "The type of individual that is desired to act upon the {{request}}.",
"short": "Desired kind of service performer",
"mapping": [ {
"map": "PRT",
"identity": "v2"
}, {
"map": ".participation[typeCode=PRF].role[scoper.determinerCode=KIND].code",
"identity": "rim"
}, {
"map": "who.actor",
"identity": "w5"
} ],
"type": [ {
"code": "CodeableConcept"
} ],
"binding": {
"strength": "example",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "PerformerType"
} ],
"description": "Identifies types of practitioners, devices or others that should fulfill a request. While the detailed constraints of relevant providers will vary by resource, some degree of consistency around recommended codes across request and definition resources would be desirable"
},
"max": "1",
"id": "Request.performerType",
"comment": "If specified without indicating a performer, this indicates that the performer must be of the specified type. If specified with a performer then it indicates the requirements of the performer if the designated performer is not available.",
"isSummary": true
}, {
"path": "Request.performer",
"min": 0,
"definition": "Indicates who or what is being asked to perform (or not perform) the {{request}}.",
"short": "Specific desired performer",
"mapping": [ {
"map": "PRT",
"identity": "v2"
}, {
"map": ".participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]",
"identity": "rim"
}, {
"map": "who.actor",
"identity": "w5"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Practitioner"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/PractitionerRole"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Organization"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/CareTeam"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/HealthcareService"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Patient"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Device"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/RelatedPerson"
} ],
"max": "1",
"id": "Request.performer",
"isSummary": true
}, {
"path": "Request.reasonCode",
"min": 0,
"definition": "Describes why the request is being made in coded or textual form.",
"short": "Why is service needed?",
"mapping": [ {
"map": "ORC.16",
"identity": "v2"
}, {
"map": ".reasonCode",
"identity": "rim"
}, {
"map": "why",
"identity": "w5"
} ],
"type": [ {
"code": "CodeableConcept"
} ],
"binding": {
"strength": "example",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
"valueString": "RequestReason"
} ],
"description": "Codes identifying why this request was necessary. These may be clinical reasons (e.g. diagnoses, symptoms) and/or administrative reasons. While the detailed constraints of relevant reasons will vary by resource, some degree of consistency across resources around recommended codes would be desirable."
},
"max": "*",
"id": "Request.reasonCode",
"comment": "Textual reasons can be caprued using reasonCode.text. If doNoPerform is true, this will be the reason why the request is being made to not act.",
"isSummary": true
}, {
"path": "Request.reasonReference",
"min": 0,
"definition": "Indicates another resource whose existence justifies this request.",
"short": "Why is service needed?",
"mapping": [ {
"map": "ORC.16",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=RSON].target",
"identity": "rim"
}, {
"map": "why",
"identity": "w5"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Condition"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Observation"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/DiagnosticReport"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/DocumentReference"
} ],
"max": "*",
"id": "Request.reasonReference",
"comment": "[Additional resources may be added as appropriate].",
"isSummary": true
}, {
"id": "Request.insurance",
"max": "*",
"min": 0,
"path": "Request.insurance",
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Coverage"
}, {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/ClaimResponse"
} ],
"short": "Associated insurance coverage",
"mapping": [ {
"map": "IN1/IN2",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=COVBY].target",
"identity": "rim"
} ],
"definition": "Insurance plans, coverage extensions, pre-authorizations and/or pre-determinations that may be rin delivering the requested service."
}, {
"id": "Request.supportingInfo",
"max": "*",
"min": 0,
"path": "Request.supportingInfo",
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Resource"
} ],
"short": "Extra information to use in performing request",
"mapping": [ {
"map": "Accompanying segments",
"identity": "v2"
}, {
"map": ".outboundRelationship[typeCode=PERT].target",
"identity": "rim"
} ],
"definition": "Information that may be needed by/relevant to the performer in their execution of this {{title}}."
}, {
"id": "Request.note",
"max": "*",
"min": 0,
"path": "Request.note",
"type": [ {
"code": "Annotation"
} ],
"short": "Comments made about {{title}}",
"mapping": [ {
"map": "NTE",
"identity": "v2"
}, {
"map": ".inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN, moodCode=EVN].value[xsi:type=ST]",
"identity": "rim"
} ],
"definition": "Comments made about the {{title}} by the requester, performer, subject or other participants."
}, {
"path": "Request.relevantHistory",
"min": 0,
"definition": "Links to Provenance records for past versions of this resource or fulfilling request or event resources that identify key state transitions or updates that are likely to be relevant to a user looking at the current version of the resource.",
"short": "Key events in history of {{title}}",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": ".inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]",
"identity": "rim"
} ],
"type": [ {
"code": "Reference",
"targetProfile": "http://hl7.org/fhir/StructureDefinition/Provenance"
} ],
"alias": [ "eventHistory" ],
"max": "*",
"id": "Request.relevantHistory",
"comment": "This element does not point to the Provenance associated with the *current* version of the resource - as it would be created after this version existed. The Provenance for the current version can be retrieved with a _revinclude.\n\nReferenced provenances should adhere to the provenance-relevant-history profile."
} ]
},
"status": "draft",
"id": "bd3a6f28-7647-4e8d-be91-8b2f1a6abe94",
"kind": "logical",
"url": "http://hl7.org/fhir/StructureDefinition/Request",
"version": null,
"contact": [ {
"telecom": [ {
"value": "http://hl7.org/fhir",
"system": "url"
} ]
} ]
}