NHS Digital FHIR Medicines

Element Id

MedicationRequest.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Data Type

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

medicationRepeatInformation

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:medicationRepeatInformation

Short description

Continous and Continuous Repeat Dispensing

Alternate names

extensions, user content

Definition

This extension MUST be present for continuous and continuous-repeat-dispensing therapy types.

Field	Description
numberOfRepeatPrescriptionsIssued	Running total of number of issues made against a repeat authorisation. Including this issue.
~~numberOfRepeatPrescriptionsAllowed~~	Retired. See numberOfRepeatsAllowed
authorisationExpiryDate	The date a repeat prescription authorisation will expire.

"extension": [
  {
       "url": "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation",
       "extension": [
           {
               "url": "numberOfRepeatPrescriptionsIssued",
               "valueUnsignedInt": 3
           },
           {
               "url": "authorisationExpiryDate",
               "valueDateTime": "2020-08-07"
           }
       ]
   }
]

Comments

Data Type

Extension(Complex)

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

responsiblePractitioner

S I

0..1

Element Id

MedicationRequest.extension:responsiblePractitioner

Short description

Responsible Practitioner for the prescription

Alternate names

extensions, user content

Definition

Must only be populated if the requester can not be responsible for the prescription, i.e. they would not be named as the prescriber on the FP10.

"extension": [
        
    {
        "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner",
        "valueReference": {
            "reference": "urn:uuid:a5acefc1-f8ca-4989-a5ac-34ae36741466",
            "display": "DR SAZ RAZ"
        }
    }
],

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

prescriptionEndorsement

S I

0..*

Element Id

MedicationRequest.extension:prescriptionEndorsement

Short description

NHS BSA Prescription Endorsements

Alternate names

extensions, user content

Definition

The codes are contained in the valueset

Code	Display
CC	Contraceptive
FS	Sexual Health
ACBS	Advisory Committee on Borderline Substances. Part XV Drug Tariff
SLS	Selected List Scheme. Part XVIIIB Drug Tariff
AF	Food replacement/food supplement products

"resourceType": "MedicationRequest",
    "extension":  [
      {
          "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionEndorsement",
          "valueCodeableConcept": {
              "coding":  [
                {
                    "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-endorsement",
                    "code": "SLS",
                    "display": "Selected List Scheme"
                }
            ]
        }
    }
  ],

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionEndorsement

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

prescriptionTaskStatusReason

S I

0..*

Extension(Complex)

Element Id

MedicationRequest.extension:prescriptionTaskStatusReason

Short description

Prescription task status reason

Alternate names

extensions, user content

Definition

The status history within EPS is primarily a technical Status and the statusReason will reflect current clinical status of the order.

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionStatusHistory

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

NHSBSAprescriptionType

S I

1..1

Element Id

MedicationRequest.extension:NHSBSAprescriptionType

Short description

NHS BSA Prescription Type

Alternate names

extensions, user content

Definition

The vocabulary for the ‘PrescriptionType’ vocabulary is defined within the NHSBSA Overprint Specification.

The System must populate the ‘PrescriptionType’ attribute for the appropriate combination of prescriber and care setting. Retired codes within this vocabulary must not be used

"extension":  [
    {
        "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionType",
        "valueCoding": {
            "system": "https://fhir.nhs.uk/CodeSystem/prescription-type",
            "code": "1201",
            "display": "Outpatient Homecare Prescriber - Medical Prescriber"
        }
    }
    ]

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionType

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

controlledDrug

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:controlledDrug

Short description

Optional Controlled Drug Extensions

Alternate names

extensions, user content

Definition

The table below summarises the EPS requirements for the CD schedules. The terms “Hand signature” and “Electronic signature” expressed in the table are shortened references to the legal definition of signature requirements within government legislation.

Sch.	Code	Signing Legal Requirement	EPS Scope	Expiry Date	Quantity Representation	Repeat Dispensing Allowed	RD 1st Issue Expiry	RD Subsequent Expiry
1	CD1	Invalid to prescribe	Out of scope	N/A	N/A	N/A	N/A
2	CD2	Hand signature or electronic signature	In scope	28 days	Words and Figures	No	N/A	N/A
3	CD3	Hand signature or electronic signature	In scope	28 days	Words and Figures	No	N/A	N/A
4	CD4-1 CD4-2	Hand signature or electronic signature	In scope	28 days	Figures	Yes	28 days	Up to 12 months
5	CD5	Hand signature or electronic signature	In scope	6 Months	Figures	Yes	6 months	Up to 12 months

It is a legal requirement to state the prescribed quantity as words in the quantityWords

{
    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-ControlledDrug",
    "extension": [
        {
            "url": "quantityWords",
            "valueString": "twenty eight"
        },
        {
            "url": "schedule",
            "valueCoding": {
                "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-controlled-drug",
                "code": "CD2",
                "display": "Schedule 2"
            }
        }
    ]
}

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-DM-ControlledDrug

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()
eps-cd1:Extension(controlledDrug) - For schedule 2 or 3 Controlled Drugs, the quantity must be expressed in words
(((extension('schedule').value.code='CD2' and extension('quantityWords').exists()) or (extension('schedule').value.code='CD3' and extension('quantityWords').exists()) or (extension('schedule').value.code != 'CD2' and extension('schedule').value.code != 'CD3')) and extension('scheduled').exists()) or (extension('scheduled').exists().not())

Mappings

rim:n/a
rim:N/A

dispensingInformation

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:dispensingInformation

Short description

For EPS use only

Alternate names

extensions, user content

Definition

This extension is used in continuous-repeat-dispensing prescriptions sent by EPS to dispensing systems to convey information on prior dispensed medications.

"extension":  [
                {
                    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation",
                    "extension":  [
                        {
                            "url": "dispenseStatus",
                            "valueCoding": {
                                "system": "https://fhir.nhs.uk/CodeSystem/medicationdispense-type",
                                "code": "0001",
                                "display": "Item fully dispensed"
                            }
                        },
                        {
                            "url": "dateLastDispensed",
                            "valueDateTime": "2018-04-22T09:57:03+00:00"
                        }
                    ]
                }
            ],

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

1..*

Element Id

MedicationRequest.identifier

Short description

Each MedicationRequest MUST be identified by an Universal Unique Identifiers (UUIDs) with a system of https://fhir.nhs.uk/Id/prescription-order-item-number

Definition

UUID example (for illustration purposes only);

a54219b8-f741-4c47-b662-e4f8dfa49ab6

 "identifier":  [
    {
        "system": "https://fhir.nhs.uk/Id/prescription-order-item-number",
        "value": "a54219b8-f741-4c47-b662-e4f8dfa49ab6"
    }
]

Comments

This is a business identifier, not a resource identifier.

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Request.identifier
script10.6:Message/Header/PrescriberOrderNumber
w5:FiveWs.identifier
v2:ORC-2-Placer Order Number / ORC-3-Filler Order Number
rim:.id

(All Slices)

There are no (further) constraints on this element

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times").

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

prescriptionOrderItem

1..1

Element Id

MedicationRequest.identifier:prescriptionOrderItem

Short description

Prescription Order Item

Definition

Unique Id of the MedicationRequest within EPS

Comments

This is a business identifier, not a resource identifier.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Request.identifier
script10.6:Message/Header/PrescriberOrderNumber
w5:FiveWs.identifier
v2:ORC-2-Placer Order Number / ORC-3-Filler Order Number
rim:.id

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

MedicationRequest.identifier:prescriptionOrderItem.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/prescription-order-item-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

status

S Σ ?!

1..1

codeBinding

Element Id

MedicationRequest.status

Short description

active | cancelled | stopped

Definition

A code specifying the current state of the order. Generally, this will be active or completed state.

code	Definition
active	The prescription is 'actionable', but not all actions that are implied by it have occurred yet. It has not been dispensed or filled.
cancelled	The prescription is to be cancelled or it has been cancelled been withdrawn before any administrations have occurred. Prescriptions in the process of being cancelled will be regarded as active until all actions are complete.
stopped	Actions implied by the prescription are to be permanently halted, before all of the administrations occurred. This should not be used if the original order was entered in error
completed	All actions that are implied by the prescription have occurred.

Logical medicationRequest status transitions

This state transition diagram is an enhancement over the generic State Machine defined within the FHIR specification. It includes the status values associated with a medication request with transitions applicable to a UK implementation.

Comments

This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

Data Type

medicationrequest Status (required)

Binding

A coded concept specifying the state of the prescribing event. Describes the lifecycle of the prescription.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.status
script10.6:no mapping
w5:FiveWs.status
rim:.statusCode

statusReason

0..1

CodeableConceptBinding

Element Id

MedicationRequest.statusReason

Short description

Reason for current status

Definition

This is generally only used for exception statuses such as suspended or cancelled. It is the clinical status reason for the cancellation.

This is mandatory for 'prescription-order-update' messages.

"statusReason": {
    "coding": [
        {
            "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-status-reason",
            "code": "0001",
            "display": "Prescribing Error"
        }
    ]
},

Comments

This is generally only used for "exception" statuses such as "suspended" or "cancelled". The reason why the MedicationRequest was created at all is captured in reasonCode, not here.

Data Type

MedicationRequestStatusReason (required)

Binding

Identifies the reasons for a given status.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Request.statusReason
rim:.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde

coding

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.version

Short description

Version of the system - if relevant

Definition

The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

Comments

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

intent

Σ ?!

1..1

codeBinding

Element Id

MedicationRequest.intent

Short description

Definition

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

Comments

Indicates the type of order. A code specifying the current state of the order. Generally, this will be active or completed state.

code	display	courseOfTherapyType	Definition
order	Order	acute	The request represents a request/demand and authorization for action
original-order	Original Order	continuous-repeat-dispensing instalment-dispensing	The request represents the original authorization for the medication request.
reflex-order	Reflex Order	continuous-repeat-dispensing	The request represents an automatically generated supplemental authorization (by EPS) for action based on a parent authorization together with initial results of the action taken against that parent authorization.
instance-order	Instance Order	instalment-dispensing	The request represents an instance for the particular order.

Data Type

medicationRequest Intent (required)

Binding

The kind of medication order.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.intent
w5:FiveWs.class
rim:.moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)

category

1..*

CodeableConceptBinding

Element Id

MedicationRequest.category

Short description

Type of medication usage

Definition

In primary care the code of community should be used. In secondary care the category will often match the Episode/Spell type.

Code	System	Display
leave	https://fhir.nhs.uk/CodeSystem/medicationrequest-category	Leave
outpatient	http://terminology.hl7.org/CodeSystem/medicationrequest-category	Outpatient
discharge	http://terminology.hl7.org/CodeSystem/medicationrequest-category	Discharge
community	http://terminology.hl7.org/CodeSystem/medicationrequest-category	Community
inpatient	http://terminology.hl7.org/CodeSystem/medicationrequest-category	Inpatient

"category": [
    {
        "coding": [
            {
                "system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
                "code": "outpatient",
                "display": "Outpatient"
            }
        ]
    }
],

Comments

The category can be used to include where the medication is expected to be consumed or other types of requests.

Data Type

UKCoreMedicationRequestCategory (extensible)

Binding

A coded concept identifying the category of medication request. For example, where the medication is to be consumed or administered, or the type of medication treatment.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
script10.6:Message/Body/NewRx/MedicationPrescribed/Directions or Message/Body/NewRx/MedicationPrescribed/StructuredSIG
w5:FiveWs.class
rim:.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value

