Magentus Practice Management FHIR Implementation Guide
1.2.16 - ci-build

Magentus Practice Management FHIR Implementation Guide - Local Development build (v1.2.16) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Resource Profile: GSReferralRequest - Mappings

Draft as of 2024-08-15

Mappings for the gs-referral-request resource profile.

### Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

GSReferralRequest
ServiceRequest | Request
identifier | Request.identifier
instantiatesCanonical | Request.instantiatesCanonical
instantiatesUri | Request.instantiatesUri
basedOn | Request.basedOn
replaces | Request.replaces
requisition | Request.groupIdentifier
status | Request.status
intent | Request.intent
priority | Request.priority
doNotPerform | Request.doNotPerform
code | Request.code
subject | Request.subject
encounter | Request.encounter
occurrence[x] | Request.occurrence[x]
authoredOn | Request.authoredOn
requester | Request.requester
performerType | Request.performerType
performer | Request.performer
reasonCode | Request.reasonCode
reasonReference | Request.reasonReference
insurance | Request.insurance
supportingInfo | Request.supportingInfo
supportingInfo (condition) | Request.supportingInfo
supportingInfo (observation) | Request.supportingInfo
supportingInfo (procedure) | Request.supportingInfo
supportingInfo (allergy) | Request.supportingInfo
supportingInfo (medication) | Request.supportingInfo
supportingInfo (paper) | Request.supportingInfo
note | Request.note
relevantHistory | Request.relevantHistory

### Mappings for HL7 v2 Mapping (http://hl7.org/v2)

GSReferralRequest
ServiceRequest | ORC
identifier | ORC.2, ORC.3, RF1-6 / RF1-11,
identifier (placer) | CX / EI (occasionally, more often EI maps to a resource id or a URL)
use | N/A
type | CX.5
system | CX.4 / EI-2-4
value | CX.1 / EI.1
period | CX.7 + CX.8
assigner | CX.4 / (CX.4,CX.9,CX.10)
instantiatesCanonical | Varies by domain
instantiatesUri | Varies by domain
basedOn | ORC.8 (plus others)
replaces | Handled by message location of ORC (ORC.1=RO or RU)
requisition | ORC.4
status | ORC.5,RF1-1
intent | N/A
category | RF1-5
priority | TQ1.9, RF1-2
code | PR1-3 / OBR-4 (varies by domain)
coding | C*E.1-8, C*E.10-22
coding (patientrefferal) | C*E.1-8, C*E.10-22
system | C*E.3
version | C*E.7
code | C*E.1
display | C*E.2 - but note this is not well followed
userSelected | Sometimes implied by being first
text | C*E.9. But note many systems use C*E.2 for this
orderDetail | NTE
quantity[x] | NTE
subject | PID
encounter | PV1
occurrence[x] | TQ1/TQ2, OBR-7/OBR-8
authoredOn | ORC.9, RF1-7 / RF1-9
requester | ORC.12, PRT
performerType | PRT, RF!-3
performer | PRT, Practitioner: PRD-2/PRD-7 where PRD-3 = RT; Organization: PRD-10 where PRD-3 = RT
reasonCode | ORC.16, RF1-10
reasonReference | ORC.16
insurance | IN1/IN2
supportingInfo | Accompanying segments
supportingInfo (condition) | Accompanying segments
supportingInfo (observation) | Accompanying segments
supportingInfo (procedure) | Accompanying segments
supportingInfo (allergy) | Accompanying segments
supportingInfo (medication) | Accompanying segments
supportingInfo (paper) | Accompanying segments
specimen | SPM
bodySite | SPM
note | NTE
patientInstruction | NTE
relevantHistory | N/A

### Mappings for RIM Mapping (http://hl7.org/v3)

