Sync Medication History

Photon enables customers to sync external medication histories. This data is utilized in two key ways:

1. Pharmacy Communication: External medications are included with the prescription data sent to pharmacies.
2. Drug Interaction Screening: External medications are used to screen for potential drug-drug interactions during the prescribing process when they're added to their medication history. Note: Drug-drug interaction screening is enabled by default for prescriptions written using Photon. However, to include screening against self reported medications, you must sync this data via the API or by using the medication history component in the UI.

Mapping Patient Reported Medications to Photon Medication ID's

When adding or updating a patient’s profile, you can include their medication history. This process involves two steps:

Step 1: Retrieve the Medication ID

Use the medications GraphQL query to search the Photon medication catalog and retrieve the medication ID. This ID is necessary for associating medications with a patient’s history.

Example:

import { GraphQLClient, gql } from "graphql-request";

// Initialize the GraphQL client
const graphQLClient = new GraphQLClient("https://api.neutron.health/graphql", {
  headers: {
    authorization: "Bearer YOUR_TOKEN_HERE", // Replace with your API token
  },
});

// Define the medications query
const searchMedicationsQuery = gql`
  query medications($filter: MedicationFilter) {
    medications(filter: $filter) {
      id
      name
      genericName
      strength
      form
    }
  }
`;

// Execute the query to search for "lisinopril"
const medResults = await graphQLClient.request(searchMedicationsQuery, {
  filter: { name: "lisinopril" },
});

// `medResults` will contain the medication details, including the ID
console.log(medResults);

Step 2: Include the Medication ID in the Patient Profile

Use the retrieved ID in the MedHistoryInput field when creating or updating a patient’s profile. For example, include this information in the createPatient mutation to associate the medication with the patient.

For Systems Using Medispan ID's

We are actively working on adding support for syncing medication history using Medi-Span IDs. If your system stores medications with Medi-Span IDs, please contact us so we can discuss your use case and keep you updated on the progress of this feature.