coding

1..1

Element Id

MedicationRequest.category.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

patientClassFHIR

0..1

CodingBinding

Element Id

MedicationRequest.category.coding:patientClassFHIR

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

MedicationRequestCategory (required)

Binding

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

uriFixed Value

Element Id

MedicationRequest.category.coding:patientClassFHIR.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

http://terminology.hl7.org/CodeSystem/medicationrequest-category

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassFHIR.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassFHIR.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassFHIR.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassFHIR.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

patientClassUK

0..1

CodingBinding

Element Id

MedicationRequest.category.coding:patientClassUK

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

MedicationRequestCategory (required)

Binding

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

uriFixed Value

Element Id

MedicationRequest.category.coding:patientClassUK.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/CodeSystem/medicationrequest-category

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassUK.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassUK.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassUK.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.coding:patientClassUK.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.category.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

priority

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.priority

Short description

routine | urgent | asap | stat

Definition

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

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

Identifies the level of importance to be assigned to actioning the request.

RequestPriority (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.priority
w5:FiveWs.grade
rim:.priorityCode

doNotPerform

Σ ?!

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.doNotPerform

Short description

True if request is prohibiting action

Definition

If true indicates that the provider is asking for the medication request not to occur.

Comments

If do not perform is not specified, the request is a positive request e.g. "do perform".

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:SubstanceAdministration.actionNegationInd

reported[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reported[x]

Short description

Reported rather than primary record

Definition

Indicates if this record was captured as a secondary 'reported' record rather than as an original primary source-of-truth record. It may also indicate the source of the report.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.participation[typeCode=INF].role

reportedBoolean

There are no (further) constraints on this element

Data Type

NHS Digital Medication Code (extensible)

reportedReference

Reference(UK Core Patient | UK Core Practitioner | UK Core PractitionerRole | UK Core RelatedPerson | UK Core Organization)

There are no (further) constraints on this element

Data Type

Reference(UK Core Patient | UK Core Practitioner | UK Core PractitionerRole | UK Core RelatedPerson | UK Core Organization)

medication[x]

S Σ

1..1

Binding

Element Id

MedicationRequest.medication[x]

Short description

Medication to be taken

Definition

Only Virtual Medical Products (VMP) and Actual Medical Products (AMP) can be used.

Comments

Any code from the SnomedCT UK DMD subset for VMP, AMP and VTM concepts

dm+d Category	dm+d Description	UK SNOMED Members Of
VMP	Virtual Medical Product	999000561000001109
AMP	Actual Medical Product	999000541000001108

Binding

A coded concept identifying substance or product that can be ordered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.code
script10.6:Message/Body/NewRx/MedicationPrescribed Medication.code.coding.code = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCode Medication.code.coding.system = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCodeQualifier Medication.code.coding.display = Message/Body/NewRx/MedicationPrescribed/DrugDescription
w5:FiveWs.what[x]
v2:RXE-2-Give Code / RXO-1-Requested Give Code / RXC-2-Component Code
rim:consumable.administrableMedication

medicationCodeableConcept

NHSDigitalMedicationRequestCodeableConcept

Data Type

NHSDigitalMedicationRequestCodeableConcept

medicationReference

Reference(NHSDigitalMedicationRequestMedication)

Data Type

Reference(NHSDigitalMedicationRequestMedication)

Allowed aggregation: bundled

subject

S Σ I

1..1

Reference(NHSDigitalPatientPDS)

Element Id

MedicationRequest.subject

Short description

Who or group medication request is for

Definition

A resource reference to a Patient with a traced NHS Number is required, an untraced NHS Number MUST NOT be used.

 "subject": {
                    "type": "Patient",
                    "reference": "urn:uuid:bde9eba6-079f-4210-8108-6ea8db58de8c",
                    "display": "Miss Bernie Kanfeld"
                }

Comments

The subject on a medication request is mandatory. For the secondary use case where the actual subject is not provided, there still must be an anonymized subject specified.

Data Type

Reference(NHSDigitalPatientPDS)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
patient-nhs:Supplied NHS Number is outside the English and Welsh NHS Number range or length of the number is wrong.
identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').exists() and identifier.where(system='https://fhir.nhs.uk/Id/nhs-number').value.matches('^([456789]{1}[0-9]{9})$'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.subject
script10.6:Message/Body/NewRx/Patient (need detail to link to specific patient … Patient.Identification in SCRIPT)
w5:FiveWs.subject[x]
v2:PID-3-Patient ID List
rim:.participation[typeCode=AUT].role
w5:FiveWs.subject

reference

Σ I

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

Comments

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

The type is the Canonical URL of Resource Definition that is the type this reference refers to. References are URLs that are relative to http://hl7.org/fhir/StructureDefinition/ e.g. "Patient" is a reference to http://hl7.org/fhir/StructureDefinition/Patient. Absolute URLs are only allowed for logical models (and can only be used in references in logical models, not resources).

Comments

This element is used to indicate the type of the target of the reference. This may be used which ever of the other elements are populated (or not). In some cases, the type of the target may be determined by inspection of the reference (e.g. a RESTful URL) or by resolving the target of the reference; if both the type and a reference is provided, the reference SHALL resolve to a resource of the same type as that specified.

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier

Short description

Logical reference, when literal reference is not known

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comments

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

MedicationRequest.subject.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/nhs-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.subject.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Reference(NHSDigitalEncounter)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

encounter

0..1

Element Id

MedicationRequest.encounter

Short description

Encounter created as part of encounter/admission/stay

Definition

Encounter is required for secondary care prescriptions.

Comments

This will typically be the encounter the event occurred within, but some activities may be initiated prior to or after the official completion of an encounter but still be tied to the context of the encounter." If there is a need to link to episodes of care they will be handled with an extension.

Data Type

Reference(NHSDigitalEncounter)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.context
script10.6:no mapping
w5:FiveWs.context
v2:PV1-19-Visit Number
rim:.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.encounter.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

supportingInformation

0..*

Reference(Resource)

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation

Short description

Information to support ordering of the medication

Definition

Include additional information (for example, patient height and weight) that supports the ordering of the medication.

Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Data Type

Reference(Resource)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.supportingInfo
w5:FiveWs.context
rim:.outboundRelationship[typeCode=PERT].target[A_SupportingClinicalStatement CMET minimal with many different choices of classCodes(ORG, ENC, PROC, SPLY, SBADM, OBS) and each of the act class codes draws from one or more of the following moodCodes (EVN, DEF, INT PRMS, RQO, PRP, APT, ARQ, GOL)]

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.supportingInformation.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

authoredOn

S Σ

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.authoredOn

Short description

When request was initially authored

Definition

The date (and perhaps time) when the prescription was initially written or authored on.

Data Type

Reference(NHSDigitalPractitionerRoleEPSLegal | NHSDigitalPractitionerRoleSDS)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.authoredOn
script10.6:Message/Body/NewRx/MedicationPrescribed/WrittenDate
w5:FiveWs.recorded
v2:RXE-32-Original Order Date/Time / ORC-9-Date/Time of Transaction
rim:author.time

requester

S Σ I

1..1

Element Id

MedicationRequest.requester

Short description

Who/What requested the Request

Definition

The requester must contain a resource reference to the Practitioner who has electronically signed the prescription.

If the requester can not take responsibility for the prescription, i.e. they would not be the prescriber on the FP10. Then the extension responsiblePractitioner must be populated.

"requester": {
    "reference": "urn:uuid:56166769-c1c4-4d07-afa8-132b5dfca666"
},

Comments

Data Type

Reference(NHSDigitalPractitionerRoleEPSLegal | NHSDigitalPractitionerRoleSDS)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
eps-3:requester - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.requester
w5:FiveWs.author
rim:.participation[typeCode=AUT].role

reference

Σ I

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.requester.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

performer

0..1

Element Id

MedicationRequest.performer

Short description

A reference from one resource to another

Definition

A reference from one resource to another.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.performer
w5:FiveWs.actor
rim:.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performer.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

performerType

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.performerType

Short description

Desired kind of performer of the medication administration

Definition

Indicates the type of performer of the administration of the medication.

Comments

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.

Data Type

ProcedurePerformerRoleCodes (example)

Binding

Identifies the type of individual that is desired to administer the medication.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Request.performerType
rim:.participation[typeCode=PRF].role[scoper.determinerCode=KIND].code

recorder

0..1

Reference(NHSDigitalPractitioner)

Element Id

MedicationRequest.recorder

Short description

Person who entered the request

Definition

The person who entered the order on behalf of another individual for example in the case of a verbal or a telephone order.

Comments

Data Type

Reference(NHSDigitalPractitioner)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
eps-4:recorder - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
w5:FiveWs.who
rim:.participation[typeCode=TRANS].role[classCode=ASSIGNED].code (HealthcareProviderType)

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.recorder.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

reasonCode

0..*

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonCode

Short description

Reason or indication for ordering or not ordering the medication

Definition

The reason or the indication for ordering or not ordering the medication.

Comments

This could be a diagnosis code. If a full condition record exists or additional detail is needed, use reasonReference.

Data Type

Condition/Problem/DiagnosisCodes (example)

Binding

A coded concept indicating why the medication was ordered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Request.reasonCode
script10.6:Message/Body/NewRx/MedicationPrescribed/Diagnosis/Primary/Value
w5:FiveWs.why[x]
v2:ORC-16-Order Control Code Reason /RXE-27-Give Indication/RXO-20-Indication / RXD-21-Indication / RXG-22-Indication / RXA-19-Indication
rim:reason.observation.reasonCode

reasonReference

0..*

Reference(UK Core Condition | UK Core Observation)

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference

Short description

Condition or observation that supports why the prescription is being written

Definition

Condition or observation that supports why the medication was ordered.

Comments

This is a reference to a condition or observation that is the reason for the medication order. If only a code exists, use reasonCode.

Data Type

Reference(UK Core Condition | UK Core Observation)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.reasonReference
script10.6:no mapping
w5:FiveWs.why[x]
rim:reason.observation[code=ASSERTION].value

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.reasonReference.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

instantiatesCanonical

0..*

canonical()

There are no (further) constraints on this element

Element Id

MedicationRequest.instantiatesCanonical

Short description

Instantiates FHIR protocol or definition

Definition

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

Comments

see Canonical References

Data Type

canonical()

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.instantiates
rim:.outboundRelationship[typeCode=DEFN].target

instantiatesUri

0..*

There are no (further) constraints on this element

Element Id

MedicationRequest.instantiatesUri

Short description

Instantiates external protocol or definition

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 MedicationRequest.

Comments

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

Data Type

Reference(ImmunizationRecommendation | NHSDigitalMedicationRequest)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.outboundRelationship[typeCode=DEFN].target

basedOn

S Σ I

0..*

Element Id

MedicationRequest.basedOn

Short description

What request fulfills

Definition

This MUST be populated for continuous-repeat-dispensing issues where intent=reflex-order, i.e. the issues sent from EPS to pharmacists. It is recommended this is populated for continuous issues and this should reference the original order.

Example for a reflex-order (continuous-repeat-dispensing):

 "basedOn": [
        {
            "extension": [
                {
                    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-RepeatInformation",
                    "extension": [
                        {
                            "url": "numberOfRepeatsAllowed",
                            "valueInteger": 6
                        }
                    ]
                }
            ],
            "identifier": {
                "system": "https://fhir.nhs.uk/Id/prescription-order-item-number",
                "value": "A7B86F8D-1D59-FC28-E050-D20AE3A215F0"
            }
        }
    ]

Example for a instance-order (continuous). Note this references an example MedicationRequest from GP Connect:

 "basedOn": [
        {
            "extension": [
                {
                    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-RepeatInformation",
                    "extension": [
                        {
                            "url": "numberOfRepeatsAllowed",
                            "valueInteger": 5
                        }
                    ]
                }
            ],
            "identifier": {
                "system": "https://provider.nhs.uk/data-identifier",
                "value": "53426283749629"
            }
        }
    ]

Comments

Data Type

Reference(ImmunizationRecommendation | NHSDigitalMedicationRequest)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.basedOn
rim:.outboundRelationship[typeCode=FLFS].target[classCode=SBADM or PROC or PCPR or OBS, moodCode=RQO orPLAN or PRP]

extension

0..*

Element Id

MedicationRequest.basedOn.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-EPS-RepeatInformation

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

repeatInformation

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.basedOn.extension:repeatInformation

Short description

Additional repeatInformation

Alternate names

extensions, user content

Definition

The extension numberOfRepeatsIssued should not be populated.

The meaning of numberOfRepeatsAllowed is the same as the dispensingRequest.numberOfRepeatsAllowed i.e.

An integer indicating the number of times, in addition to the original dispense, (aka refills or repeats) that the patient can receive the prescribed medication. Usage Notes: This integer does not include the original order dispense. This means that if an order indicates dispense 30 tablets plus "3 repeats", then the order can be dispensed a total of 4 times and the patient can receive a total of 120 tablets. A prescriber may explicitly say that zero refills are permitted after the initial dispense.

"extension": [
                {
                    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-RepeatInformation",
                    "extension": [
                        {
                            "url": "numberOfRepeatsAllowed",
                            "valueUnsignedInt": 2
                        }
                    ]
                }
            ]

Comments

Data Type

Extension(Complex)

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

orignalPrescriptionId

0..1

Element Id

MedicationRequest.basedOn.extension:orignalPrescriptionId

Short description

Optional Extensions Element

Alternate names

extensions, user content

Definition

The original prescription id, used in repeats. This is taken from the same extension in the original MedicationRequest.groupIdentifier.

  "extension":  [
        {
            "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId",
            "valueIdentifier": {
                "system": "https://fhir.nhs.uk/Id/prescription",
                "value": "ad945a29-85f8-439a-b590-6789719adc16"
            }
        }
    ],

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.basedOn.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

groupIdentifier

S Σ

1..1

Element Id

MedicationRequest.groupIdentifier

Short description

groupIdentifier (Short Form Prescription ID)

Definition

The purpose of the Short Form Prescription ID is to identify the prescription during its lifecycle within the Spine (i.e. prescribe, dispense & claim). The prescription UUID is retained to provide the link through to the Spine medication record within the PSIS and must be included as the first identifier within the prescription message. The format of the Short Form Prescription ID is as follows;

<RandomNumber>-<PracticeODSCode/ClinicODSCode>-<PracticeSequence/ClinicSequence><CheckDigit>

Where;

<RandomNumber> is a locally generated random number each time a Prescription ID is generated of length 6 hexadecimal characters.

<PracticeODSCode/ClinicODSCode> is the unique ODS code for the practice or clinic code (aka cost centre) as defined within the Spine SDS of length 6 characters. Where the prescriber ODS code is shorter than 6 characters it must be zero-padded up to six characters from the start of the ODS code, e.g. “0A1B2C”.

<PracticeSequence/ClinicSequence> is an incremental sequence number starting from 00000 that is reset after FFFFF back to zero of length 5 hexadecimal characters. For systems that support multiple practices or clinics, a sequence number per practice/clinic is required. This is to ensure uniqueness of prescriptions within the Spine EPS component during the prescription lifecycle.

<CheckDigit> is calculated on the entire ID using the ISO/IEC 7064:2003 MOD 37-2 standard. The check digit algorithm is identical to that using for EPS Release 1.

Note. Hyphens are always included to separate the ID into 3 blocks of 6 characters.

Note. The implementation of the MOD 37-2 standard uses a “+” character for char 36 opposed to a “*” character.

Short Form Prescription ID example (for illustration purposes only);

83C40E-A23856-00123W

"groupIdentifier": {
    ...
    "system": "https://fhir.nhs.uk/Id/prescription-order-number",
    "value": "DC2C66-A1B2C3-23407B"
},

Requirements

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.

Comments

ITK HL7v3 Mapping = The groupIdentifier is equivalent to ParentPrescription.id (prescription-order-number). The extension is used to carry the ParentPrescription.id (UUID).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Request.groupIdentifier
rim:.outboundRelationship(typeCode=COMP].target[classCode=SBADM, moodCode=INT].id

extension

1..*

Element Id

MedicationRequest.groupIdentifier.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

PrescriptionOrderUUID

1..1

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID

Short description

UUID order number for grouped MedciationRequests

Alternate names

extensions, user content

Definition

When UUIDs are used within HL7 messages they must be represented in an upper case human-readable hexadecimal format where hyphen separators are used as per the example below and as defined by the ‘datatype’ schema within the DMS.

UUID example (for illustration purposes only);

34026084-A445-84AD-2D01-97D69ED25865

"groupIdentifier": {
    "extension":  [
        {
            "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId",
            "valueIdentifier": {
                "system": "https://fhir.nhs.uk/Id/prescription",
                "value": "ad945a29-85f8-439a-b590-6789719adc16"
            }
        }
    ],
    "system": "https://fhir.nhs.uk/Id/prescription-order-number",
    "value": "DC2C66-A1B2C3-23407B"
},

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

url

1..1

System.StringFixed Value

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.url

Short description

identifies the meaning of the extension

Definition

Source of the definition for the extension code - a logical name or a URL.

Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Data Type

System.String

Fixed Value

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionId

Mappings

rim:N/A

value[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x]

Short description

Value of extension

Definition

Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

valueIdentifier

There are no (further) constraints on this element

Data Type

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/prescription

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

Reference(Organization)

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.extension:PrescriptionOrderUUID.value[x].assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Reference(Organization)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

MedicationRequest.groupIdentifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/prescription-order-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.groupIdentifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

courseOfTherapyType

1..1

CodeableConceptBinding

Element Id

MedicationRequest.courseOfTherapyType

Short description

A course of therapy for a medication request

Definition

"courseOfTherapyType": {
  "coding":  [
      {
          "system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
          "code": "acute",
          "display": "Short course (acute) therapy"
      }
  ]
},

Comments

The type of prescription e.g. acute, continuous, etc. Was extension in STU3 https://fhir.hl7.org.uk/STU3/StructureDefinition/Extension-CareConnect-PrescriptionType-1 and Digital Medicine uses international codes, so continuous in place of repeat.

Data Type

Medication Request Course of Therapy Codes (required)

Binding

Identifies the overall pattern of medication administratio.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:Act.code where classCode = LIST and moodCode = EVN

coding

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.courseOfTherapyType.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

insurance

0..*

Reference(Coverage | ClaimResponse)

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance

Short description

Associated insurance coverage

Definition

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

Comments

Data Type

Reference(Coverage | ClaimResponse)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.insurance
rim:.outboundRelationship[typeCode=COVBY].target

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.insurance.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

note

0..*

Annotation

Element Id

MedicationRequest.note

Short description

Dispensing Note

Definition

Clinical information relating to a prescribed medication item that cannot be conveyed within dosage instructions is populated within note field.

Examples of dispensing notes are:

To explain changes in dosage, for example, “Dosage has been increased on advice of the hospital”.
"Tell patient to stop their statin whilst on this anitbiotic"
"hospital consultant has confirmed dual treatment"

One scenario where note must be populated is when the current prescribed medication item is the last authorised repeat of that medication within a repeat prescribing cycle. Appropriate text, such as “Last authorised repeat” must be included within the note to inform the dispenser and to allow the dispenser to communicate to the patient or patient representative. Note that for repeat dispensing, the ‘numberOfRepeatPrescriptionsIssued’ element also conveys this information.

"note": [
    {
      "text": "Tell patient to stop their statin whilst on this anitbiotic"
    }
  ],

Comments

For systems that do not have structured annotations, they can simply communicate a single annotation with no author or time. This element may need to be included in narrative because of the potential for modifying information. Annotations SHOULD NOT be used to communicate "modifying" information that could be computable. (This is a SHOULD because enforcing user behavior is nearly impossible).

Data Type

Annotation

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act
workflow:Request.note
script10.6:Message/Body/NewRx/MedicationPrescribed/Note
rim:.inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value

author[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.note.author[x]

Short description

Individual responsible for the annotation

Definition

The individual responsible for making the annotation.

Comments

Organization is used when there's no need for specific attribution as to who made the comment.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.participant[typeCode=AUT].role

authorString

There are no (further) constraints on this element

Data Type

authorReference

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

There are no (further) constraints on this element

Data Type

Reference(UK Core Practitioner | UK Core Patient | UK Core RelatedPerson | UK Core Organization)

time

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.note.time

Short description

When the annotation was made

Definition

Indicates when this particular annotation was made.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.effectiveTime

text

1..1

markdown

There are no (further) constraints on this element

Element Id

MedicationRequest.note.text

Short description

The annotation - text content (as markdown)

Definition

The text of the annotation in markdown format.

Comments

Systems are not required to have markdown support, so the text should be readable without markdown processing. The markdown syntax is GFM - see https://github.github.com/gfm/

Data Type

markdown

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Act.text

dosageInstruction

1..*

NHSDigitalDosage

Element Id

MedicationRequest.dosageInstruction

Short description

How the medication is/was taken or should be taken

Definition

The content of the dosageInstruction should follow guidance in Dosage Structure Overview. (Note this is based on CareConnect STU3 but the guidance is still valid in UKCore R4)

dosageInstruction.text MUST be supplied and is a human readable version of the structured dose as would be printed on a paper prescription. The prescriber is required to enter a medication item dosage. The use of a generic default value, for example “Use as directed”, if a value is not entered, is not acceptable from a clinical perspective.

The prescriber is required to enter a medication item dosage. The use of a generic default value, for example “Use as directed”, if a value is not entered, is not acceptable from a clinical perspective. The user must be asked to select a dosage instruction from a pick list, type by hand or have the system populate with a valid and clinically safe dosage instruction relevant to the prescribed medication or clinical circumstances.

As per BNF guidelines, the dosage must be presented to the user without abbreviation although it may be entered and stored within the PMR in an abbreviated form. Within HL7 messaging, the dosage instruction must be represented without abbreviation.

"dosageInstruction": [
   {
        "text": "10 milligram, Inject, Subcutaneous route, once weekly",
        "timing": {
            "repeat": {
                "boundsDuration": {
                    "value": 10,
                    "unit": "day",
                     "system": "http://unitsofmeasure.org",
                     "code": "d"
                },
                 "frequency": 5,
                 "period": 1,
                "periodUnit": "d"
             }
        },
        "route": {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "34206005",
                    "display": "Subcutaneous route"
                }
            ]
        },
        "method": {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "422145002",
                    "display": "Inject"
                }
            ]
        },
        "doseAndRate": [
            {
                "doseQuantity": {
                    "value": 10,
                    "unit": "milligram",
                    "system": "http://unitsofmeasure.org",
                    "code": "mg"
                }
            }
        ]
    }
]

