ADT Network

Overview

Health Gorilla's ADT Data provides real-time event notifications from a nationwide network of hospitals. ADT notifications are sent anytime a patient is admitted to a care facility, transferred to a care facility, or discharged from a care facility. To enable ADT notifications for your practice, a roster of patients must be submitted to Health Gorilla. Health Gorilla will enroll the patients on the roster to our ADT network. If any patient on the roster is admitted, transferred or discharged to a care facility in our network, an ADT notification will be sent from the care organization, to your tenant in Health Gorilla. Received ADTs can be accessed the following ways:

  • The Health Gorilla UI
  • FHIR Subscriptions
  • Accessing the original HL7 via a FHIR API

Enrolling Patients

The first step of using the Health Gorilla ADT network, is creating a roster file. Each roster file should represent the current list of patients for which you would like to receive ADTs. Each new roster file upload will supersede the previously uploaded roster. This will allow you to add and remove patients from your ADT roster when needed.

Creating a Patient Roster

To enroll your patients into the Health Gorilla ADT network, a roster of your patients must be uploaded via SFTP. The roster consists of a CSV file that contains the following headers and the attributes for each patient:

FieldDefinitionMax LengthStatusFormat
FHIR Resource IDThe FHIR Resource ID of the patient80RequiredText
BusinessTypeBusiness Type Identifier (i.e. ACO, HMO, etc)20OptionalText
LineOfBusinessInsurance type identifier (i.e. Medicare, Medicaid, Commercial)50OptionalText
SubscriberSSNSubscriber's Social Security Number9OptionalNumeric
PCPIDNPI10RequiredNumeric
PCPIDClientYour internal ID to identify the PCP50OptionalNumeric
PCPLastNamePCP Last Name80OptionalText
PCPFirstNamePCP First Name80OptionalText
SubscriberIDCommercial Payer ID or MBI80RequiredText
MBIMedicare Beneficiary Identification45Required if MedicareText

🚧

SubscriberID Requirement

SubscriberID is always required. There are three possible scenarios.

  1. The patient has commercial insurance only - Place the commercial payer ID in the SubscriberID field
  2. The patient has medicare only - Place the MBI in the SubscriberID AND the MBI fields
  3. The patient has both medicare and commercial insurance - Place the commercial payer ID in the SubscriberID field and the MBI in the MBI field.

Uploading a Patient Roster

After creating a patient roster, the roster must be uploaded to the Health Gorilla SFTP. A set of SFTP credentials will be created for you and can be obtained from your account manager. Once the roster is uploaded to the SFTP, Health Gorilla will use the uploaded file to enroll your selected patients to the ADT network.

🚧

Roster Management

Each roster uploaded will supersede any previously uploaded roster. It is recommended to upload updated rosters once a week.

Receiving Notifications

When an ADT is received for a patient on your roster, a notification can be sent via text message, email or a FHIR subscription service. The original HL7, representing the ADT, can also be retrieved using the Health Gorilla FHIR API.

Using the Health Gorilla UI

Once an ADT is in your tenant, it can be viewed by logging into the Health Gorilla interface using the login page or by logging your users in via our embedded iframe using SSO Embedded Iframe.

In the user settings section of the UI, ADT notification settings can be configured to received notifications of new ADT's via email or text.

Using FHIR Subscription Notifications (webhooks)

Notifications of new ADT's in your tenant can be sent via FHIR subscriptions to a webhook provided to Health Gorilla. This notification will contain all of the information associated with each ADT, including a link to the original HL7. There a three steps involved with creating a FHIR subscription:

  1. Create your webhook url.
  2. User your webhook URL and the Health Gorilla FHIR API's to create a FHIR subscription for ADT's.
  3. Create the code needed to consume the notifications sent to your webhook.

FHIR Notification Example

