We can provide simple, seamless integration tools to help your developers link your EMR or PBM (pharmacy solution) to the ubeRNote platform. 

Using REST-like APIs, you can complete your integration in two steps:

  • Push your current patient demographics and medication profiles to ubeRNote
  • Pull ubeRNote charting notes back into your EMR


Our REST API examples below are formatted using JSON; however, you may also use XML if needed.

You will need an API Key for your organization in order to authenticate. Please contact your Total Triage account manager to acquire one.

These APIs can be contacted up to once every 5 minutes, as needed.


Synchronize Your Patients' Demographics


POST your active patient demographics using the following message template to https://ahtapitest.total.care/patientupload/{YOUR_API_KEY}


*NOTE: we ask for all ACTIVE patients (those currently on service) in the initial "historical load" to synchronize our systems.  Once that has been completed, depending on the reporting capabilities of your system, you will schedule/automate the ongoing reports according to one of the following options:

    1. Scheduled BATCH messages, including all Active patients and any recently-Discharged patients (Discharge date within past 48 hours), or

    2. Scheduled BATCH messages, including newly-Active/Admitted patients, all recently-Discharged patients (Discharge date within past 48 hours), AND all recently-modified patient records, or

    3. Real-time patient/ADT message updates.


[

  { /***All fields are REQUIRED unless otherwise specified****/

   "Organization_Id": null, ////OPTIONAL - Integer. This is the uniqueID for the organization within ubeRNote. It is only needed when one interfacechannel is built to cover multiple offices/sites; message(s) need only includenomenclature or unique identifier for each office/site that can be used to mapto the appropriate organization(s) within ubeRNote.

   "Internal_Id": null, //Integer. This is the ubeRNote unique patientidentifier - new patients added to our database will have ID created oninsertion.  For existing clients of Total Triage (where patients arealready in ubeRNote), patients will need to be mapped to existing records, mostlikely using the patient MRN value.

   "EMR_Id": "", //Local EMR unique identifier (from yourEMR). If you don’t have one, you can reuse the MRN value in this field.

   "MRN": "",

   "First_Name": "",

   "Last_Name": "",

   "DOB": "", //DateTime

   "SOC_Date": "", //Admit Date - DateTime

   "Discharge_Date": "", ////OPTIONAL - DateTime

   "Diagnosis": "", //Icd10Code format.  Do  notinclude diagnosis description, only the code.

   "CodeStatus": "", ////OPTIONAL - Possible Values:"None", "DNR", "Full Code"

   "Gender": "", // "M", "F","U"

   "Status": "", //Possible Values: "Admitted","Deceased", "Discharged", "Pending", "Not onService", "Referral"

   "Active": 1, //Whether the patient is archived or not. Possible Values: 1 (active; not archived), 0 (archived).  (NOTE: We ask our clients to wait to archive patients until at least 1-2 months after their discharge date, as it is extremely helpful for our nurses to view the discharge date and any important activity history stored for that patient should a call come in after they are discharged.)

   "Service_Area": "", //Possible Values: "HospiceCare", "Home Health Care", "Palliative Care / MCCM","Clinic / Primary Care", "Other Service", "PediatricHospice", "Pediatric Care", "Unspecified"

   "Area_Name": "" ////OPTIONAL - Text.  This is used toidentify patients’ associated areas/teams, as it relates internally to theclient, if the client uses such identifiers (i.e. North Team, South Team)

   "Allergies": "", ////OPTIONAL

   "Notes": "", ////OPTIONAL

   "Alerts": "", ////OPTIONAL - Text.  Anything importantregarding the patient Total Triage nurses should be aware of.

   "Contact_Facility_Name": "", ////OPTIONAL (if available)

   "Contact_Street": "", 

   "Contact_City": "",

   "Contact_State": "", //2-character abbreviation

   "Contact_Zip_Code": "",

   "Contact_Phone": "",

   "Contact_Primary_Contact_Name": "",

   "Contact_Primary_Contact_Phone": "",

   "Contact_Physician_Name": "",

   "Contact_Physician_Phone": "",

   "Contact_Pharmacy_Name": "", ////OPTIONAL

   "Contact_Pharmacy_Phone": "" ////OPTIONAL

   "DME": "", ////OPTIONAL

   "DME_phone": "", ////OPTIONAL

   "Case_Manager_First_Name": "",

   "Case_Manager_Last_Name": "",

   "Case_Manager_Phone": "", ////OPTIONAL

   "Case_Manager_Phone2": "", ////OPTIONAL

   "Case_Manager_Email": "" ////OPTIONAL

   }

 ]