Comments

There are examples where a medication request may include the option of an oral dose or an Intravenous or Intramuscular dose. For example, "Ondansetron 8mg orally or IV twice a day as needed for nausea" or "Compazine® (prochlorperazine) 5-10mg PO or 25mg PR bid prn nausea or vomiting". In these cases, two medication requests would be created that could be grouped together. The decision on which dose and route of administration to use is based on the patient's condition at the time the dose is needed.

Data Type

NHSDigitalDosage

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
workflow:Request.occurrence[x]
rim:see dosageInstruction mapping

sequence

S Σ

0..1

integer

Element Id

MedicationRequest.dosageInstruction.sequence

Short description

Multi-sequence dosage instructions.

Definition

A multi-sequence would be required where a dosage instruction changes over a given time schedule, where a dosage instruction includes optional follow-up doses or where a concurrent dosage instruction is required for the same medication at a different dose.

Examples below include Prednisolone to treat Bell’s palsy where a dose starts at 60 mg per day for a period of time then reduces by 10 mg per day. This would be described as a sequential dosage instruction. A concurrent dosage example is provided to describe a different dose in the morning to that at midday.

Sequential Instructions

Where the value of sequence is an incremental integer it defines a sequential instruction.

Concurrent Instructions

Where the same integer value of sequence is defines it means a concurrent instruction.

