FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

Orders and Observations icon Work GroupMaturity Level: 4 Trial UseSecurity Category: Patient Compartments: Device, Encounter, Patient, Practitioner, RelatedPerson

Detailed Descriptions for the elements in the ServiceRequest resource.

ServiceRequest
Element Id ServiceRequest
Definition

A record of a request for service such as diagnostic investigations, treatments, or operations to be performed.

Short Display A request for a service to be performed
Cardinality 0..*
Type DomainResource
Alternate Names diagnostic request; referral; referral request; transfer of care request
Summary false
Invariants
Defined on this element
bdystr-1Rule bodyStructure SHALL only be present if bodySite is not presentbodySite.exists() implies bodyStructure.empty()
prr-1Rule orderDetail SHALL only be present if code is presentorderDetail.empty() or code.exists()
ServiceRequest.identifier
Element Id ServiceRequest.identifier
Definition

Identifiers assigned to this order instance by the orderer and/or the receiver and/or order fulfiller.

Short Display Identifiers assigned to this order
Note This is a business identifier, not a resource identifier (see discussion)
Cardinality 0..*
Type Identifier
Summary true
Comments

The identifier.type element is used to distinguish between the identifiers assigned by the orderer (known as the 'Placer' in HL7 V2) and the producer of the observations in response to the order (known as the 'Filler' in HL7 V2). For further discussion and examples see the resource notes section below.

ServiceRequest.instantiatesCanonical
Element Id ServiceRequest.instantiatesCanonical
Definition

The URL pointing to a FHIR-defined protocol, guideline, orderset or other definition that is adhered to in whole or in part by this ServiceRequest.

Short Display Instantiates FHIR protocol or definition
Cardinality 0..*
Type canonical(ActivityDefinition | PlanDefinition)
Summary true
Comments

The PlanDefinition resource is used to describe series, sequences, or groups of actions to be taken, while the ActivityDefinition resource is used to define each specific step or activity to be performed. More information can be found in the Boundaries and Relationships section for PlanDefinition.

ServiceRequest.instantiatesUri
Element Id ServiceRequest.instantiatesUri
Definition

The URL pointing to an externally maintained protocol, guideline, orderset or other definition that is adhered to in whole or in part by this ServiceRequest.

Short Display Instantiates external protocol or definition
Cardinality 0..*
Type uri
Summary true
Comments

This might be an HTML page, PDF, etc. or could just be a non-resolvable URI identifier.

ServiceRequest.basedOn
Element Id ServiceRequest.basedOn
Definition

Plan/proposal/order fulfilled by this request.

Short Display What request fulfills
Cardinality 0..*
Type Reference(CarePlan | ServiceRequest | MedicationRequest | RequestOrchestration | NutritionOrder)
Alternate Names fulfills
Summary true
ServiceRequest.replaces
Element Id ServiceRequest.replaces
Definition

The request takes the place of the referenced completed or terminated request(s).

Short Display What request replaces
Cardinality 0..*
Type Reference(ServiceRequest)
Alternate Names supersedes; prior; renewed order
Summary true
ServiceRequest.requisition
Element Id ServiceRequest.requisition
Definition

A shared identifier common to all service requests that were authorized more or less simultaneously by a single author, representing the composite or group identifier.

Short Display Composite Request ID
Cardinality 0..1
Type Identifier
Requirements

Some business processes need to know if multiple items were ordered as part of the same "requisition" for billing or other purposes.

Alternate Names grouperId; groupIdentifier
Summary true
Comments

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.

ServiceRequest.status
Element Id ServiceRequest.status
Definition

The status of the order.

Short Display draft | active | on-hold | revoked | completed | entered-in-error | unknown
Cardinality 1..1
Terminology Binding RequestStatus (Required)
Type code
Is Modifier true (Reason: This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid)
Summary true
Comments

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, competed, revoked or placed on-hold. States relating to the activities of the performer are reflected on either the corresponding event (see Event Pattern for general discussion) or using the Task resource.

ServiceRequest.intent
Element Id ServiceRequest.intent
Definition

Whether the request is a proposal, plan, an original order or a reflex order.

