Skip to content

Search documentation

Find a documentation page by the words on it.

Documentation

HIE Pull with Metriport

Metriport is one of the two providers HIE Pull can use. It retrieves a patient's outside records from the CommonWell Health Alliance and Carequality networks and files them in the chart. Serelora sets one provider for each clinic, so this page applies only if your clinic's provider is Metriport. For the steps every clinic follows, see HIE Pull.

This feature is controlled by the HIE Pull feature flag. If you do not see it in your clinic, contact Serelora at support@serelora.com and ask for it to be turned on.

How it is set up

Serelora sets Metriport up for your clinic. There is nothing for your staff to enter. On the Integrations tab, the Metriport tile reads Enabled once it is in place. If the tile instead says to reach out to your Serelora contact, ask for it.

Step 1: Check the patient's record

Metriport needs more of a patient's details than a simple search, because the patient is registered with it before the first search. Open the Patient record tab and check that the chart has:

  • A given name and a family name, or a legal name Serelora can split into the two.
  • A date of birth.
  • A sex at birth that is male or female.
  • At least one complete US address: street line, city, two-letter state and ZIP code.

A driver's license, phone number and email are sent too when they are on file. If a driver's license is recorded, its state must be a two-letter code and its number cannot be empty. See The Patient Record Editor.

Step 2: Open the HIE Pull tab and select Refresh HIE

In the patient's chart, open the Actions menu, select HIE Pull, then select Refresh HIE. The first time, Serelora registers the patient with Metriport. A message says "Registered with Metriport" and gives the patient's Metriport ID. You see this message each time you refresh for a patient who is already registered, and it does not mean a duplicate was created.

Then a message says "HIE import started. Waiting for Metriport to deliver data…" and the tab shows progress as Receiving bundle, Import in progress, Import complete or Import failed.

Step 3: Review the records

When the records arrive, they appear in the patient's Documents tab with the source Health information exchange. Serelora reads them the same way it reads other documents, following your clinic's extraction settings. See Documents.

If Serelora asks for more details

If a required detail is missing, Serelora stops before it contacts Metriport and tells you what to add. The messages you may see are:

  • "Patient must have given and family name (or a splittable legal name) for Metriport registration."
  • "Patient date of birth is required for Metriport registration."
  • "Patient sex at birth must be mappable to M or F for Metriport registration."
  • "At least one complete US address (line1, city, 2-letter state, zip) is required for Metriport registration."
  • "A driver license identifier has a missing or invalid US state (2-letter code)." and "Driver license value cannot be empty."

Fix the detail in the Patient record tab and select Refresh HIE again. If a message says your clinic has no Metriport facility linked, Serelora has not finished setting it up. Contact Serelora. For other messages, see HIE Pull Problems.

Who can use it

Anyone who can open the patient's chart can start a pull, as with every HIE Pull provider.