Sync Allergies

Photon enables customers to share patient allergies with the pharmacy and effectively screen for drug allergies by allowing them to sync allergy information. This data is utilized in two key ways:

1. Pharmacy Communication: Allergies are included with the prescription data sent to pharmacies.
2. Allergy Screening: Allergies are used to screen for potential drug-allergy interactions during the prescribing process. Note: To enable allergy screening during prescribing, allergies must be synced to Photon using the API.

Mapping Free-Text Allergies to Allergen IDs

If your system collects allergy information as free text, the first step is to map these entries to recognized allergies within Photon’s system. Here's a step-by-step guide to map a free-text allergy to an :

Step 1: Search for Allergens by Name

Use the allergens GraphQL query to search for allergens by name. This query supports fuzzy matching, allowing you to find closely related terms.

Example:

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

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

// Define the allergens query
const searchAllergensQuery = gql`
  query allergens($filter: AllergenFilter) {
    allergens(filter: $filter) {
      id
      name
      rxcui
    }
  }
`;

// Execute the query to search for "penicillin"
const searchResults = await graphQLClient.request(searchAllergensQuery, {
  filter: {
    name: "penicillin", // Fuzzy search will match similar terms
  },
});

// `searchResults` will contain allergens matching the search term
console.log(searchResults);

Step 2: Use the Retrieved Allergen ID
Once you have the allergen ID from the search results, include it in the AllergenInput field when creating or updating a patient. For example, use the createPatient mutation to add this information.

For Systems Using RxNorm IDs

If your system stores allergy information using RxNorm IDs (RxCUIs), you will still need to map that allergen to an Allergen ID. We're working on adding support for syncing allergies using the RxNorm ID, please contact us if this fits your use case.

For Systems Using Medi-Span ID's

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