Synchronize Your Patients' Medications


POST your patients' medications using the following template to https://ahtapitest.total.care/MedicationsUpload/{PATIENT_EMR_ID}/{YOUR_API_KEY}/{FALSE or TRUE}


*NOTE: Patient_EMR_ID (in the API link) is the value listed as patient's EMR_ID in patient message (used for mapping to appropriate patient record in our system)


Parameters in blue are optional. If nothing is provided, TRUE is assumed, as it is the least-common denominator option.



  • If FALSE is provided at the end of the above API endpoint, records will be merged if possible based on medication ID. Existing patient medications will not be removed (if no Medication_EMR_Id is provided) or discontinued (if Medication_EMR_Id is provided), unless the medication associated with that ID is updated with an appropriate 'End_Date.'
  • If TRUE is provided, records will be discontinued (with an assumed end_date) and replaced. New medication messages sent will be viewed as the "current" active medication list, and any existing medication orders listed in the system that are not included in the new message will be marked as Discontinued with TODAY() as the medication 'End_Date.'  This is recommended where no Medication_EMR_Id is provided.

[

    {

"EMR_Id": 0 //Unique patient identifier from your EMR, must be same value used in the patient message (which may be patient's MRN); this will be used to map the medication order to the appropriate patient record in our system.

"EMRMedicationId": 0 ////OPTIONAL but strongly recommended; Integer - Unique medication identifier from your EMR for the medication record. If provided, a record update will be attempted with each message sent.

"Name": "",

"Dose": "",

"Route": "",

"Frequency": "",

"Indication": "",

"Start_Date": null, //Datetime field

"End_Date": null, ////OPTIONAL - Datetime field

"Covered": "", ////OPTIONAL - specific to Hospice Care; identifies if medication is covered by Hospice (i.e. Y or N)

"Ordering_MD_Name": "",

"Notes": "", ////OPTIONAL

"Generic_Name": "", ////OPTIONAL

"Special_Instructions": "" ////OPTIONAL

}

]


Pull ubeRNote clinical 'Nursing Notes' back into your EMR


GET charting notes from https://ahtapitest.total.care/ActivitiesDownload/{YOUR_API_KEY}/{LeavePending}/{StartDate}/{EndDate}


Parameters in blue are optional.

  • If TRUE is provided for LeavePending, pending activities will be left on the server as pending (this is primarily for testing). You should exclude this parameter, or set it to FALSE, when used in production as this will guarantee that activities are only downloaded once.
  • If a StartDate is provided, the endpoint will return all activities (through the EndDate, if included, or through TODAY() if omitted) regardless of the notes' new/pending status.


[

  {
    "internal_Id": 0, //ubeRNote internal activity ID
    "nurse_Id": 0, //Internal ubeRNote nurse ID
    "nurse_Name": "",
    "nurse_Credentials": "",
    "patient_Id": 0, //ubeRNote internal patient ID
    "patient_EMR_Id": "", //Identifier for patient in your EMR (based on the patient ID that is present in your patient roster)
    "patient_MRN": "", //MRN
    "patient_DOB": "", //Date
    "patient_First_Name": "",
    "patient_Last_Name": "",
    "activity_Id": 0, //ubeRNote internal activity ID
    "activity_Action_Id": 0, //ubeRNote internal action ID
    "activity_Action": "",
    "call_Code": "",
    "call_Code_Id": 0,
    "diagnosis": "", //Icd10Code
    "service_Name": "",
    "formatted_Notes": "", //All charting notes
    "activity_Messages": "",
    "digital_Signature": "Electronically Signed By Stephanie Allen, RN",
    "activity_Time": "", //DateTime
    "activity_Time_String": "", //String-formatted DateTIme
    "processed_Date": null, //Date that the charting notes were made available for download
    "aht_Input_Date": "", //DateTime that the charting notes were input by Total Triage staff
    "record_Transfer_Date": "" //DateTime that the charting notes were downloaded
  }
]