Requirements

If the sequence number of multiple Dosages is the same, then it is implied that the instructions are to be treated as concurrent. If the sequence number is different, then the Dosages are intended to be sequential.

Comments

32 bit number; for values larger than this, use decimal

Data Type

integer

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:TQ1-1
rim:.text

text

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.text

Short description

The complete dosage instruction as a human readable string.

Definition

The complete dosage instruction as a human readable string.

Recommendation: Use the translation algorithm published within this guide to create a string from the coded Dosage elements. It is planned for this translation algorithm to be available as an API.

For example;

<text value="1 tablet - every 6 hours - oral" />

Where additional dosage instructions need to be conveyed that cannot be described using any other element of the Dosage structure, then append these to the end of the translated dosage text.

For example, the instruction to “infuse as rapidly as possibly via intraperitoneal port” is not a coded term so cannot be shared as a additionalInstruction. It would neither be appropriate as a patientInstruction string.

For example;

<text value="{the dosage elements translated as text} - infuse as rapidly as possibly via intraperitoneal port" />

For example, the instruction “immediately following drug {X}”), where {X} is the name of a drug, is neither suitable as a additionalInstruction nor patientInstruction.

For example;

<text value="500 milligrams - once - oral - immediately following drug {X}" />

Requirements

Free text dosage instructions can be used for cases where the instructions are too complex to code. The content of this attribute does not include the name or description of the medication. When coded instructions are present, the free text instructions may still be present for display to humans taking or administering the medication. It is expected that the text instructions will always be populated. If the dosage.timing attribute is also populated, then the dosage.text should reflect the same information as the timing. Additional information about administration or preparation of the medication should be included as text.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXO-6; RXE-21
rim:.text

additionalInstruction

S Σ

0..*

Element Id

MedicationRequest.dosageInstruction.additionalInstruction

Short description

Additional dosage instructions that can be either SNOMED-CT coded terms or free-text instructions.

Definition

These sections MUST be used only be used to pass notes regarding the prescription to the pharmacist or patient. Lists of repeat medications and general practice notifications to the patient SHOULD be recorded in NHSDigital-CommunicationRequest resource.

Patient instructions for taking the drug are contained with in the patientInstruction and additionalInstruction as per the guidance in Dosage Structure Overview

"dosageInstruction": [
    {
        "text": "10 milligram, Inject, Subcutaneous route, once weekly",
        "additionalInstruction": [
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "421769005",
                    "display": "Follow directions"
                }
            ],
        ],
        "patientInstruction": "As directed"
    }
]

Requirements

Additional instruction is intended to be coded, but where no code exists, the element could include text. For example, "Swallow with plenty of water" which might or might not be coded.

Comments

Information about administration or preparation of the medication (e.g. "infuse as rapidly as possibly via intraperitoneal port" or "immediately following drug x") should be populated in dosage.text.

Data Type

SNOMEDCTAdditionalDosageInstructions (example)

Binding

A coded concept identifying additional instructions such as "take with water" or "avoid operating heavy machinery".

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXO-7
rim:.text

patientInstruction

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.patientInstruction

Short description

Patient or consumer oriented instructions

Definition

Patient instructions for taking the drug are contained with in the patientInstruction and additionalInstruction as per the guidance in Dosage Structure Overview

"dosageInstruction": [
    {
        "text": "10 milligram, Inject, Subcutaneous route, once weekly",
        "additionalInstruction": [
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "421769005",
                    "display": "Follow directions"
                }
            ],
        ],
        "patientInstruction": "As directed"
    }
]

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXO-7
rim:.text

timing

S Σ

0..1

Timing

Element Id

MedicationRequest.dosageInstruction.timing

Short description

When medication should be administered

Definition

Adding constraints, bounds or limits to a dosage instruction.

Requirements

The timing schedule for giving the medication to the patient. This data type allows many different expressions. For example: "Every 8 hours"; "Three times a day"; "1/2 an hour before breakfast for 10 days from 23-Dec 2011:"; "15 Oct 2013, 17 Oct 2013 and 1 Nov 2013". Sometimes, a rate can imply duration when expressed as total volume / duration (e.g. 500mL/2 hours implies a duration of 2 hours). However, when rate doesn't imply duration (e.g. 250mL/hour), then the timing.repeat.duration is needed to convey the infuse over time period.

Comments

This attribute might not always be populated while the Dosage.text is expected to be populated. If both are populated, then the Dosage.text should reflect the content of the Dosage.timing.

Data Type

Timing

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:QSET<TS> (GTS)
rim:.effectiveTime

event

0..*

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.event

Short description

When the event occurs

Definition

Identifies specific times when the event occurs.

Requirements

In a Medication Administration Record, for instance, you need to take a general specification, and turn it into a precise specification.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:QLIST<TS>

repeat

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat

Short description

When the event is to occur

Definition

A set of rules that describe when the event is scheduled.

Requirements

Many timing schedules are determined by regular repetitions.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
tim-9:If there's an offset, there must be a when (and not C, CM, CD, CV)
offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))
tim-5:period SHALL be a non-negative value
period.exists() implies period >= 0
tim-6:If there's a periodMax, there must be a period
periodMax.empty() or period.exists()
tim-7:If there's a durationMax, there must be a duration
durationMax.empty() or duration.exists()
tim-8:If there's a countMax, there must be a count
countMax.empty() or count.exists()
tim-1:if there's a duration, there needs to be duration units
duration.empty() or durationUnit.exists()
tim-10:If there's a timeOfDay, there cannot be a when, or vice versa
timeOfDay.empty() or when.empty()
tim-2:if there's a period, there needs to be period units
period.empty() or periodUnit.exists()
tim-4:duration SHALL be a non-negative value
duration.exists() implies duration >= 0

Mappings

rim:n/a
rim:Implies PIVL or EIVL

