EMR Integration

Integrating BiliRecs into your Electronic Medical Record (EMR) is fairly simple. A programmed weblink embedded in the EMR launches the webpage, directly importing the infant's current total serum bilirubin level and post-menstrual age at time of sampling. No protected health information is transmitted. The webpage opens directly to the treatment recommendation for the patient's age.

Integration is accomplished by passing the required data to the BiliRecs website via a query string. BiliRecs can alternatively accept the same data fields via HTTP POST, if preferred, however "source" must still be passed as a query parameter. Below is the template for that query string and a description of each of the fields:

hours:
The patient's age, specified in hours, at the time of blood sampling
total:
The laboratory observation for Total Serum Bilirubin
source:
An identifier indicating your organization (used to keep track of who is using the site)
gestAge:
(Optional) The gestational age of the patient, specified in weeks
Defaults to 40 if not passed
units:
(Optional) The units of measure, set to "us" for milligrams per deciliter (mg/dl) or "si" for metric units of micromoles per litre (µmol/L)
Defaults to "us" if not passed

dob:
The patient's date and time of birth
time:
The date and time of blood sampling
total:
The laboratory observation for Total Serum Bilirubin
source:
An identifier indicating your organization (used to keep track of who is using the site)
gestAge:
(Optional) The gestational age of the patient, specified in weeks
Defaults to 40 if not passed
units:
(Optional) The units of measure, set to "us" for milligrams per deciliter (mg/dl) or "si" for metric units of micromoles per litre (µmol/L)
Defaults to "us" if not passed

The date of birth and sample times can be passed in most common date formats, such as "MM/DD/YYYY HH:MM:SS", "YY-MM-DD HH:MM", "YYYY-MM-DD HH:MM:SS", etc. Note that if using two digit years the format "XX/XX/XX" (slashes) will be treated as "MM/DD/YY", while "XX-XX-XX" (dashes) will come out as "YY-MM-DD". Unix Timestamps are accepted as well. If an invalid format is passed, an error message will be generated and processing will stop.

Optionally, you may pass multiple hours/time and total fields as arrays to have BiliRecs display the trend over time of the patient's Total Serum Bilirubin levels. The recommendation will be based upon the most recent measurement. Refer to the last example below to see how this is achieved.

Examples

For a patient with an age of 100 hours and a Total Serum Bulirubin of 13.5 mg/dL, the URL would be: 

https://bilirecs.stanfordchildrens.org/?hours=100&total=13.5&source=DEMO

For a patient with a known DOB and sample time and a Total Serum Bulirubin of 256 µmol/L, the URL would be: 

https://bilirecs.stanfordchildrens.org/?dob=2020-01-01 12:17&time=2020-01-05 16:12&total=256&gestAge=36&units=si&source=DEMO

For a patient with a known DOB and sample times and a current Total Serum Bulirubin of 10.6 mg/dL, the URL to show their trend over time would be: 

https://bilirecs.stanfordchildrens.org/?dob=03/10/2020 15:12:17&gestAge=39&time[1]=03/13/2020 10:56:43&total[1]=16&time[2]=03/14/2020 03:36:23&total[2]=16.2&time[3]=03/14/2020 22:36:23&total[3]=12&time[4]=03/15/2020 02:32:49&total[4]=10.6&source=DEMO
© 2024 STANFORD MEDICINE CHILDREN'S HEALTH