Quick Start Guide: Transition Care Between Facilities

In this guide we will go over the steps necessary for your app to support transitions of care from one facility to another. We will also go over what this workflow will enable your application to do and how you’ll need to configure your application to support it.

Prior to getting started, you’ll want to:

What is Transition of Care Between Facilities?

When a patient moves from under the care of one provider to another your app must identify when there is a transition and send the EHR a handoff report back. This means your app must be capable of two things:

  1. Receiving Order or PatientAdmin data from a healthcare organization to identify which patients are transitioning care.
  2. Sending Media, Notes, or structured ClinicalSummary data to a healthcare organization in order to share the patient’s information.

Receiving Patient Transfer Data

To receive PatientAdmin data from a healthcare organization using Redox, you’ll need to have and endpoint for your application set up as a Destination. Your destination should be able to receive and handle JSON in our PatientAdmin data model. Below is an example of the sort of message you will be receiving. You test sending data to your Destination using DevTools in your Redox Dashboard.

{
   "Meta": {
      "DataModel": "PatientAdmin",
      "EventType": "Discharge",
      "EventDateTime": "2020-11-05T19:32:15.691Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Patient": {
      "Identifiers": [
         {
            "ID": "0000000001",
            "IDType": "MR"
         },
         {
            "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
            "IDType": "EHRID"
         },
         {
            "ID": "a1d4ee8aba494ca",
            "IDType": "NIST"
         }
      ],
      "Demographics": {
         "FirstName": "Timothy",
         "MiddleName": "Paul",
         "LastName": "Bixby",
         "DOB": "2008-01-06",
         "SSN": "101-01-0001",
         "Sex": "Male",
         "Race": "White",
         "IsHispanic": null,
         "MaritalStatus": "Married",
         "IsDeceased": null,
         "DeathDateTime": null,
         "PhoneNumber": {
            "Home": "+18088675301",
            "Office": null,
            "Mobile": null
         },
         "EmailAddresses": [],
         "Language": "en",
         "Citizenship": [],
         "Address": {
            "StreetAddress": "4762 Hickory Street",
            "City": "Monroe",
            "State": "WI",
            "ZIP": "53566",
            "County": "Green",
            "Country": "US"
         }
      },
      "Notes": [],
      "Contacts": [
         {
            "FirstName": "Barbara",
            "MiddleName": null,
            "LastName": "Bixby",
            "Address": {
               "StreetAddress": "4762 Hickory Street",
               "City": "Monroe",
               "State": "WI",
               "ZIP": "53566",
               "County": "Green",
               "Country": "US"
            },
            "PhoneNumber": {
               "Home": "+18088675303",
               "Office": "+17077543758",
               "Mobile": "+19189368865"
            },
            "RelationToPatient": "Mother",
            "EmailAddresses": [
               "[email protected]"
            ],
            "Roles": [
               "Emergency Contact"
            ]
         }
      ],
      "Diagnoses": [
         {
            "Code": "R07.0",
            "Codeset": "ICD-10",
            "Name": "Pain in throat",
            "Type": null,
            "DocumentedDateTime": null
         }
      ],
      "Allergies": [
         {
            "Code": "7982",
            "Codeset": "RxNorm",
            "Name": "Penicillin",
            "Type": {
               "Code": null,
               "Codeset": null,
               "Name": null
            },
            "OnsetDateTime": null,
            "Reaction": [
               {
                  "Code": "28926001",
                  "Codeset": "SNOMED CT",
                  "Name": "Rash"
               },
               {
                  "Code": "247472004",
                  "Codeset": "SNOMED CT",
                  "Name": "Hives"
               }
            ],
            "Severity": {
               "Code": null,
               "Codeset": null,
               "Name": null
            },
            "Status": null
         }
      ],
      "PCP": {
         "NPI": "4356789876",
         "ID": "4356789876",
         "IDType": "NPI",
         "FirstName": "Pat",
         "LastName": "Granite",
         "Credentials": [
            "MD"
         ],
         "Address": {
            "StreetAddress": "123 Main St.",
            "City": "Madison",
            "State": "WI",
            "ZIP": "53703",
            "County": "Dane",
            "Country": "USA"
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": "+16085551234"
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      }
   },
   "Visit": {
      "VisitNumber": "1234",
      "AccountNumber": null,
      "PatientClass": "Inpatient",
      "VisitDateTime": "2020-11-05T19:32:16.621Z",
      "Duration": 15,
      "Reason": "Check up",
      "Instructions": [],
      "Balance": null,
      "DiagnosisRelatedGroup": null,
      "DiagnosisRelatedGroupType": null,
      "AttendingProvider": {
         "ID": "4356789876",
         "IDType": "NPI",
         "FirstName": "Pat",
         "LastName": "Granite",
         "Credentials": [
            "MD"
         ],
         "Address": {
            "StreetAddress": "123 Main St.",
            "City": "Madison",
            "State": "WI",
            "ZIP": "53703",
            "County": "Dane",
            "Country": "USA"
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": "+16085551234"
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "ConsultingProvider": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
            "StreetAddress": null,
            "City": null,
            "State": null,
            "ZIP": null,
            "County": null,
            "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": null
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "ReferringProvider": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
            "StreetAddress": null,
            "City": null,
            "State": null,
            "ZIP": null,
            "County": null,
            "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": null
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "AdmittingProvider": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
            "StreetAddress": null,
            "City": null,
            "State": null,
            "ZIP": null,
            "County": null,
            "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": null
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "Location": {
         "Type": "Inpatient",
         "Facility": "RES General Hospital",
         "Department": "3N",
         "Room": "136",
         "Bed": "B",
         "Address": {
            "StreetAddress": "9509 Integration Ln",
            "City": "Madison",
            "State": "WI",
            "ZIP": "53719",
            "County": "Dane",
            "Country": "US"
         }
      },
      "Guarantor": {
         "Number": "10001910",
         "FirstName": "Kent",
         "MiddleName": null,
         "LastName": "Bixby",
         "SSN": null,
         "DOB": null,
         "Sex": null,
         "Spouse": {
            "FirstName": "Barbara",
            "LastName": "Bixby"
         },
         "Address": {
            "StreetAddress": "4762 Hickory Street",
            "City": "Monroe",
            "State": "WI",
            "ZIP": "53566",
            "County": "Green",
            "Country": "USA"
         },
         "PhoneNumber": {
            "Home": null,
            "Business": null,
            "Mobile": null
         },
         "EmailAddresses": [],
         "Type": null,
         "RelationToPatient": "Father",
         "Employer": {
            "Name": "Accelerator Labs",
            "Address": {
               "StreetAddress": "1456 Old Sauk Road",
               "City": "Madison",
               "State": "WI",
               "ZIP": "53719",
               "County": "Dane",
               "Country": "USA"
            },
            "PhoneNumber": "+18083451121"
         }
      },
      "Insurances": [
         {
            "Plan": {
               "ID": "31572",
               "IDType": "Payor ID",
               "Name": "HMO Deductable Plan",
               "Type": null
            },
            "MemberNumber": null,
            "Company": {
               "ID": "60054",
               "IDType": null,
               "Name": "aetna (60054 0131)",
               "Address": {
                  "StreetAddress": "PO Box 14080",
                  "City": "Lexington",
                  "State": "KY",
                  "ZIP": "40512-4079",
                  "County": "Fayette",
                  "Country": "US"
               },
               "PhoneNumber": "+18089541123"
            },
            "GroupNumber": "847025-024-0009",
            "GroupName": "Accelerator Labs",
            "EffectiveDate": "2015-01-01",
            "ExpirationDate": "2020-12-31",
            "PolicyNumber": "9140860055",
            "AgreementType": null,
            "CoverageType": null,
            "Insured": {
               "Identifiers": [],
               "LastName": null,
               "MiddleName": null,
               "FirstName": null,
               "SSN": null,
               "Relationship": null,
               "DOB": null,
               "Sex": null,
               "Address": {
                  "StreetAddress": null,
                  "City": null,
                  "State": null,
                  "ZIP": null,
                  "County": null,
                  "Country": null
               }
            }
         }
      ]
   }
}

With these data, your app can track, which patients are being discharged and may come under your care.

Sending Hand-off Report

To send data to a healthcare organization, you’ll need to set up your Redox Source. This will be the gateway through which you push out the data to send measurements and insights back to a patient’s care team. The following is an example of a Notes message that your app could send to the healthcare organization via the Redox API. You can also download a Postman collection from the Redox Dashboard.

curl \
 -X POST https://api.redoxengine.com/endpoint \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer {{access token from auth process}}" \
 -d '{
   "Meta": {
      "DataModel": "Notes",
      "EventType": "New",
      "EventDateTime": "2020-11-05T19:32:15.691Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Patient": {
      "Identifiers": [
         {
            "ID": "0000000001",
            "IDType": "MR"
         },
         {
            "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
            "IDType": "EHRID"
         },
         {
            "ID": "a1d4ee8aba494ca",
            "IDType": "NIST"
         }
      ],
      "Demographics": {
         "FirstName": "Timothy",
         "MiddleName": "Paul",
         "LastName": "Bixby",
         "DOB": "2008-01-06",
         "SSN": "101-01-0001",
         "Sex": "Male",
         "Race": "White",
         "IsHispanic": null,
         "MaritalStatus": "Married",
         "IsDeceased": null,
         "DeathDateTime": null,
         "PhoneNumber": {
            "Home": "+18088675301",
            "Office": null,
            "Mobile": null
         },
         "EmailAddresses": [],
         "Language": "en",
         "Citizenship": [],
         "Address": {
            "StreetAddress": "4762 Hickory Street",
            "City": "Monroe",
            "State": "WI",
            "ZIP": "53566",
            "County": "Green",
            "Country": "US"
         }
      },
      "Notes": []
   },
   "Visit": {
      "VisitNumber": "1234",
      "AccountNumber": null,
      "VisitDateTime": "2015-05-06T06:00:58.872Z"
   },
   "Note": {
      "ContentType": "Base64 Encoded",
      "FileName": "SamplePDF-Order Specific Note",
      "FileContents": "<...base 64 file contents...>",
      "Components": [],
      "DocumentType": "Empty File",
      "DocumentID": "b169267c-10c9-4fe3-91ae-9ckf5703e90l",
      "ServiceDateTime": "2015-05-06T06:00:58.872Z",
      "DocumentationDateTime": "2015-05-06T06:00:58.872Z",
      "Provider": {
         "ID": "4356789876",
         "IDType": "NPI",
         "FirstName": "Pat",
         "LastName": "Granite",
         "Credentials": [
            "MD"
         ],
         "Address": {
            "StreetAddress": "123 Main St.",
            "City": "Madison",
            "State": "WI",
            "ZIP": "53703",
            "County": "Dane",
            "Country": "USA"
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": "+16085551234"
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "Status": null,
      "Authenticator": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
            "StreetAddress": null,
            "City": null,
            "State": null,
            "ZIP": null,
            "County": null,
            "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
            "Office": null
         },
         "Location": {
            "Type": null,
            "Facility": null,
            "Department": null,
            "Room": null
         }
      },
      "Availability": "Unavailable",
      "Notifications": [
         {
            "ID": "2434534567",
            "IDType": "NPI",
            "FirstName": "Sharon",
            "LastName": "Chalk",
            "Credentials": [
               "MD",
               "PhD"
            ],
            "Address": {
               "StreetAddress": "312 Maple Dr. Suite 400",
               "City": "Verona",
               "State": "WI",
               "ZIP": "53593",
               "County": "Dane",
               "Country": "USA"
            },
            "EmailAddresses": [],
            "PhoneNumber": {
               "Office": "+16085559999"
            },
            "Location": {
               "Type": null,
               "Facility": null,
               "Department": null,
               "Room": null
            }
         },
         {
            "ID": "8263749385",
            "IDType": "NPI",
            "FirstName": "Jim",
            "LastName": "Mica",
            "Credentials": [
               "RN"
            ],
            "Address": {
               "StreetAddress": "5235 Kennedy Ave.",
               "City": "Creve Cour",
               "State": "MO",
               "ZIP": "63141",
               "County": "Saint Louis",
               "Country": "USA"
            },
            "EmailAddresses": [],
            "PhoneNumber": {
               "Office": "+13145557777"
            },
            "Location": {
               "Type": null,
               "Facility": null,
               "Department": null,
               "Room": null
            }
         }
      ]
   },
   "Orders": [
      {
         "ID": 123456,
         "Name": "Stress Test"
      }
   ]
}'

Wrapping Up

In this guide, we’ve walked through example messages for each step required to transition care from a traditional healthcare organization to your app’s specialty.

Sign in with your Redox account to access our custom Postman collection, DevTools, and other helpful options to test this workflow out for yourself!