bounds[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.bounds[x]

Short description

Length/Range of lengths, or (Start and/or end) limits

Definition

Either a duration for the length of the timing schedule, a range of possible length, or outer bounds for start and/or end limits of the timing schedule.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:IVL(TS) used in a QSI

boundsDuration

Data Type

boundsRange

Data Type

boundsPeriod

Data Type

count

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.count

Short description

Number of times to repeat

Definition

A total count of the desired number of repetitions across the duration of the entire timing specification. If countMax is present, this element indicates the lower bound of the allowed range of count values.

Requirements

Repetitions may be limited by end time or total occurrences.

Comments

If you have both bounds and count, then this should be understood as within the bounds period, until count times happens.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.count

countMax

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.countMax

Short description

Maximum number of times to repeat

Definition

If present, indicates that the count is a range - so to perform the action between [count] and [countMax] times.

Comments

32 bit number; for values larger than this, use decimal

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.count

duration

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.duration

Short description

How long when it happens

Definition

How long this thing happens for when it happens. If durationMax is present, this element indicates the lower bound of the allowed range of the duration.

Requirements

Some activities are not instantaneous and need to be maintained for a period of time.

Comments

For some events the duration is part of the definition of the event (e.g. IV infusions, where the duration is implicit in the specified quantity and rate). For others, it's part of the timing specification (e.g. exercise).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

durationMax

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.durationMax

Short description

How long when it happens (Max)

Definition

If present, indicates that the duration is a range - so to perform the action between [duration] and [durationMax] time length.

Requirements

Some activities are not instantaneous and need to be maintained for a period of time.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

durationUnit

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.durationUnit

Short description

s | min | h | d | wk | mo | a - unit of time (UCUM)

Definition

The units of time for the duration, in UCUM units.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

A unit of time (units from UCUM).

UnitsOfTime (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase.unit

frequency

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.frequency

Short description

Event occurs frequency times per period

Definition

The number of times to repeat the action within the specified period. If frequencyMax is present, this element indicates the lower bound of the allowed range of the frequency.

Comments

32 bit number; for values larger than this, use decimal

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

frequencyMax

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.frequencyMax

Short description

Event occurs up to frequencyMax times per period

Definition

If present, indicates that the frequency is a range - so to repeat between [frequency] and [frequencyMax] times within the period or period range.

Comments

32 bit number; for values larger than this, use decimal

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

period

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.period

Short description

Event occurs frequency times per period

Definition

Indicates the duration of time over which repetitions are to occur; e.g. to express "3 times per day", 3 would be the frequency and "1 day" would be the period. If periodMax is present, this element indicates the lower bound of the allowed range of the period length.

Comments

Do not use an IEEE type floating point type, instead use something that works like a true decimal, with inbuilt precision (e.g. Java BigInteger)

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

periodMax

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.periodMax

Short description

Upper limit of period (3-4 hours)

Definition

If present, indicates that the period is a range from [period] to [periodMax], allowing expressing concepts such as "do this once every 3-5 days.

Comments

Do not use an IEEE type floating point type, instead use something that works like a true decimal, with inbuilt precision (e.g. Java BigInteger)

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase

periodUnit

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.periodUnit

Short description

s | min | h | d | wk | mo | a - unit of time (UCUM)

Definition

The units of time for the period in UCUM units.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

A unit of time (units from UCUM).

UnitsOfTime (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:PIVL.phase.unit

dayOfWeek

0..*

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.dayOfWeek

Short description

mon | tue | wed | thu | fri | sat | sun

Definition

If one or more days of week is provided, then the action happens only on the specified day(s).

Comments

If no days are specified, the action is assumed to happen every day as otherwise specified. The elements frequency and period cannot be used as well as dayOfWeek.

Data Type

Binding

DaysOfWeek (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a

timeOfDay

0..*

time

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.timeOfDay

Short description

Time of day for action

Definition

Specified time of day for action to take place.

Comments

When time of day is specified, it is inferred that the action happens every day (as filtered by dayofWeek) on the specified times. The elements when, frequency and period cannot be used as well as timeOfDay.

Data Type

time

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a

when

0..*

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.when

Short description

Code for time period of occurrence

Definition

An approximate time period during the day, potentially linked to an event of daily living that indicates when the action should occur.

Requirements

Timings are frequently determined by occurrences such as waking, eating and sleep.

Comments

When more than one event is listed, the event is tied to the union of the specified events.

Data Type

Binding

Real world event relating to the schedule.

EventTiming (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:EIVL.event

offset

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.repeat.offset

Short description

Minutes from event (before or after)

Definition

The number of minutes from the event. If the event code does not indicate whether the minutes is before or after the event, then the offset is assumed to be after the event.

Comments

32 bit number; for values larger than this, use decimal

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:EIVL.offset

code

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.timing.code

Short description

BID | TID | QID | AM | PM | QD | QOD | +

Definition

A code for the timing schedule (or just text in code.text). Some codes such as BID are ubiquitous, but many institutions define their own additional codes. If a code is provided, the code is understood to be a complete statement of whatever is specified in the structured timing data, and either the code or the data may be used to interpret the Timing, with the exception that .repeat.bounds still applies over the code (and is not contained in the code).

Comments

BID etc. are defined as 'at institutionally specified times'. For example, an institution may choose that BID is "always at 7am and 6pm". If it is inappropriate for this choice to be made, the code BID should not be used. Instead, a distinct organization-specific code should be used in place of the HL7-defined BID code and/or a structured representation should be used (in this case, specifying the two event times).

Data Type

TimingAbbreviation (preferred)

Binding

Code for a known / defined timing pattern.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
rim:QSC.code

asNeeded[x]

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.asNeeded[x]

Short description

Take "as needed" (for x)

Definition

The asNeeded structure can be used to define a simple “as required” (or “pro re nata” expressed as “PRN” for those who still prefer to use Latin abbreviations) instructions.

In this case use the asNeededBoolean option. The absence of asNeededBoolean is equivalent to where asNeededBoolean has a value of false.

The asNeededCodeableConcept option is used to bound the dosage instruction to a coded term. Any number of coded terms can be used from the SNOMED-CT hierarchy as a descendant of 404684003 Clinical Finding (finding). An extensive medication-as-needed-reason value-set is defined within FHIR which is a subset of the SNOMED-CT clinical findings hierarchy.

Comments

Can express "as needed" without a reason by setting the Boolean = True. In this case the CodeableConcept is not populated. Or you can express "as needed" with a reason by including the CodeableConcept. In this case the Boolean is assumed to be True. If you set the Boolean to False, then the dose is given according to the schedule and is not "prn" or "as needed".

Binding

A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc.

SNOMEDCTMedicationAsNeededReasonCodes (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:TQ1-9
rim:.outboundRelationship[typeCode=PRCN].target[classCode=OBS, moodCode=EVN, code="as needed"].value=boolean or codable concept

asNeededBoolean

There are no (further) constraints on this element

Data Type

asNeededCodeableConcept

There are no (further) constraints on this element

Data Type

site

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.site

Short description

Body site to administer to

Definition

Any site can be used from the SNOMED-CT hierarchy as a descendant of the concept 123037004 Body structure (body structure).

<!-- Site -->
<site>
    <coding>
        <system value="http://snomed.info/sct"/>
        <code value="59380008"/>
        <display value="Anterior abdominal wall structure"/>
    </coding>
</site>

Requirements

A coded specification of the anatomic site where the medication first enters the body.

Comments

If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension bodySite. May be a summary code, or a reference to a very precise definition of the location, or both.

Data Type

SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (example)

Binding

A coded concept describing the site location the medicine enters into or onto the body.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-2
rim:.approachSiteCode

route

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.route

Short description

How drug should enter body

Definition

Any route can be used from the SNOMED-CT hierarchy as a descendant of the concept 284009009 Route of administration value (qualifier value).

<!-- Route -->
<route>
    <coding>
        <system value="http://snomed.info/sct"/>
        <code value="78421000"/>
        <display value="intramuscular route"/>
    </coding>
</route>

Requirements

A code specifying the route or physiological path of administration of a therapeutic agent into or onto a patient's body.

Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Data Type

Binding

A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.

SNOMEDCTRouteCodes (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-1
rim:.routeCode

method

S Σ

0..1

Element Id

MedicationRequest.dosageInstruction.method

Short description

Technique for administering medication

Definition

The 999000041000001103 ePrescribing method simple reference set (foundation metadata concept) reference set collates the commonly used terms for method for use in the United Kingdom.

Whilst a FHIR value-set for method does exist, together with two separate hierarchies within SNOMED-CT (Dose form administration method and Dosing instruction fragment), it is recommended to use the ePrescribing reference set in the first instance.

<!-- Method -->
<method>
    <coding>
        <system value="http://snomed.info/sct"/>
        <code value="129326001"/>
        <display value="Injection"/>
    </coding>
</method>

Use of synonyms

In most instances it is anticipated that the UK Preferred term should be the term applied to SNOMED CT concepts However for some cases, for example the anatomically correct SNOMED-CT term may not be easily understood by the patient or clinician, the use of a synonym may be preferred.

Guidance for using terms that are not preferred terms is available within the published document Guidance on the use of CodeableConcept.

Requirements

A coded value indicating the method by which the medication is introduced into or onto the body. Most commonly used for injections. For examples, Slow Push; Deep IV.

Comments

Terminologies used often pre-coordinate this term with the route and or form of administration.

Data Type

SNOMEDCTAdministrationMethodCodes (example)

Binding

A coded concept describing the technique by which the medicine is administered.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXR-4
rim:.doseQuantity

doseAndRate

0..*

Element Id

MedicationRequest.dosageInstruction.doseAndRate

Short description

Amount of medication administered

Definition

Dose and Rate elements within the Dosage structure have been combined within the R4 standard, but their underlying use and purpose is the same as per R4.

A dose or rate of medication can be described via one of the following methods. In both instances when considering Units of Measure note that UCUM is preferred.

Sub-element: `Dosage.doseAndRate.doseQuantity`

The amount of medication per dose, as a simple coded quantity.

<!-- Example A: 1 capsule -->
<doseAndRate>
    <doseQuantity>
        <value value="1"/>
        <unit value="capsule"/>
        <system value="http://snomed.info/sct"/>
        <code value="732937005"/>
    </doseQuantity>
</doseAndRate>

<!-- Example B: 30 milligrams -->
<doseAndRate>
    <doseQuantity>
        <value value="30"/>
        <unit value="milligram"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="mg"/>
    </doseQuantity>
</doseAndRate>

Sub-element: `Dosage.doseAndRate.doseRange`

A dose that may be in a given low / high range.

<!-- for a dose between 7.5 to 30 milligram -->
<doseAndRate>
    <doseRange>
        <low>
            <value value="7.5"/>
            <unit value="milligram"/>
            <code value="mg"/>
            <system value="http://unitsofmeasure.org"/>
        </low>
        <high>
            <value value="30"/>
            <unit value="milligram"/>
            <code value="mg"/>
            <system value="http://unitsofmeasure.org"/>
        </high>
    </doseRange>
</doseAndRate>

A rate-based quantity, such as 30 ml per hour, can be expressed as a rateRatio with coded numerator and denominator values.

Where the unit of measure for the ratio is defined within UCUM (see Common UCUM Units), for example, “milliliter per hour”, it can also be expressed using the simpler rateQuantity structure.

Sub-element: `Dosage.doseAndRate.rateRatio`

Where the rate is expressed as coded numerator and denominator values.

at a rate of 30ml/hour using rateRatio

<doseAndRate>
 <rateRatio>
  <numerator>
   <value value="30"/>
   <unit value="millilitre"/>
   <system value="http://unitsofmeasure.org"/>
   <code value="mL"/>
  </numerator>
  <denominator>
   <value value="1"/>
   <unit value="hour"/>
   <system value="http://unitsofmeasure.org"/>
   <code value="h"/>
  </denominator>
 </rateRatio>
</doseAndRate>

Sub-element: `Dosage.doseAndRate.rateQuantity`

Where the unit of measure applicable to a rate is defined within UCUM which is mathematically equivalent to defining the rate using the more complex rateRatio structure.

at a rate of 30ml/hour using rateQuantity

<rateQuantity>
 <value value="30"/>
 <unit value="milliliters per hour"/>
 <system value="http://unitsofmeasure.org"/>
 <code value="mL/h"/>
</rateQuantity>

at a rate of 1mcg/kg/hour using rateQuantity

<doseAndRate>
 <rateQuantity>
  <value value="1"/>
  <unit value="microgram per kilogram per hour"/>
  <system value="http://unitsofmeasure.org"/>
  <code value="ug/kg/h"/>
 </rateQuantity>
</doseAndRate>

Sub-element: `Dosage.doseAndRate.rateRange`

Where the unit of measure applicable to a rate range is defined within UCUM the rateRange structure can be used.

give at 1-2 litres per minute using rateRange

<doseAndRate>
 <rateRange>
  <low>
   <value value="1"/>
   <unit value="liter per minute"/>
   <system value="http://unitsofmeasure.org"/>
   <code value="L/min"/>
  </low>
  <high>
   <value value="2"/>
   <unit value="liter per minute"/>
   <system value="http://unitsofmeasure.org"/>
   <code value="L/min"/>
  </high>
 </rateRange>
</doseAndRate>

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:TQ1-2

type

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.doseAndRate.type

Short description

The kind of dose or rate specified

Definition

The kind of dose or rate specified, for example, ordered or calculated.

Requirements

If the type is not populated, assume to be "ordered".

Comments

Data Type

Binding

The kind of dose or rate specified.

DoseAndRateType (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:RXO-21; RXE-23

dose[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.doseAndRate.dose[x]

Short description

Amount of medication per dose

Definition

Amount of medication per dose.

Requirements

The amount of therapeutic or other substance given at one administration event.

Comments

Note that this specifies the quantity of the specified medication, not the quantity for each active ingredient(s). Each ingredient amount can be communicated in the Medication resource. For example, if one wants to communicate that a tablet was 375 mg, where the dose was one tablet, you can use the Medication resource to document that the tablet was comprised of 375 mg of drug XYZ. Alternatively if the dose was 375 mg, then you may only need to use the Medication resource to indicate this was a tablet. If the example were an IV such as dopamine and you wanted to communicate that 400mg of dopamine was mixed in 500 ml of some IV solution, then this would all be communicated in the Medication resource. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule e.g. 500 ml in dose, with timing used to convey that this should be done over 4 hours.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXO-2, RXE-3
rim:.doseQuantity

doseRange

Data Type

doseQuantity

Data Type

rate[x]

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dosageInstruction.doseAndRate.rate[x]

Short description

Amount of medication per unit of time

Definition

Amount of medication per unit of time.

Requirements

Identifies the speed with which the medication was or will be introduced into the patient. Typically the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time e.g. 500 ml per 2 hours. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours. Sometimes, a rate can imply duration when expressed as total volume / duration (e.g. 500mL/2 hours implies a duration of 2 hours). However, when rate doesn't imply duration (e.g. 250mL/hour), then the timing.repeat.duration is needed to convey the infuse over time period.

Comments

It is possible to supply both a rate and a doseQuantity to provide full details about how the medication is to be administered and supplied. If the rate is intended to change over time, depending on local rules/regulations, each change should be captured as a new version of the MedicationRequest with an updated rate, or captured with a new MedicationRequest with the new rate.

It is possible to specify a rate over time (for example, 100 ml/hour) using either the rateRatio and rateQuantity. The rateQuantity approach requires systems to have the capability to parse UCUM grammer where ml/hour is included rather than a specific ratio where the time is specified as the denominator. Where a rate such as 500ml over 2 hours is specified, the use of rateRatio may be more semantically correct than specifying using a rateQuantity of 250 mg/hour.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:RXE22, RXE23, RXE-24
rim:.rateQuantity

rateRatio

There are no (further) constraints on this element

Data Type

rateRange

Range

There are no (further) constraints on this element

Data Type

Range

rateQuantity

There are no (further) constraints on this element

Data Type

maxDosePerPeriod

S Σ I

0..1

Element Id

MedicationRequest.dosageInstruction.maxDosePerPeriod

Short description

Upper limit on medication per unit of time

Definition

Used to define a maxiumum dose over a given time period.

An example would be a Sumatriptan 6mg injection which can be repeated after an hour but not again over a 24 hour period. The maxDosePerPeriod is defined as 12mg/24hours.

The maxDosePerPeriod is defined for each dosage instruction. For a multi-sequence instruction it would therefore be possible to define different maximum dosing periods within different sequences of the complete instruction.

A real-world example of where this would be required has not yet been identified.

Maximum dose per period of 12mg/24 hour

<maxDosePerPeriod>
    <numerator>
        <value value="12"/>
        <unit value="milligram"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="mg"/>
    </numerator>
    <denominator>
        <value value="24"/>
        <unit value="hour"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="h"/>
    </denominator>
</maxDosePerPeriod>

Requirements

The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time. For example, 1000mg in 24 hours.

Comments

This is intended for use as an adjunct to the dosage when there is an upper cap. For example "2 tablets every 4 hours to a maximum of 8/day".

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
rat-1:Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
(numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

Mappings

rim:n/a
v2:N/A
rim:RTO
v2:RXO-23, RXE-19
rim:.maxDoseQuantity

maxDosePerAdministration

Σ I

0..1

Element Id

MedicationRequest.dosageInstruction.maxDosePerAdministration

Short description

Upper limit on medication per administration

Definition

Used to define a maximum dose for a single administration.

An example would be Anagrelide for which a single dose should not exceed 2.5 mg. The maxDosePerAdministration is defined as 2.5mg.

In many scenarios it is expected that the dosage.doseRange would be used instead of maxDosePerAdministration.

The maxDosePerAdministration is defined for each dosage instruction. For a multi-sequence instruction it would therefore be possible to define different maximum dose administrations within different sequences of the complete instruction.

A real-world example of where this would be required has not yet been identified.

Maximum dose per administration of 2.5mg

<maxDosePerAdministration>
    <value value="2.5"/>
    <unit value="milligram"/>
    <system value="http://unitsofmeasure.org"/>
    <code value="mg"/>
</maxDosePerAdministration>

Requirements

The maximum total quantity of a therapeutic substance that may be administered to a subject per administration.

Comments

This is intended for use as an adjunct to the dosage when there is an upper cap. For example, a body surface area related dose with a maximum amount, such as 1.5 mg/m2 (maximum 2 mg) IV over 5 – 10 minutes would have doseQuantity of 1.5 mg/m2 and maxDosePerAdministration of 2 mg.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:not supported

maxDosePerLifetime

Σ I

0..1

Element Id

MedicationRequest.dosageInstruction.maxDosePerLifetime

Short description

Upper limit on medication per lifetime of the patient

Definition

Used to define the maximum cumulative dose over the lifetime of a patient.

An example would be Daunorubicin which may have a maximum cumulative dose of 600mg/m2 (based on the size of the patient). The maxDosePerLifetime is defined as 600 mg/m2.

The maxDosePerLifetime can be defined for each dosage instruction; which, for a multi-sequence instruction is illogical, as any maxDosePerLifetime is equally applicable to all dosage sequence that relate to the single medication coded concept.

Note: If a maxDosePerLifetime statement is required with a multi-sequence instruction, it is recommended to define it within the last / final sequence to ensure that the information is presented at the end of a the complete instruction, rather than th middle which could be overlooked.

Maximum dose over lifetime of the patient of 600 mg/m2

<maxDosePerLifetime>
    <value value="600"/>
    <unit value="milligram per square metre"/>
    <system value="http://unitsofmeasure.org"/>
    <code value="mg/m2"/>
</maxDosePerLifetime>

Requirements

The maximum total quantity of a therapeutic substance that may be administered per lifetime of the subject.

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:not supported

dispenseRequest

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest

Short description

Medication supply authorization

Definition

Indicates the specific details for the dispense or medication supply part of a medication request (also known as a Medication Prescription or Medication Order). Note that this information is not always sent with the order. There may be in some settings (e.g. hospitals) institutional or system support for completing the dispense details in the pharmacy department.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
script10.6:Message/Body/NewRx/MedicationPrescribed/ExpirationDate
rim:component.supplyEvent

0..0

System.String

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.id

Short description

Unique id for inter-element referencing

Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

Data Type

System.String

Mappings

rim:n/a

extension

1..*

Element Id

MedicationRequest.dispenseRequest.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

performerSiteType

S I

1..1

Element Id

MedicationRequest.dispenseRequest.extension:performerSiteType

Short description

type of dispensing organisation

Alternate names

extensions, user content

Definition

Used to indicate type of pharmacist

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PerformerSiteType

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

initialFill

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.initialFill

Short description

First fill details

Definition

Indicates the quantity or duration for the first dispense of the medication.

Comments

If populating this element, either the quantity or the duration must be included.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:SubstanceAdministration -> ActRelationship[sequenceNumber = '1'] -> Supply

quantity

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.initialFill.quantity

Short description

First fill quantity

Definition

The amount or quantity to provide as part of the first dispense.

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

CommonUCUMCodesForDuration (extensible)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:Supply.quantity[moodCode=RQO]

duration

0..1

DurationBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.initialFill.duration

Short description

First fill duration

Definition

The length of time that the first dispense is expected to last.

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Duration

Binding

Appropriate units for Duration.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
drt-1:There SHALL be a code if there is a value and it SHALL be an expression of time. If system is present, it SHALL be UCUM.
code.exists() implies ((system = %ucum) and value.exists())

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:PQ, IVL<PQ> depending on the values
rim:Supply.effectivetime[moodCode=RQO]

dispenseInterval

0..1

DurationBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.dispenseInterval

Short description

Minimum period of time between dispenses

Definition

The minimum period of time that must occur between dispenses of the medication.

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Duration

Binding

Appropriate units for Duration.

CommonUCUMCodesForDuration (extensible)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
drt-1:There SHALL be a code if there is a value and it SHALL be an expression of time. If system is present, it SHALL be UCUM.
code.exists() implies ((system = %ucum) and value.exists())

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:PQ, IVL<PQ> depending on the values
rim:Supply.effectivetime[moodCode=RQO]

validityPeriod

S I

0..1

Element Id

MedicationRequest.dispenseRequest.validityPeriod

Short description

Time period supply is authorized for

Definition

The validityPeriod attribute defines the validity period for the prescription authorisation. This period must start (the validityPeriod.start) at the date of prescribing and cannot exceed 12 months (the validityPeriod.end). Typically, most repeatable prescriptions will be authorised for a validity period of either 6 or 12 months.

"dispenseRequest": {
          "validityPeriod": {
            "start": "2020-06-10",
            "end": "2020-12-07"
          },
          ...
      }

Requirements

Indicates when the Prescription becomes valid, and when it ceases to be a dispensable Prescription.

Comments

It reflects the prescribers' perspective for the validity of the prescription. Dispenses must not be made against the prescription outside of this period. The lower-bound of the Dispensing Window signifies the earliest date that the prescription can be filled for the first time. If an upper-bound is not specified then the Prescription is open-ended or will default to a stale-date based on regulations.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
script10.6:Message/Body/NewRx/MedicationPrescribed/Refills
rim:effectiveTime

start

Σ I

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.validityPeriod.start

Short description

Starting time with inclusive boundary

Definition

The start of the period. The boundary is inclusive.

Comments

If the low element is missing, the meaning is that the low boundary is not known.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:DR.1
rim:./low

end

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.validityPeriod.end

Short description

End time with inclusive boundary, if not ongoing

Definition

The end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.

Comments

The high value includes any matching date/time. i.e. 2012-02-03T10:00:00 is in a period that has an end value of 2012-02-03.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:DR.2
rim:./high

numberOfRepeatsAllowed

0..1

Element Id

MedicationRequest.dispenseRequest.numberOfRepeatsAllowed

Short description

Number of refills authorized

Definition

The number of repeat issues authorised if specified.
MUST be present where a continuous or continuous-repeat-dispensing is authorised for a defined number of issues.
MUST NOT be specified where the number of repeat issues has not been defined. Therefore, the numberOfRepeats allowed is the total number of allowed issues. See also extension repeatInformation

For continuous orders and continuous-repeat-dispensing with intent=reflex-order (i.e., orders sent from EPS to pharmacists) this MUST be zero. The numberOfRepeatsAllowed in the extension to basedOn can be used to convey this information to inform patients that they need to re-order the medication.

Example for a continuous issue:


"dispenseRequest": {
        "numberOfRepeatsAllowed": 0
    }

Example for a continuous-repeat-dispensing issue with intent of original-order:


"dispenseRequest": {
        "numberOfRepeatsAllowed": 2
    }

This will result in a total of three issues of the medication.

Comments

If displaying "number of authorized fills", add 1 to this number.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
script10.6:Message/Body/NewRx/MedicationPrescribed/Quantity
v2:RXE-12-Number of Refills
rim:repeatNumber

quantity

S I

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity

Short description

Amount of medication to supply per dispense

Definition

The amount that is to be dispensed for one fill.

Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
sqty-1:The comparator is not used on a SimpleQuantity
comparator.empty()

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
script10.6:Message/Body/NewRx/MedicationPrescribed/DaysSupply
v2:RXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
rim:quantity

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity.value

Short description

Numerical value (with implicit precision)

Definition

The value of the measured amount. The value includes an implicit precision in the presentation of the value.

Requirements

Precision is handled implicitly in almost all cases of measurement.

Comments

The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:SN.2 / CQ - N/A
rim:PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value

comparator

Σ ?!

0..0

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity.comparator

Short description

< | <= | >= | > - how to understand the value

Definition

Not allowed to be used in this context

Requirements

Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

How the Quantity should be understood and represented.

QuantityComparator (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:SN.1 / CQ.1
rim:IVL properties

unit

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity.unit

Short description

Unit representation

Definition

A human-readable form of the unit.

Requirements

There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:PQ.unit

system

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity.system

Short description

System that defines coded unit form

Definition

The identification of the system that provides the coded form of the unit.

Requirements

Need to know the system that defines the coded form of the unit.

Comments

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:CO.codeSystem, PQ.translation.codeSystem

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.quantity.code

Short description

Coded form of the unit

Definition

A computer processable form of the unit in some unit representation system.

Requirements

Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.

Comments

The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.

Data Type

CommonUCUMCodesForDuration (extensible)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:PQ.code, MO.currency, PQ.translation.code

expectedSupplyDuration

S I

0..1

DurationBinding

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration

Short description

Days Supply

Definition

The expectedSupplyDuration entity is required for repeat dispensing (repeatable) prescriptions only.

The expectedSupplyDuration element defines the expected duration, in days, of each issue of the prescription. A default value of 28 can be used which must be amendable by the prescriber when required. The value must be an integer value greater than zero. A sensible upper limit validation should be included within the System. If this value is omitted, the Spine will assume a value of 28.

"dispenseRequest": {
          ...
          "expectedSupplyDuration": {
            "value": 28,
            "unit": "days",
            "system": "http://unitsofmeasure.org",
            "code": "d"
          }
      }

Comments

In some situations, this attribute may be used instead of quantity to identify the amount supplied by how long it is expected to last, rather than the physical quantity issued, e.g. 90 days supply of medication (based on an ordered dosage). When possible, it is always better to specify quantity, as this tends to be more precise. expectedSupplyDuration will always be an estimate that can be influenced by external factors.

Data Type

Duration

Binding

Appropriate units for Duration.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
qty-3:If a code for the unit is present, the system SHALL also be present
code.empty() or system.exists()
drt-1:There SHALL be a code if there is a value and it SHALL be an expression of time. If system is present, it SHALL be UCUM.
code.exists() implies ((system = %ucum) and value.exists())

Mappings

rim:n/a
v2:SN (see also Range) or CQ
rim:PQ, IVL<PQ>, MO, CO, depending on the values
rim:PQ, IVL<PQ> depending on the values
script10.6:Message/Body/NewRx/MedicationPrescribed/Substitutions
rim:expectedUseTime

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration.value

Short description

Numerical value (with implicit precision)

Definition

The value of the measured amount. The value includes an implicit precision in the presentation of the value.

Requirements

Precision is handled implicitly in almost all cases of measurement.

Comments

The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:SN.2 / CQ - N/A
rim:PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value

comparator

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration.comparator

Short description

< | <= | >= | > - how to understand the value

Definition

How the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value.

Requirements

Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

How the Quantity should be understood and represented.

QuantityComparator (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:SN.1 / CQ.1
rim:IVL properties

unit

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration.unit

Short description

Unit representation

Definition

A human-readable form of the unit.

Requirements

There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:PQ.unit

system

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration.system

Short description

System that defines coded unit form

Definition

The identification of the system that provides the coded form of the unit.

Requirements

Need to know the system that defines the coded form of the unit.

Comments

see http://en.wikipedia.org/wiki/Uniform_resource_identifier

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:CO.codeSystem, PQ.translation.codeSystem

code

1..1

codeFixed Value

Element Id

MedicationRequest.dispenseRequest.expectedSupplyDuration.code

Short description

Coded form of the unit

Definition

A computer processable form of the unit in some unit representation system.

Requirements

Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.

Comments

The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.

Data Type

Reference(NHSDigitalOrganizationODS)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

Mappings

rim:n/a
v2:(see OBX.6 etc.) / CQ.2
rim:PQ.code, MO.currency, PQ.translation.code

performer

S I

0..1

Element Id

MedicationRequest.dispenseRequest.performer

Short description

Intended dispenser

Definition

For non token based prescriptions the destination pharmacy MUST be recorded in the dispenseRequest.performer.identifier and a identifier reference (not a resource reference) with an ANANA/ODS Code MUST used.

The extension https://fhir.nhs.uk/StructureDefinition/Extension-DM-PerformerSiteType MUST be present.

Patients pharmacy preferences may be sourced from PDS.

Patients pharmacy preferences may be overriden by an 'one-off pharmacy nomination' by populating the dispenseRequest.performer.identifier with the ODS/ANANA code of the destination pharmacy.

"dispenseRequest": {
        "extension":  [
            {
                "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PerformerSiteType",
                "valueCoding": {
                    "system": "https://fhir.nhs.uk/CodeSystem/dispensing-site-preference",
                    "code": "0004"
                }
            },
        ],
        "performer": {
            "identifier": {
                "system": "https://fhir.nhs.uk/Id/ods-organization-code",
                "value": "FX748"
            }
        },

Comments

Data Type

Reference(NHSDigitalOrganizationODS)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
w5:FiveWs.who
rim:.outboundRelationship[typeCode=COMP].target[classCode=SPLY, moodCode=RQO] .participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]

extension

0..*

Element Id

MedicationRequest.dispenseRequest.performer.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

dispensingPractitioner

S I

0..1

Element Id

MedicationRequest.dispenseRequest.performer.extension:dispensingPractitioner

Short description

practitioner who released(/downloaded) the prescription

Alternate names

extensions, user content

Definition

Details of the dispenser who is actioning the MedicationRequest

       "dispenseRequest": { 
                    "performer": {
                        "extension":  [
                            {
                                "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-DispensingPerformer",
                                "valueReference": {
                                    "reference": "urn:uuid:25f3dd9f-5838-44a7-930e-c78ae3ecadd6",
                                    "display": "LOTTIE POTTS"
                                }
                            }
                        ],
                        "identifier": {
                            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
                            "value": "VNE51"
                        },
                        "display": "The Simple Pharmacy"
                    }
                },

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-DispensingPerformer

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

MedicationRequest.dispenseRequest.performer.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/ods-organization-code

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.dispenseRequest.performer.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

substitution

1..1

Element Id

MedicationRequest.substitution

Short description

Any restrictions on medication substitution

Definition

Within UK healthcare, substitution is not the norm and so this element will normally be set to a default of false.

Substitution being set to false is a mandatory requirement for EPS..

Substituition is a mandatory requirement for EPS.

Important Note:

Within UK healthcare, substitution is not the norm so the international FHIR definition where "_If nothing is specified substitution may be done._" does not align with UK healthcare prescribing best practice.

It could be unwise to assume all UK implementations will prevent substitution if not explicitly stated, especially if the same clinical system has been previously implemented outside the UK.

UK Core has profiled this element as MANDATORY and MUST have a default boolean value of false to denote substitution is not allowed.

Allowing substitution

Where substitution to be be allowed, set to true. The inclusion of the coded reason is optional as the valueset defined in FHIR is of limited benefit to UK healthcare.


"substitution": {
        "allowedBoolean": false
    }

Data Type

v3.ActSubstanceAdminSubstitutionCode (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
script10.6:specific values within Message/Body/NewRx/MedicationPrescribed/Substitutions
rim:subjectOf.substitutionPersmission

allowed[x]

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.substitution.allowed[x]

Short description

Whether substitution is allowed or not

Definition

The purpose of this element is to allow the prescriber to dispense a different drug from what was prescribed.

Comments

This element is labeled as a modifier because whether substitution is allow or not, it cannot be ignored.

Binding

Identifies the type of substitution allowed.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
script10.6:specific values within Message/Body/NewRx/MedicationPrescribed/Substitutions
v2:RXO-9-Allow Substitutions / RXE-9-Substitution Status
rim:code

allowedBoolean

Data Type

reason

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.substitution.reason

Short description

Why should (not) substitution be made

Definition

Indicates the reason for the substitution, or why substitution must or must not be performed.

Comments

Data Type

v3.SubstanceAdminSubstitutionReason (example)

Binding

A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
script10.6:not mapped
v2:RXE-9 Substition status
rim:reasonCode

priorPrescription

0..1

Reference(UK Core MedicationRequest)

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription

Short description

An order/prescription that is being replaced

Definition

A link to a resource representing an earlier order related order or prescription.

Comments

Data Type

Reference(UK Core MedicationRequest)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.replaces
script10.6:not mapped
rim:.outboundRelationship[typeCode=?RPLC or ?SUCC]/target[classCode=SBADM,moodCode=RQO]

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.priorPrescription.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

detectedIssue

0..*

Reference(DetectedIssue)

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue

Short description

Clinical Issue with action

Alternate names

Contraindication, Drug Utilization Review (DUR), Alert

Definition

Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient; e.g. Drug-drug interaction, duplicate therapy, dosage alert etc.

Comments

This element can include a detected issue that has been identified either by a decision support system or by a clinician and may include information on the steps that were taken to address the issue.

Data Type

Reference(DetectedIssue)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:.inboundRelationship[typeCode=SUBJ]/source[classCode=ALRT,moodCode=EVN].value

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.detectedIssue.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Reference(NHSDigitalProvenance)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

eventHistory

0..*

Element Id

MedicationRequest.eventHistory

Short description

A list of events of interest in the lifecycle

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.

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.).

Data Type

Reference(NHSDigitalProvenance)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
workflow:Request.relevantHistory
rim:.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.eventHistory.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

Differential from UK Core MedicationRequest

MedicationRequest

Element Id

MedicationRequest

Short description

Ordering of medication for patient or group

Alternate names

Prescription, Order

Definition

Data Type

MedicationRequest

Constraints

dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources
contained.contained.empty()
dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-6:A resource should have narrative for robust management
text.`div`.exists()
dom-5:If a resource is contained in another resource, it SHALL NOT have a security label
contained.meta.security.empty()
eps-1:medication[x] - Only one of medicationReference or medicationCodeableConcept should be provided
(medicationReference.exists() and medicationCodeableConcept.exists().not()) or (medicationReference.exists().not() and medicationCodeableConcept.exists())
eps-5:Extension(responsiblePractitioner) - An identifier or resource reference must be provided
extension('https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner').exists().not() or (extension('https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner').value.reference.exists() or extension('https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner').value.system.exists())
eps-6:Extension repeatInformation is required for continuous, continuous-repeat-dispensing and instalment-dispensing MedicationRequests. It is not required for actue MedicationRequests
(courseOfTherapyType.coding.code.startsWith('acute') and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists().not()) or ((courseOfTherapyType.coding.code.startsWith('continuous') or courseOfTherapyType.coding.code.startsWith('instalment')) and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists())
eps-7:For continuous-repeat-dispensing intent must be reflex-order or original-order
(courseOfTherapyType.coding.code != 'continuous-repeat-dispensing') or ((courseOfTherapyType.coding.code = 'continuous-repeat-dispensing') and ((intent ='original-order') or (intent ='reflex-order')))
eps-8:For instalment-dispensing intent must be instance-order or original-order
(courseOfTherapyType.coding.code != 'instalment-dispensing') or ((courseOfTherapyType.coding.code = 'instalment-dispensing') and ((intent ='original-order') or (intent ='instance-order')))
eps-9:dispenseRequest.numberOfRepeatsAllowed should be populated for continuous, continuous-repeat-dispensing and instalment-dispensing MedicationRequests.
(courseOfTherapyType.coding.code.startsWith('acute')) or ((courseOfTherapyType.coding.code.startsWith('continuous') or courseOfTherapyType.coding.code.startsWith('instalment')) and dispenseRequest.exists() and dispenseRequest.numberOfRepeatsAllowed.exists())
eps-10:For continuous-repeat-dispensing (intent=reflex-order) basedOn must be populated
(courseOfTherapyType.coding.code = 'acute') or (courseOfTherapyType.coding.code = 'continuous') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent !='reflex-order') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent ='reflex-order' and dispenseRequest.exists() and basedOn.exists())
eps-11:For continuous-repeat-dispensing (intent=reflex-order) or continous orders, numberOfRepeatsAllowed must be empty or equal to 0
(courseOfTherapyType.coding.code = 'acute') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent !='reflex-order') or ((courseOfTherapyType.coding.code = 'continuous' or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent ='reflex-order')) and (dispenseRequest.numberOfRepeatsAllowed.exists().not() or (dispenseRequest.numberOfRepeatsAllowed.exists() and dispenseRequest.numberOfRepeatsAllowed = 0)))
eps-12:For continuous issues basedOn should be populated
(courseOfTherapyType.coding.code = 'acute') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing') or (courseOfTherapyType.coding.code = 'continuous' and dispenseRequest.exists() and basedOn.exists())
eps-13:Extension repeatInformation.numberOfPrescriptionsIssued should not be present for continuous-repeat-dispensing that are not intent=reflex-order
(courseOfTherapyType.coding.code != 'continuous-repeat-dispensing') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent='reflex-order') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent!='reflex-order' and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists() and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').extension('numberOfPrescriptionsIssued').exists().not())
eps-14:Extension repeatInformation.numberOfPrescriptionsIssued should be present for continuous-repeat-dispensing that have intent=reflex-order
(courseOfTherapyType.coding.code != 'continuous-repeat-dispensing') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent != 'reflex-order') or (courseOfTherapyType.coding.code = 'continuous-repeat-dispensing' and intent='reflex-order' and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists() and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').extension('numberOfPrescriptionsIssued').exists())
eps-15:Extension repeatInformation.numberOfPrescriptionsIssued is recommend to be present for continuous issues
(courseOfTherapyType.coding.code != 'continuous') or (courseOfTherapyType.coding.code = 'continuous' and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists() and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').extension('numberOfPrescriptionsIssued').exists())
eps-16:Extension repeatInformation.numberOfPrescriptionsIssued should not be present for acute issues
(courseOfTherapyType.coding.code != 'acute') or (courseOfTherapyType.coding.code = 'acute' and extension('https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation').exists().not())

Mappings

rim:Entity. Role, or Act
workflow:Request
script10.6:Message/Body/NewRx
rim:CombinedMedicationRequest

extension

1..*

Element Id

MedicationRequest.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

medicationRepeatInformation

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:medicationRepeatInformation

Short description

Continous and Continuous Repeat Dispensing

Alternate names

extensions, user content

Definition

This extension MUST be present for continuous and continuous-repeat-dispensing therapy types.

Field	Description
numberOfRepeatPrescriptionsIssued	Running total of number of issues made against a repeat authorisation. Including this issue.
~~numberOfRepeatPrescriptionsAllowed~~	Retired. See numberOfRepeatsAllowed
authorisationExpiryDate	The date a repeat prescription authorisation will expire.

"extension": [
  {
       "url": "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationRepeatInformation",
       "extension": [
           {
               "url": "numberOfRepeatPrescriptionsIssued",
               "valueUnsignedInt": 3
           },
           {
               "url": "authorisationExpiryDate",
               "valueDateTime": "2020-08-07"
           }
       ]
   }
]

Comments

Data Type

Extension(Complex)

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

responsiblePractitioner

S I

0..1

Element Id

MedicationRequest.extension:responsiblePractitioner

Short description

Responsible Practitioner for the prescription

Alternate names

extensions, user content

Definition

Must only be populated if the requester can not be responsible for the prescription, i.e. they would not be named as the prescriber on the FP10.

"extension": [
        
    {
        "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner",
        "valueReference": {
            "reference": "urn:uuid:a5acefc1-f8ca-4989-a5ac-34ae36741466",
            "display": "DR SAZ RAZ"
        }
    }
],

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-ResponsiblePractitioner

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

prescriptionEndorsement

S I

0..*

Element Id

MedicationRequest.extension:prescriptionEndorsement

Short description

NHS BSA Prescription Endorsements

Alternate names

extensions, user content

Definition

The codes are contained in the valueset

Code	Display
CC	Contraceptive
FS	Sexual Health
ACBS	Advisory Committee on Borderline Substances. Part XV Drug Tariff
SLS	Selected List Scheme. Part XVIIIB Drug Tariff
AF	Food replacement/food supplement products

"resourceType": "MedicationRequest",
    "extension":  [
      {
          "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionEndorsement",
          "valueCodeableConcept": {
              "coding":  [
                {
                    "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-endorsement",
                    "code": "SLS",
                    "display": "Selected List Scheme"
                }
            ]
        }
    }
  ],

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionEndorsement

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

prescriptionTaskStatusReason

S I

0..*

Extension(Complex)

Element Id

MedicationRequest.extension:prescriptionTaskStatusReason

Short description

Prescription task status reason

Alternate names

extensions, user content

Definition

The status history within EPS is primarily a technical Status and the statusReason will reflect current clinical status of the order.

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionStatusHistory

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

NHSBSAprescriptionType

S I

1..1

Element Id

MedicationRequest.extension:NHSBSAprescriptionType

Short description

NHS BSA Prescription Type

Alternate names

extensions, user content

Definition

The vocabulary for the ‘PrescriptionType’ vocabulary is defined within the NHSBSA Overprint Specification.

The System must populate the ‘PrescriptionType’ attribute for the appropriate combination of prescriber and care setting. Retired codes within this vocabulary must not be used

"extension":  [
    {
        "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionType",
        "valueCoding": {
            "system": "https://fhir.nhs.uk/CodeSystem/prescription-type",
            "code": "1201",
            "display": "Outpatient Homecare Prescriber - Medical Prescriber"
        }
    }
    ]

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-DM-PrescriptionType

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

controlledDrug

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:controlledDrug

Short description

Optional Controlled Drug Extensions

Alternate names

extensions, user content

Definition

Sch.	Code	Signing Legal Requirement	EPS Scope	Expiry Date	Quantity Representation	Repeat Dispensing Allowed	RD 1st Issue Expiry	RD Subsequent Expiry
1	CD1	Invalid to prescribe	Out of scope	N/A	N/A	N/A	N/A
2	CD2	Hand signature or electronic signature	In scope	28 days	Words and Figures	No	N/A	N/A
3	CD3	Hand signature or electronic signature	In scope	28 days	Words and Figures	No	N/A	N/A
4	CD4-1 CD4-2	Hand signature or electronic signature	In scope	28 days	Figures	Yes	28 days	Up to 12 months
5	CD5	Hand signature or electronic signature	In scope	6 Months	Figures	Yes	6 months	Up to 12 months

It is a legal requirement to state the prescribed quantity as words in the quantityWords

{
    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-DM-ControlledDrug",
    "extension": [
        {
            "url": "quantityWords",
            "valueString": "twenty eight"
        },
        {
            "url": "schedule",
            "valueCoding": {
                "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-controlled-drug",
                "code": "CD2",
                "display": "Schedule 2"
            }
        }
    ]
}

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-DM-ControlledDrug

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()
eps-cd1:Extension(controlledDrug) - For schedule 2 or 3 Controlled Drugs, the quantity must be expressed in words
(((extension('schedule').value.code='CD2' and extension('quantityWords').exists()) or (extension('schedule').value.code='CD3' and extension('quantityWords').exists()) or (extension('schedule').value.code != 'CD2' and extension('schedule').value.code != 'CD3')) and extension('scheduled').exists()) or (extension('scheduled').exists().not())

Mappings

rim:n/a
rim:N/A

dispensingInformation

S I

0..1

Extension(Complex)

Element Id

MedicationRequest.extension:dispensingInformation

Short description

For EPS use only

Alternate names

extensions, user content

Definition

This extension is used in continuous-repeat-dispensing prescriptions sent by EPS to dispensing systems to convey information on prior dispensed medications.

"extension":  [
                {
                    "url": "https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation",
                    "extension":  [
                        {
                            "url": "dispenseStatus",
                            "valueCoding": {
                                "system": "https://fhir.nhs.uk/CodeSystem/medicationdispense-type",
                                "code": "0001",
                                "display": "Item fully dispensed"
                            }
                        },
                        {
                            "url": "dateLastDispensed",
                            "valueDateTime": "2018-04-22T09:57:03+00:00"
                        }
                    ]
                }
            ],

Comments

Data Type

Extension(Complex)

Extension URL

https://fhir.nhs.uk/StructureDefinition/Extension-EPS-DispensingInformation

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

1..*

Element Id

MedicationRequest.identifier

Short description

Each MedicationRequest MUST be identified by an Universal Unique Identifiers (UUIDs) with a system of https://fhir.nhs.uk/Id/prescription-order-item-number

Definition

UUID example (for illustration purposes only);

a54219b8-f741-4c47-b662-e4f8dfa49ab6

 "identifier":  [
    {
        "system": "https://fhir.nhs.uk/Id/prescription-order-item-number",
        "value": "a54219b8-f741-4c47-b662-e4f8dfa49ab6"
    }
]

Comments

This is a business identifier, not a resource identifier.

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Request.identifier
script10.6:Message/Header/PrescriberOrderNumber
w5:FiveWs.identifier
v2:ORC-2-Placer Order Number / ORC-3-Filler Order Number
rim:.id

(All Slices)

There are no (further) constraints on this element

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

prescriptionOrderItem

1..1

Element Id

MedicationRequest.identifier:prescriptionOrderItem

Short description

Prescription Order Item

Definition

Unique Id of the MedicationRequest within EPS

Comments

This is a business identifier, not a resource identifier.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim: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]
servd:Identifier
workflow:Request.identifier
script10.6:Message/Header/PrescriberOrderNumber
w5:FiveWs.identifier
v2:ORC-2-Placer Order Number / ORC-3-Filler Order Number
rim:.id

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

MedicationRequest.identifier:prescriptionOrderItem.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/prescription-order-item-number

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.identifier:prescriptionOrderItem.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

status

S Σ ?!

1..1

codeBinding

Element Id

MedicationRequest.status

Short description

active | cancelled | stopped

Definition

A code specifying the current state of the order. Generally, this will be active or completed state.

code	Definition
active	The prescription is 'actionable', but not all actions that are implied by it have occurred yet. It has not been dispensed or filled.
cancelled	The prescription is to be cancelled or it has been cancelled been withdrawn before any administrations have occurred. Prescriptions in the process of being cancelled will be regarded as active until all actions are complete.
stopped	Actions implied by the prescription are to be permanently halted, before all of the administrations occurred. This should not be used if the original order was entered in error
completed	All actions that are implied by the prescription have occurred.

Logical medicationRequest status transitions

Comments

This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

Data Type

medicationrequest Status (required)

Binding

A coded concept specifying the state of the prescribing event. Describes the lifecycle of the prescription.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
workflow:Request.status
script10.6:no mapping
w5:FiveWs.status
rim:.statusCode

statusReason

0..1

CodeableConceptBinding

Element Id

MedicationRequest.statusReason

Short description

Reason for current status

Definition

This is generally only used for exception statuses such as suspended or cancelled. It is the clinical status reason for the cancellation.

This is mandatory for 'prescription-order-update' messages.

"statusReason": {
    "coding": [
        {
            "system": "https://fhir.nhs.uk/CodeSystem/medicationrequest-status-reason",
            "code": "0001",
            "display": "Prescribing Error"
        }
    ]
},

Comments

This is generally only used for "exception" statuses such as "suspended" or "cancelled". The reason why the MedicationRequest was created at all is captured in reasonCode, not here.

Data Type

MedicationRequestStatusReason (required)

Binding

Identifies the reasons for a given status.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
workflow:Request.statusReason
rim:.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde

coding

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

MedicationRequest.statusReason.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type