Short Display proposal | plan | directive | order +
Cardinality 1..1
Terminology Binding RequestIntent (Required)
Type code
Is Modifier true (Reason: This element changes the interpretation of all descriptive attributes. For example "the time the request is recommended to occur" vs. "the time the request is authorized to occur" or "who is recommended to perform the request" vs. "who is authorized to perform the request)
Summary true
Comments

This element is labeled as a modifier because the intent alters when and how the resource is actually applicable. This element is immutable. It cannot be changed for the same resource instance. For child ServiceRequests, the default statuses could be the same as the parent ServiceRequest but does not need to be.

ServiceRequest.category
Element Id ServiceRequest.category
Definition

A code that classifies the service for searching, sorting and display purposes (e.g. "Surgical Procedure").

Short Display Classification of service
Cardinality 0..*
Terminology Binding Service Request Category Codes (Example)
Type CodeableConcept
Requirements

Used for filtering what service request are retrieved and displayed.

Summary true
Comments

There may be multiple axis of categorization depending on the context or use case for retrieving or displaying the resource. The level of granularity is defined by the category concepts in the value set.

ServiceRequest.priority
Element Id ServiceRequest.priority
Definition

Indicates how quickly the ServiceRequest should be addressed with respect to other requests.

Short Display routine | urgent | asap | stat
Cardinality 0..1
Terminology Binding RequestPriority (Required)
Type code
Meaning if Missing If missing, this task should be performed with normal priority
Summary true
ServiceRequest.doNotPerform
Element Id ServiceRequest.doNotPerform
Definition

Set this to true if the record is saying that the service/procedure should NOT be performed.

Short Display True if service/procedure should not be performed
Cardinality 0..1
Type boolean
Is Modifier true (Reason: If true this element negates the specified action. For Example, instead of a request for a procedure, it is a request for the procedure to not occur.)
Meaning if Missing If missing, the request is a positive request e.g. "do perform"
Requirements

Used for do not ambulate, do not elevate head of bed, do not flush NG tube, do not take blood pressure on a certain arm, etc.

Summary true
Comments

In general, only the code and timeframe will be present, though occasional additional qualifiers such as body site or even performer could be included to narrow the scope of the prohibition. If the ServiceRequest.code and ServiceRequest.doNotPerform both contain negation, that will reinforce prohibition and should not have a double negative interpretation.

ServiceRequest.code
Element Id ServiceRequest.code
Definition

A code or reference that identifies a particular service (i.e., procedure, diagnostic investigation, or panel of investigations) that has been requested.

Short Display What is being requested/ordered
Cardinality 0..1
Terminology Binding Procedure Codes (SNOMED CT) (Example)
Type CodeableReference(ActivityDefinition | PlanDefinition)
Alternate Names service requested
Summary true
Comments

Many laboratory and radiology procedure codes embed the specimen/organ system in the test order name, for example, serum or serum/plasma glucose, or a chest x-ray. The specimen might not be recorded separately from the test code. The PlanDefinition may be used when you want to group multiple activities together (e.g., order set that are part of a plan).

Invariants
Affect this element
prr-1Rule orderDetail SHALL only be present if code is presentorderDetail.empty() or code.exists()
ServiceRequest.orderDetail
Element Id ServiceRequest.orderDetail
Definition

Additional details and instructions about how the services are to be delivered. For example, an order for a urinary catheter may have an order detail for an external or indwelling catheter, or an order for a bandage may require additional instructions specifying how the bandage should be applied. Questions or additional information to be gathered from a patient may be included here.

Short Display Additional information about the request
Cardinality 0..*
Alternate Names detailed instructions
Summary true
Comments

For existing information to support the delivery of the requested services, use the supportingInformnation.element - e.g. to share information with the lab about a patient's age, gender, or current medications.

Invariants
Affect this element
prr-1Rule orderDetail SHALL only be present if code is presentorderDetail.empty() or code.exists()
ServiceRequest.orderDetail.parameterFocus
Element Id ServiceRequest.orderDetail.parameterFocus
Definition

Indicates the context of the order details by reference.

Short Display The context of the order details by reference
Cardinality 0..1
Type CodeableReference(Device | DeviceDefinition | DeviceRequest | SupplyRequest | Medication | MedicationRequest | BiologicallyDerivedProduct | Substance)
Summary false
ServiceRequest.orderDetail.parameter
Element Id ServiceRequest.orderDetail.parameter
Definition

The parameter details for the service being requested.

Short Display The parameter details for the service being requested
Cardinality 1..*
Summary true
ServiceRequest.orderDetail.parameter.code
Element Id ServiceRequest.orderDetail.parameter.code
Definition

A value representing the additional detail or instructions for the order (e.g., catheter insertion, body elevation, descriptive device configuration and/or setting instructions).

Short Display The detail of the order being requested
Cardinality 1..1
Terminology Binding Servicerequest OrderDetail Parameter Code (Example)
Type CodeableConcept
Summary true
ServiceRequest.orderDetail.parameter.value[x]
Element Id ServiceRequest.orderDetail.parameter.value[x]
Definition

Indicates a value for the order detail.

Short Display The value for the order detail
Cardinality 1..1
Type Quantity|Ratio|Range|boolean|CodeableConcept|string|Period
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary true
Comments

CodeableConcept values are indented to express concepts that would normally be coded - when a code is not available for a concept, CodeableConcept.text can be used. When the data is a text or not a single identifiable concept, string should be used.

ServiceRequest.quantity[x]
Element Id ServiceRequest.quantity[x]
Definition

An amount of service being requested.

Short Display Service amount
Cardinality 0..1
Type Quantity|Ratio|Range
[x] Note See Choice of Datatypes for further information about how to use [x]
Requirements

When ordering a service the number of service items may need to be specified separately from the the service item.

Summary true
Comments

The amount of service being requested can be a quantity (e.g., $1,500 for home modification request), a ratio (e.g., 20 for a request of home visits to occur each month), or a range (e.g., 8-10 for physiotherapy sessions).

ServiceRequest.subject
Element Id ServiceRequest.subject
Definition

On whom or what the service is to be performed. This is usually a human patient, but can also be requested on animals, groups of humans or animals, devices such as dialysis machines, or even locations (typically for environmental scans).

Short Display Individual or Entity the service is ordered for
Cardinality 1..1
Type Reference(Patient | Group | Location | Device)
Summary true
ServiceRequest.focus
Element Id ServiceRequest.focus
Definition

The actual focus of a service request when it is not the subject of record representing something or someone associated with the subject such as a spouse, parent, fetus, or donor. The focus of a service request could also be an existing condition, an intervention, the subject's diet, another service request on the subject, or a body structure such as tumor or implanted device.

Short Display What the service request is about, when it is not about the subject of record
Cardinality 0..*
Type Reference(Any)
Summary true
ServiceRequest.encounter
Element Id ServiceRequest.encounter
Definition

An encounter that provides additional information about the healthcare context in which this request is made.

Short Display Encounter in which the request was created
Cardinality 0..1
Type Reference(Encounter)
Alternate Names context
Summary true
ServiceRequest.occurrence[x]
Element Id ServiceRequest.occurrence[x]
Definition

The date/time at which the requested service should occur.

Short Display When service should occur
Cardinality 0..1
Type dateTime|Period|Timing
[x] Note See Choice of Datatypes for further information about how to use [x]
Alternate Names schedule
Summary true
ServiceRequest.asNeeded[x]
Element Id ServiceRequest.asNeeded[x]
Definition

If a CodeableConcept is present, it indicates the pre-condition for performing the service. For example "pain", "on flare-up", etc.

Short Display Preconditions for service
Cardinality 0..1
Terminology Binding SNOMED CT Medication As Needed Reason Codes (Example)
Type boolean|CodeableConcept
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary true
ServiceRequest.authoredOn
Element Id ServiceRequest.authoredOn
Definition

When the request transitioned to being actionable.

Short Display Date request signed
Cardinality 0..1
Type dateTime
Alternate Names orderedOn
Summary true
ServiceRequest.requester
Element Id ServiceRequest.requester
Definition

The individual who initiated the request and has responsibility for its activation.

Short Display Who/what is requesting service
Cardinality 0..1
Type Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
Alternate Names author; orderer
Summary true
Comments

This not the dispatcher, but rather who is the authorizer. This element is not intended to handle delegation which would generally be managed through the Provenance resource.

ServiceRequest.performerType
Element Id ServiceRequest.performerType
Definition

Desired type of performer for doing the requested service.

Short Display Performer role
Cardinality 0..1
Terminology Binding Participant Roles (Example)
Type CodeableConcept
Alternate Names specialty
Summary true
Comments

This is a role, not a participation type. In other words, does not describe the task but describes the capacity. For example, “compounding pharmacy”, “psychiatrist” or “internal referral”.

ServiceRequest.performer
Element Id ServiceRequest.performer
Definition

The desired performer for doing the requested service. For example, the surgeon, dermatopathologist, endoscopist, etc.

Short Display Requested performer
Cardinality 0..*
Type Reference(Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService | Patient | Device | RelatedPerson)
Alternate Names request recipient
Summary true
Comments

If multiple performers are present, it is interpreted as a list of alternative performers without any preference regardless of order. If order of preference is needed use the http://hl7.org/fhir/StructureDefinition/request-performerOrder. Use CareTeam to represent a group of performers (for example, Practitioner A and Practitioner B).

ServiceRequest.location
Element Id ServiceRequest.location
Definition

The preferred location(s) where the procedure should actually happen in coded or free text form. E.g. at home or nursing day care center.

Short Display Requested location
Cardinality 0..*
Terminology Binding ServiceDeliveryLocationRoleType icon (Example)
Type CodeableReference(Location)
Summary true
ServiceRequest.reason
Element Id ServiceRequest.reason
Definition

An explanation or justification for why this service is being requested in coded or textual form. This is often for billing purposes. May relate to the resources referred to in supportingInfo.

Short Display Explanation/Justification for procedure or service
Cardinality 0..*
Terminology Binding Procedure Reason Codes (Example)
Type CodeableReference(Condition | Observation | DiagnosticReport | DocumentReference | DetectedIssue | Procedure)
Summary true
Comments

This element represents why the request is being made and may be used to decide how the service will be performed, or even if it will be performed at all. To be as specific as possible, a reference to Observation or Condition should be used if available. Use reason.concept.text element if the data is free (uncoded) text as shown in the CT Scan example.

ServiceRequest.insurance
Element Id ServiceRequest.insurance
Definition

Insurance plans, coverage extensions, pre-authorizations and/or pre-determinations that may be needed for delivering the requested service.

Short Display Associated insurance coverage
Cardinality 0..*
Type Reference(Coverage | ClaimResponse)
Summary false
ServiceRequest.supportingInfo
Element Id ServiceRequest.supportingInfo
Definition

Additional clinical information about the patient or specimen that may influence the services or their interpretations. This information includes diagnosis, clinical findings and other observations. In laboratory ordering these are typically referred to as 'ask at order entry questions (AOEs).' This includes observations explicitly requested by the producer (filler) to provide context or supporting information needed to complete the order. For example, reporting the amount of inspired oxygen for blood gas measurements.

Short Display Additional clinical information
Cardinality 0..*
Type CodeableReference(Any)
Alternate Names Ask at order entry question; AOE
Summary false
Comments

To represent information about how the services are to be delivered, use the orderDetail element.

ServiceRequest.specimen
Element Id ServiceRequest.specimen
Definition

One or more specimens that the laboratory procedure will use.

Short Display Procedure Samples
Cardinality 0..*
Type Reference(Specimen)
Summary true
Comments

The purpose of the ServiceRequest.specimen is to reflect the actual specimen that the requested test/procedure is asked to be performed on, whether the lab already has it or not. References to specimens for purposes other than to perform a test/procedure on should be made using the ServiceRequest.supportingInfo or the Specimen.parent where the Specimen.parent would enable descendency and ServiceRequest.supportingInfo a general reference for context.

ServiceRequest.bodySite
Element Id ServiceRequest.bodySite
Definition

Anatomic location where the procedure should be performed. This is the target site.

Short Display Coded location on Body
Cardinality 0..*
Terminology Binding SNOMED CT Body Structures (Example)
Type CodeableConcept
Requirements

Knowing where the procedure is performed is important for tracking if multiple sites are possible.

Alternate Names location
Summary true
Comments

Only used if not implicit in the code found in ServiceRequest.code. If the use case requires BodySite to be handled as a separate resource instead of an inline coded element (e.g. to identify and track separately) then use the standard extension http://hl7.org/fhir/StructureDefinition/procedure-targetBodyStructure.

Invariants
Affect this element
bdystr-1Rule bodyStructure SHALL only be present if bodySite is not presentbodySite.exists() implies bodyStructure.empty()
ServiceRequest.bodyStructure
Element Id ServiceRequest.bodyStructure
Definition

Anatomic location where the procedure should be performed. This is the target site.

Short Display BodyStructure-based location on the body
Cardinality 0..1
Type Reference(BodyStructure)
Requirements

Knowing where the procedure is performed is important for tracking if multiple sites are possible.

Alternate Names locationStructure
Summary true
Invariants
Affect this element
bdystr-1Rule bodyStructure SHALL only be present if bodySite is not presentbodySite.exists() implies bodyStructure.empty()
ServiceRequest.note
Element Id ServiceRequest.note
Definition

Any other notes and comments made about the service request. For example, internal billing notes.

Short Display Comments
Cardinality 0..*
Type Annotation
Summary false
ServiceRequest.patientInstruction
Element Id ServiceRequest.patientInstruction
Definition

Instructions in terms that are understood by the patient or consumer.

Short Display Patient or consumer-oriented instructions
Cardinality 0..*
Summary false
ServiceRequest.patientInstruction.instruction[x]
Element Id ServiceRequest.patientInstruction.instruction[x]
Definition

Instructions in terms that are understood by the patient or consumer.

Short Display Patient or consumer-oriented instructions
Cardinality 0..1
Type markdown|Reference(DocumentReference)
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary true
ServiceRequest.relevantHistory
Element Id ServiceRequest.relevantHistory
Definition

Key events in the history of the request.

Short Display Request provenance
Cardinality 0..*
Type Reference(Provenance)
Summary false
Comments

This might not include provenances for all versions of the request – only those deemed “relevant” or important. This SHALL NOT include the Provenance associated with this current version of the resource. (If that provenance is deemed to be a “relevant” change, it will need to be added as part of a later update. Until then, it can be queried directly as the Provenance that points to this version using _revinclude All Provenances should have some historical version of this Request as their subject.