GSReferralRequest
ServiceRequest | Entity. Role, or Act, Act[moodCode<=INT]
text | Act.text?
contained | N/A
extension | N/A
modifierExtension | N/A
identifier | .identifier
identifier (placer) | n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
id | n/a
extension | n/a
use | Role.code or implied by context
type | Role.code or implied by context
system | II.root or Role.id.root
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period | Role.effectiveTime or implied by context
assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
id | n/a
extension | n/a
reference | N/A
type | N/A
identifier | .identifier
display | N/A
instantiatesCanonical | .outboundRelationship[typeCode=DEFN].target
instantiatesUri | .outboundRelationship[typeCode=DEFN].target
basedOn | .outboundRelationship[typeCode=FLFS].target
replaces | .outboundRelationship[typeCode=RPLC].target
requisition | .inboundRelationship(typeCode=COMP].source[moodCode=INT].identifier
status | .status
intent | .moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)
category | .outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="INT"].code
priority | .priorityCode
doNotPerform | .actionNegationInd
code | .code
id | n/a
extension | n/a
coding | union(., ./translation)
coding (patientrefferal) | union(., ./translation)
id | n/a
extension | n/a
system | ./codeSystem
version | ./codeSystemVersion
code | ./code
display | CV.displayName
userSelected | CD.codingRationale
text | ./originalText[mediaType/code="text/plain"]/data
orderDetail | .code
quantity[x] | .quantity
subject | .participation[typeCode=SBJ].role
encounter | .inboundRelationship(typeCode=COMP].source[classCode<=PCPR, moodCode=EVN]
occurrence[x] | .effectiveTime
asNeeded[x] | boolean: precondition.negationInd (inversed - so negationInd = true means asNeeded=false CodeableConcept: precondition.observationEventCriterion[code="Assertion"].value
authoredOn | .participation[typeCode=AUT].time
requester | .participation[typeCode=AUT].role
performerType | .participation[typeCode=PRF].role[scoper.determinerCode=KIND].code
performer | .participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
locationCode | .participation[typeCode=LOC].role[scoper.determinerCode=KIND].code
locationReference | .participation[typeCode=LOC].role[scoper.determinerCode=INSTANCE]
reasonCode | .reasonCode
reasonReference | .outboundRelationship[typeCode=RSON].target
insurance | .outboundRelationship[typeCode=COVBY].target
id | n/a
extension | n/a
reference | N/A
type | N/A
identifier | .identifier
display | N/A
supportingInfo | .outboundRelationship[typeCode=PERT].target
supportingInfo (condition) | .outboundRelationship[typeCode=PERT].target
supportingInfo (observation) | .outboundRelationship[typeCode=PERT].target
supportingInfo (procedure) | .outboundRelationship[typeCode=PERT].target
supportingInfo (allergy) | .outboundRelationship[typeCode=PERT].target
supportingInfo (medication) | .outboundRelationship[typeCode=PERT].target
supportingInfo (paper) | .outboundRelationship[typeCode=PERT].target
specimen | .participation[typeCode=SPC].role
bodySite | targetSiteCode
note | .inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN, moodCode=EVN].value[xsi:type=ST]
patientInstruction | .text
relevantHistory | .inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

### Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

GSReferralRequest
ServiceRequest |
identifier | FiveWs.identifier
status | FiveWs.status
intent | FiveWs.class
category | FiveWs.class
priority | FiveWs.grade
code | FiveWs.what[x]
subject | FiveWs.subject[x], FiveWs.subject
encounter | FiveWs.context
occurrence[x] | FiveWs.planned
authoredOn | FiveWs.recorded
requester | FiveWs.author
performerType | FiveWs.actor
performer | FiveWs.actor
locationCode | FiveWs.actor
locationReference | FiveWs.actor
reasonCode | FiveWs.why[x]
reasonReference | FiveWs.why[x]

### Mappings for Quality Improvement and Clinical Knowledge (QUICK) (http://siframework.org/cqf)

GSReferralRequest
ServiceRequest |
identifier | ClinicalStatement.identifier
status | Action.currentStatus
code | Procedure.procedureCode
orderDetail | Procedure.procedureCode
subject | ClinicalStatement.subject
encounter | ClinicalStatement.encounter
occurrence[x] | Procedure.procedureSchedule
asNeeded[x] | Proposal.prnReason.reason
authoredOn | Proposal.proposedAtTime
requester | ClinicalStatement.statementAuthor
bodySite | Procedure.targetBodySite
note | ClinicalStatement.additionalText