{
    "resourceType": "Bundle",
    "id": "2a64a366-4c4e-496e-8848-68eac8577e30",
    "type": "message",
    "entry": [
        {
            "fullUrl": "urn:uuid:128761641d1817df3377391a",
            "resource": {
                "resourceType": "MessageHeader",
                "id": "128761641d1817df3377391a",
                "meta": {
                    "profile": [
                        "https://healthgorilla.com/fhir/StructureDefinition/hg-message-header"
                    ]
                },
                "contained": [
                    {
                        "resourceType": "Organization",
                        "id": "1",
                        "identifier": [
                            {
                                "value": "1467417865"
                            }
                        ],
                        "name": "Hospital Jungle Junction"
                    }
                ],
                "extension": [
                    {
                        "url": "http://hl7.org/fhir/3.0/StructureDefinition/extension-MessageHeader.timestamp",
                        "valueInstant": "2023-05-10T12:33:00+00:00"
                    },
                    {
                        "url": "https://www.healthgorilla.com/fhir/R4/StructureDefinition/adt-event-type",
                        "valueCode": "A02"
                    }
                ],
                "eventCoding": {
                    "system": "http://hl7.org/fhir/message-events",
                    "code": "admin-notify",
                    "display": "admin-notify"
                },
                "sender": {
                    "reference": "#1"
                },
                "source": {
                    "name": "EVOLUTION",
                    "software": "EVOLUTION"
                },
                "focus": [
                    {
                        "reference": "Patient/128761643f1ccfdc5778f76b",
                        "display": "Joe Gorilla"
                    }
                ]
            }
        },
        {
            "fullUrl": "urn:uuid:patient",
            "resource": {
                "resourceType": "Patient",
                "id": "patient",
                "meta": {
                    "versionId": "1684113171551",
                    "lastUpdated": "2023-05-15T01:12:51.551+00:00",
                    "profile": [
                        "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
                        "http://fhir.org/guides/argonaut/StructureDefinition/argo-patient"
                    ]
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Joe Gorilla, 72y.o., Male, Rogerston, PA, United States</div>"
                },
                "extension": [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race",
                        "extension": [
                            {
                                "url": "ombCategory",
                                "valueCoding": {
                                    "system": "urn:oid:2.16.840.1.113883.6.238",
                                    "code": "2106-3",
                                    "display": "White"
                                }
                            },
                            {
                                "url": "text",
                                "valueString": "White"
                            }
                        ]
                    }
                ],
                "identifier": [
                    {
                        "use": "usual",
                        "type": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                                    "code": "MR",
                                    "display": "Medical record number"
                                }
                            ],
                            "text": "Medical record number"
                        },
                        "system": "https://www.healthgorilla.com",
                        "value": "128761643f1ccfdc5778f76b"
                    },
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                                    "code": "MR",
                                    "display": "Medical record number"
                                }
                            ],
                            "text": "Medical record number"
                        },
                        "system": "https://www.healthgorilla.com",
                        "value": "863117"
                    },
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                                    "code": "PT",
                                    "display": "Patient external identifier"
                                }
                            ],
                            "text": "Patient external identifier"
                        },
                        "value": "70284123RTE"
                    },
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                                    "code": "PT",
                                    "display": "Patient external identifier"
                                }
                            ],
                            "text": "Patient external identifier"
                        },
                        "value": "326123124"
                    }
                ],
                "active": true,
                "name": [
                    {
                        "use": "usual",
                        "text": "Joe Gorilla",
                        "family": "Gorilla",
                        "given": [
                            "Joe"
                        ]
                    }
                ],
                "gender": "male",
                "birthDate": "1950-12-27",
                "address": [
                    {
                        "use": "home",
                        "text": "543 Elle Rd, Rogerston, PA 00725",
                        "line": [
                            "543 Elle Rd"
                        ],
                        "city": "Rogerston",
                        "state": "PA",
                        "postalCode": "00725",
                        "country": "USA"
                    }
                ],
                "link": [
                    {
                        "other": {
                            "reference": "Patient/128761643f1ccfdc5778f76b",
                            "display": "Joe Gorilla"
                        },
                        "type": "refer"
                    }
                ]
            }
        },
        {
            "fullUrl": "urn:uuid:enc",
            "resource": {
                "resourceType": "Encounter",
                "id": "enc",
                "contained": [
                    {
                        "resourceType": "Practitioner",
                        "id": "1",
                        "identifier": [
                            {
                                "value": "1111111111"
                            }
                        ],
                        "name": [
                            {
                                "text": "John Doe",
                                "family": "Doe",
                                "given": [
                                    "John"
                                ]
                            }
                        ]
                    },
                    {
                        "resourceType": "Practitioner",
                        "id": "2",
                        "identifier": [
                            {
                                "value": "1111111111"
                            }
                        ],
                        "name": [
                            {
                                "text": "John Doe",
                                "family": "Doe",
                                "given": [
                                    "John"
                                ]
                            }
                        ]
                    },
                    {
                        "resourceType": "Practitioner",
                        "id": "3",
                        "identifier": [
                            {
                                "type": {
                                    "coding": [
                                        {
                                            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                                            "code": "NPI"
                                        }
                                    ]
                                },
                                "value": "2222222222"
                            }
                        ],
                        "name": [
                            {
                                "text": "Jane Doe",
                                "family": "Doe",
                                "given": [
                                    "Jane"
                                ]
                            }
                        ]
                    },
                    {
                        "resourceType": "Location",
                        "id": "4",
                        "name": "01",
                        "physicalType": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
                                    "code": "bd",
                                    "display": "Bed"
                                }
                            ],
                            "text": "Bed"
                        },
                        "partOf": {
                            "reference": "#5"
                        }
                    },
                    {
                        "resourceType": "Location",
                        "id": "5",
                        "name": "365",
                        "physicalType": {
                            "coding": [
                                {
                                    "system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
                                    "code": "ro",
                                    "display": "Room"
                                }
                            ],
                            "text": "Room"
                        },
                        "partOf": {
                            "reference": "#6"
                        }
                    },
                    {
                        "resourceType": "Location",
                        "id": "6",
                        "name": "00030"
                    }
                ],
                "identifier": [
                    {
                        "value": "372304270065"
                    }
                ],
                "class": {
                    "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                    "code": "E",
                    "display": "Emergency"
                },
                "type": [
                    {
                        "coding": [
                            {
                                "system": "http://terminology.hl7.org/CodeSystem/v2-0007",
                                "code": "C",
                                "display": "Elective"
                            }
                        ]
                    },
                    {
                        "coding": [
                            {
                                "code": "0"
                            }
                        ]
                    }
                ],
                "subject": {
                    "reference": "Patient/patient"
                },
                "participant": [
                    {
                        "type": [
                            {
                                "coding": [
                                    {
                                        "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                                        "code": "ADM",
                                        "display": "Admitter"
                                    }
                                ]
                            }
                        ],
                        "individual": {
                            "reference": "#1"
                        }
                    },
                    {
                        "type": [
                            {
                                "coding": [
                                    {
                                        "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                                        "code": "ATND",
                                        "display": "Attender"
                                    }
                                ]
                            }
                        ],
                        "individual": {
                            "reference": "#2"
                        }
                    },
                    {
                        "type": [
                            {
                                "coding": [
                                    {
                                        "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                                        "code": "REF",
                                        "display": "Referrer"
                                    }
                                ]
                            }
                        ],
                        "individual": {
                            "reference": "#3"
                        }
                    }
                ],
                "period": {
                    "start": "2023-05-10T12:33:00+00:00"
                },
                "reasonCode": [
                    {
                        "coding": [
                            {
                                "code": "COA"
                            }
                        ]
                    }
                ],
                "hospitalization": {
                    "admitSource": {
                        "coding": [
                            {
                                "code": "1",
                                "display": "Physician referral"
                            },
                            {
                                "system": "http://terminology.hl7.org/CodeSystem/admit-source",
                                "code": "mp",
                                "display": "Medical Practitioner/physician referral"
                            }
                        ]
                    }
                },
                "location": [
                    {
                        "location": {
                            "reference": "#4"
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "urn:uuid:Condition/d1",
            "resource": {
                "resourceType": "Condition",
                "id": "d1",
                "meta": {
                    "versionId": "1684113170677",
                    "lastUpdated": "2023-05-15T01:12:50.677+00:00"
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Coarctation of aorta</div>"
                },
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "HL70052",
                            "code": "F",
                            "display": "Final"
                        }
                    ]
                },
                "code": {
                    "coding": [
                        {
                            "system": "I10",
                            "code": "Q25.1",
                            "display": "Coarctation of aorta"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/patient"
                },
                "recordedDate": "2023-05-01T10:18:00+00:00"
            }
        },
        {
            "fullUrl": "urn:uuid:Condition/d2",
            "resource": {
                "resourceType": "Condition",
                "id": "d2",
                "meta": {
                    "versionId": "1684113170680",
                    "lastUpdated": "2023-05-15T01:12:50.680+00:00"
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Hypertensive heart disease without heart failure</div>"
                },
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "HL70052",
                            "code": "A",
                            "display": "Admitting"
                        }
                    ]
                },
                "code": {
                    "coding": [
                        {
                            "system": "I10",
                            "code": "I11.9",
                            "display": "Hypertensive heart disease without heart failure"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/patient"
                },
                "recordedDate": "2023-05-01T10:18:00+00:00"
            }
        },
        {
            "fullUrl": "urn:uuid:Condition/d3",
            "resource": {
                "resourceType": "Condition",
                "id": "d3",
                "meta": {
                    "versionId": "1684113170681",
                    "lastUpdated": "2023-05-15T01:12:50.681+00:00"
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Pure hypercholesterolemia, unspecified</div>"
                },
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "HL70052",
                            "code": "W",
                            "display": "Working"
                        }
                    ]
                },
                "code": {
                    "coding": [
                        {
                            "system": "I10",
                            "code": "E78.00",
                            "display": "Pure hypercholesterolemia, unspecified"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/patient"
                },
                "recordedDate": "2023-05-01T10:19:00+00:00"
            }
        },
        {
            "fullUrl": "urn:uuid:Condition/d4",
            "resource": {
                "resourceType": "Condition",
                "id": "d4",
                "meta": {
                    "versionId": "1684113170682",
                    "lastUpdated": "2023-05-15T01:12:50.682+00:00"
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Other specified postprocedural states</div>"
                },
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "HL70052",
                            "code": "W",
                            "display": "Working"
                        }
                    ]
                },
                "code": {
                    "coding": [
                        {
                            "system": "I10",
                            "code": "Z98.890",
                            "display": "Other specified postprocedural states"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/patient"
                },
                "recordedDate": "2023-05-01T10:20:00+00:00"
            }
        },
        {
            "fullUrl": "urn:uuid:Condition/d5",
            "resource": {
                "resourceType": "Condition",
                "id": "d5",
                "meta": {
                    "versionId": "1684113170683",
                    "lastUpdated": "2023-05-15T01:12:50.683+00:00"
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Personal history of other diseases of the circulatory system</div>"
                },
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "HL70052",
                            "code": "W",
                            "display": "Working"
                        }
                    ]
                },
                "code": {
                    "coding": [
                        {
                            "system": "I10",
                            "code": "Z86.79",
                            "display": "Personal history of other diseases of the circulatory system"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/patient"
                },
                "recordedDate": "2023-05-01T10:20:00+00:00"
            }
        },
        {
            "fullUrl": "urn:uuid:AllergyIntolerance/allergy1",
            "resource": {
                "resourceType": "AllergyIntolerance",
                "id": "allergy1",
                "meta": {
                    "versionId": "1684113170704",
                    "lastUpdated": "2023-05-15T01:12:50.704+00:00"
                },
                "code": {
                    "coding": [
                        {
                            "system": "HL70100",
                            "code": "1605",
                            "display": "PENICILLIN"
                        }
                    ]
                },
                "patient": {
                    "reference": "Patient"
                },
                "reaction": [
                    {
                        "manifestation": [
                            {
                                "coding": [
                                    {
                                        "display": "Hives and itching after taking penicillin."
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        },
        {
            "resource": {
                "resourceType": "Parameters",
                "id": "hl7",
                "parameter": [
                    {
                        "name": "hl7",
                        "part": [
                            {
                                "name": "name",
                                "valueString": "message_hl7.txt"
                            },
                            {
                                "name": "url",
                                "valueUrl": "https://www.healthgorilla.com/fhir/Binary/1387616479b0872b4b836d6d"
                            },
                            {
                                "name": "contentType",
                                "valueString": "text/plain"
                            },
                            {
                                "name": "size",
                                "valuePositiveInt": 1160
                            },
                            {
                                "name": "checksum",
                                "valueString": "886E1B0A1992426A23B2D5386C9F2364"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

Retrieving the Original HL7

ADT messages are sent in HL7 format. The original HL7 can be retrieved from the FHIR subscription notification payload. Each notification payload contains a Parameters resource type in the FHIR Bundle. The original HL7 can be retrieved by using a GET request to the binary URL found within the Parameters bundle. A valid access token must be passed in the headers of the request to retrieve the HL7.

Example Parameters Resource from FHIR Subscription Notification

 {
            "resource": {
                "resourceType": "Parameters",
                "id": "hl7",
                "parameter": [
                    {
                        "name": "hl7",
                        "part": [
                            {
                                "name": "name",
                                "valueString": "message_hl7.txt"
                            },
                            {
                                "name": "url",
                                "valueUrl": "https://www.healthgorilla.com/fhir/Binary/1387616479b0872b123132"
                            },
                            {
                                "name": "contentType",
                                "valueString": "text/plain"
                            },
                            {
                                "name": "size",
                                "valuePositiveInt": 1160
                            },
                            {
                                "name": "checksum",
                                "valueString": "886E1B0A1992426A23B2D5386C9F2111"
                            }
                        ]
                    }
                ]
            }
        }