Referral Management

Building out a referral management experience requires composing multiple FHIR resources into a workflow that meets the requirements of both referring and receiving providers. There are three primary interactions that developers should consider when building out a custom referral management solution:

• Capturing referral requests from the referring provider
• Transmitting referrals to receiving providers
• Tracking referral status throughout the workflow

Referral Overview

Here is a sample of what a referral management experience might look like - to be clear, referral interfaces can look however you want them to. A sample referral application could be built using Medplum React components.

When capturing referral information, gathering the essential details using a Questionnaire is a good first step. This can be used to create a ServiceRequest which serves as the core referral resource. You can query all resources related to a given referral from the ServiceRequest endpoint.

Depending on your use case, you might need to include different supporting information such as Conditions, Observations, or DocumentReferences. Search is useful to construct the specific queries that will give the context needed for a complete referral.

React components are available to aid in building a quick referral experience. QuestionnaireForm, ResourceTable, Search control, ResourceAvatar, and Timeline are potential components that can speed development of the referral management interface.

Key Resources

Resource	Description
ServiceRequest	The primary resource for representing a referral. Contains details about the requested service, priority, and supporting information.
Task	Used to track the status of the referral through its lifecycle (requested, accepted, rejected, in-progress, completed).
Questionnaire	Defines structured forms for capturing referral information consistently.
QuestionnaireResponse	Contains the completed referral form data that can be processed to create a ServiceRequest.
Communication	Represents the transmission of referral information between providers, including attachments and delivery status.
DocumentReference	Used to attach clinical documents, images, or other files to the referral.
Condition	Represents diagnoses that justify the reason for the referral.
Observation	Contains clinical measurements or findings that support the referral.

Key Code Systems

Code System	Description
SNOMED CT	Used in ServiceRequest resources to specify referral types and specialties.
ICD-10	Used in Condition resources to specify diagnoses that justify the referral.
LOINC	Used in Observation resources to specify clinical measurements included in the referral.

Reference

• FHIR ServiceRequest Resource
• FHIR Task Resource
• FHIR Communication Resource
• Medplum Questionnaires Documentation
• Medplum Bots Documentation