--- title: "ORU R01 - (Send Measurements)" canonical: "https://wiki.patientsknowbest.com/space/api/4718755841/ORU%20R01%20-%20(Send%20Measurements)" format: markdown --- > Macro (toc) # ORU R01: Send Test Measurements To PKB ## Overview This message can be used to send measurements, [pathology results ](https://pkbdev.atlassian.net/wiki/spaces/api/pages/4718624811/Pathology+Results?atlOrigin=eyJpIjoiMmZmNTY4YTJiYWQxNDU4MWJhYjhkNGU4YTE4NTYxOTIiLCJwIjoiYyJ9)and [radiology reports](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3364848898/Radiology+Reports?atlOrigin=eyJpIjoiNDc2YWVhMzRlYjFhNDI5NDgzZmQ2ODhhMmFiYTM5OTEiLCJwIjoiYyJ9) to PKB, but the below will focus on the requirements for measurement data. Measurements The ORU R01 can be used to send measurements into PKB, such that they appear in the "Measurements" tab in the PKB web interface. Please speak to us if you would like to do this, as you'll need to send [pre-agreed SNOMED code values](https://pkbdev.atlassian.net/wiki/spaces/api/pages/4717445327/Measurements+supported+via+HL7?atlOrigin=eyJpIjoiOTFiYjdiNTZiOTE5NDQxMmEwNDZkNDU4MGRjYmNjZWIiLCJwIjoiYyJ9) in OBX-3.1. Any OBX-3.3 that specifies SNOMED CT (see table for exact values we match on) will be treated as a measurement, not a lab result, providing that one of our predefined measurement types matches on both: - the ID in OBX-3.1 - the unit in OBX-6.2 (or else OBX-6.1 if OBX-6.2 was not provided)
Content patterns A "content pattern" indicates how PKB will interpret the contents of your message. This provides additional guidance over and above the syntactic requirements of individual segments. PKB supports two different content patterns for OBR groups. When a (non-radiology) report is received, we will inspect each OBR group to determine which content pattern has been provided. Collection of individual measurements It is assumed an OBR group contains a collection of individual measurements, each of which is provided in its own OBX segment (with the exception of multi-valued measurements, such as blood pressure). The test code information for an individual measurement is taken from the OBX segment (OBX-3). Measurements are considered to be meaningful even outside the context of the report in which they were provided. Comments are not saved for measurements. PKB processes content of this form in an OBX-centric manner. That is, PKB extracts the measurements from the report and does not guarantee to display them alongside the other test results and measurements with which they were originally provided. It is valid to provide more than one measurement for the same measurement type (as identified by OBX-3) within any given OBR group. All such measurements will be processed.
## Relevant Entities - Measurement information is used to populate[ [[Measurement]]](https://wiki.patientsknowbest.com/space/api/3743186970/Entity%3A+Measurement) entities Please click through to the[ ](http://www.google.com/url?q=http%3A%2F%2Fdev.patientsknowbest.com%2Fhome%2Fdata-model&sa=D&sntz=1&usg=AOvVaw3H4dk1Ql5ZGfvclmnuHM_Y)[Data Model](https://wiki.patientsknowbest.com/space/api/3363700789/Data+Model) to explore the presentation of these entities in the web interface.
Update Behaviour **Summary** - you can not update a previously sent measurement but you can delete them **[[Measurement Report]]** Matched on: [[Measurement Report.External ID]] as derived from ORC-3.1 or OBR-3.1 When matched: Unlike lab results, measurements in a report are not individually matched for corrections. However, similar to lab reports, if a panel has status R, then any measurements with a matching report ID will be deleted. When not matched: New [[Measurement Report]] created. **[[Measurement]]** Matched on: There is no unique identifier on a [[Measurement]] submitted via HL7, so they cannot be updated individually. When matched: N/A When not matched: New [[Measurement]] created.
## Definition | **Segment** | **Field** | **Opt** | **RP/#** | **Component** | **Description** | **Example** | **Data Model** **(Measurements)** | | --- | --- | --- | --- | --- | --- | --- | --- | | **MSH** | | | | | Message header. This conforms to PKB's [standard definition](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365012972). | | | | **PID** | | | | | Patient identification. This conforms to PKB's [standard definition](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364849216). | | | | **OBR** | | | | | Observation request | | | | | OBR-3 | **C** | | | Filler order number.
OBR-3.1 must be provided if providing multiple measurements. | | | | | | | | OBR-3.1 | Filler order number | MYORDER0001 | [[Measurement Report.External ID]] | | | OBR-16 | O | | | Ordered by.
If present, at least the family name must be given. | | [[Measurement->Source.Source Text]] | | | | | | OBR-16.2 | Family name | Foster | | | | | | | OBR-16.3 | Given name | John | | | | | | | OBR-16.4 | Middle names | Harry | | | | | | | OBR-16.6 | Title | Dr | | | | OBR-25 | O | | | Result status.
If a value of R is provided: any measurements received previously for this report ID will be marked as deleted. OBX segments are not required and will be ignored. Otherwise: the report is processed as documented. | | | | | | | | OBR-25.1 | Result status | F | | | **{** **OBX** | | | | | Observation or result | | | | | OBX-2 | **R** | | | Value type.
OBX segments that contain a value type other than NM are silently ignored: | | | | | | | | OBX-2.1 | Value type | NM | | | | OBX-3 | **R** | | | Observation identifier. See our [notes on code sets](#) for more information on our handling of coded data. | | | | | | | | OBX-3.1 | Test ID.
This ID must match one of the predefined values which PKB can accept. | 107647005 | | | | | | | OBX-3.3 | Test coding system
PKB will only accept a measurement if this value is one of the following:
( sct, snomed-ct, snomed ct, [http://snomed.info/sct](http://snomed.info/sct), 2.16.840.1.113883.6.96 ) | sct | | | | OBX-5 | **C** | | | Observation value. OBX-5.1 must be a number | | | | | | | | OBX-5.1 | Value | 200 | [[Measurement.Value]]
If a multi-valued measurement is being supplied, then the next OBX segment will contain the value for
[[Measurement.Value2]] | | | OBX-6 | O | | | Units. See our [notes on code sets](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365012136) for more information on our handling of coded data. | | | | | | | | OBX-6.1 | Unit ID | X10TO9L | Used instead of OBX-6.2 if OBX-6.2 was not provided. | | | | | | OBX-6.2 | Unit name. | 10 to 9 per L | This must match the corresponding PKB permitted value. | | | OBX-11 | **R** | | | Result status. Only values of F and C will be processed. Values of I, O, P or X (which indicate pending or no results) are silently ignored, whilst any other values will cause an error. | | | | | | | | OBX-11.1 | Result status | F | | | | OBX-14 | **C** | | | Observation timestamp.
If this is not present, OBR-7 is used instead. It is an error for neither to be provided. | | | | | | | | OBX-14.1 | Observation timestamp | 201505191657 | [[Measurement.Timestamp]] | ## Examples Two examples of a single measurement message. > MSH|^~\&|Corepoint|TDL|HL7API|PKB|201303080949||ORU^R01|ABC0000000001|P|2.4 > > PID|||9999999999^^^NHS^NH||Smith^John^Joe^^Mr||19700101|M|||Flat name^1, The Road^London^London^SW1A 1AA^GBR||01234567890^PRN~07123456789^PRS|^NET^^john.smith@company.com~01234098765^WPN||||||||||||||||N| > > OBR|1||||||||||||||||||||||||F > > OBX|1|NM|107647005^^sct||75|^kg^|||||F|||20200625103943+0100 > MSH|^~\&|Corepoint|TDL|HL7API|PKB|201303080949||ORU^R01|ABC0000000001|P|2.4 > > PID|||9999999999^^^NHS^NH||Smith^John^Joe^^Mr||19700101|M|||Flat name^1, The Road^London^London^SW1A 1AA^GBR||01234567890^PRN~07123456789^PRS|^NET^^john.smith@company.com~01234098765^WPN||||||||||||||||N| > > OBR||||||||||||||||^Ward^Olivia^Elsie^^Ms|||||||||F > > OBX||NM|162986007^^sct||7|^bpm|||||F|||20200401140103+0100 An example of a multi measurement message. > MSH|^~\&|Corepoint|TDL|HL7API|PKB|201303080949||ORU^R01|ABC0000000001|P|2.4 > > PID|||9999999999^^^NHS^NH||Smith^John^Joe^^Mr||19700101|M|||Flat name^1, The Road^London^London^SW1A 1AA^GBR||01234567890^PRN~07123456789^PRS|^NET^^john.smith@company.com~01234098765^WPN||||||||||||||||N| > > OBR|||MYORDER0001|||||||||||||^Ward^Olivia^Elsie^^Ms|||||||||F > > OBX||NM|75367002^^sct|||-|||||F|||20191106091410+0000 > > OBX||NM|163030003^^sct||190|^mmHg (systolic)|||||F|||20191106091410+0000 > > OBX||NM|163031004^^sct||59|^mmHg (diastolic)|||||F|||20191106091410+0000 ## Response PKB will respond with a [standard HL7 acknowledgement](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364848470). ## Supported Single Measurements > Macro (excerpt) > > | | | | > | --- | --- | --- | > | **Snomed code** | **Label** | **Units** | > | 366162006 | Central venous pressure (CVP) | cmH20 | > | 107647005 | Weight | kg | > | 162755006 | Height | cm | > | 276361009 | Waist size | cm | > | 301338002 | Head circumference | cm | > | 301898006 | Body surface area | square metres | > | 301331008 | Body mass index (BMI) | kg/m^2 | > | 170804003 | Ideal body weight | kg | > | 162986007 | Pulse | bpm | > | 162913005 | Respiration | rpm | > | 105723007 | Temperature | degrees Celsius | > | 1036631000000109 | Musculoskeletal Health Questionnaire (MSK-HQ) score | | > | 431314004 | Oxygen saturation (SPO2) | % | > | 257733005 | Activity (Rating Scale: 0-10) | | > | 415882003 | Axillary (under arm) temperature | degrees Celsius | > | 15527001 | Capillary filling | Seconds | > | 251843005 | Fluid output from drain | ml | > | 366156001 | Peak expiratory flow (PEF) | l/min | > | 313222007 | Forced expiratory volume in one second/Forced vital capacity percent (FEV1/FVC) | | > | 59328004 | Forced expiratory volume in 1 second (FEV1) | Litres | > | 366151006 | Forced vital capacity (FVC) | Litres | > | 873921000000106 | Forced expired volume in 6 seconds (FEV6) | Litres | > | 251932003 | Forced expiratory flow rate between 25 and 75% of vital capacity (FEF 25-75) | l/min | > | 273648008 | Nine hole peg test | Seconds | > | 414059009 | Number of missed medications today | | > | 786441000000107 | Grip strength - left hand | kg | > | 786451000000105 | Grip strength - right hand | kg | > | 78564009 | Heart rate measured at systemic artery | beat/min | > | 1091811000000102 | Diastolic arterial pressure | mmHg | > | 72313002 | Systolic arterial pressure | mmHg | > | 810931000000108 | QRISK2 calculated heart age | year | > | 718087004 | QRISK2 cardiovascular disease 10 year risk score | % | > | 1325531000000102 | QRISK3 healthy heart age | years | > | 1085871000000105 | QRISK3 10 year cardiovascular disease risk score | % | > | 1082641000000106 | Alcohol units consumed per week | u/week | > | 230085005 | Beer intake | u/week | > | 230086006 | Wine intake | u/week | > | 230088007 | Spirits intake | u/week | > | 442547005 | Alcohol units heaviest day | /day | > | 230056004 | Cigarette consumption | /day | > | 230057008 | Cigar consumption | /day | > | 230058003 | Pipe tobacco consumption | g/week | > | 413173009 | Minutes from waking to first tobacco consumption | min | > | 836001000000109 | Waterpipe tobacco consumption | times/week | > | 401070008 | Number portions fruit/veg daily | /day | > | 129006008 | Steps | | > | 1155968006 | Mood | | ## Supported Multi Measurements > Macro (excerpt) > > When providing a blood pressure reading you must provide an OBX segment containing the SNOMED code of the overall reading type, followed immediately by an OBX segment for each component reading you wish to provide. > > Note that it is permitted to provide either a systolic or diastolic reading by itself, but the first OBX containing the overall code of the reading must still be supplied. > > | | | | > | --- | --- | --- | > | **SNOMED code** | **Label** | **Units** | > | 75367002 | Blood pressure | | > | 163035008 | Blood pressure sitting | | > | 163034007 | Blood pressure standing | | > | 163033001 | Blood pressure supine | | > | 163030003 | | mmHg (systolic) | > | 163031004 | | mmHg (diastolic) | > > ###