# Carequality Interoperability Framework FAQ

Refer to these questions for help with <u>**Network Onramps**</u> and integrating with the <u>**Carequality Interoperability Framework**</u>. 

> **Useful links**
>
> - [Use the Carequality search](https://carequality.org/active-sites-search/). See who’s already participating in the Carequality Interoperability Framework.
> - [Set up an onramp to Carequality](/how-to-use-redox/interact-with-clinical-networks/onramp-to-carequality/set-up-your-onramp-to-carequality). Start integrating with this nationwide clinical network.

## Integrating with Carequality

<details>
<summary>Can I reuse my Redox configuration for other connections?</summary>

Yes, you can request multiple connections through your one Redox organization. [Learn how to request a connection](/how-to-use-redox/manage-your-redox-setup/request-a-connection-or-subscription) and [explore other potential connections](https://redoxengine.com/connected-solutions/).

You can also use the same Redox APIs to search for patients and clinical documents either from individual connections or nationwide networks like Carequality or TEFCA-CommonWell. Talk to your Technical Account Manager if you have any questions. 

> **API reference links**
>
> Check out the specs for our Redox APIs to find out the requirements and supported data for each: 
>
> - [FHIR API](/api-reference/fhir-api-reference)
> - [Data Model API](https://docs.redoxengine.com/permalink/data-model-landing-page)

</details>

<details>
<summary>What about CommonWell and the eHealth Exchange?</summary>

Commonwell and eHealth Exchange are two of the nation’s largest centralized health information exchanges. Both are certified Carequality implementers with thousands of live sites, meaning that you can exchange data with them via Carequality.

However, Redox is also an implementer of CommonWell directly. [Learn more about an onramp to TEFCA-CommonWell](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell).

</details>

<details>
<summary>Can I push data or receive notifications when new data is available?</summary>

Short answer: No, Carequality doesn’t support event notifications.

Longer answer: No, Carequality doesn’t support event notifications (same as CommonWell). But you might want to push data since it’s great for use cases like provider-to-provider messaging, event notification, diagnostic test ordering, and referrals. In general, event notifications are great when you want updates about patient data without having to query for it every time.

If your unique workflow includes any of the use cases for push scenarios, we can help you push data via <u>**Direct Secure Messaging**</u> instead. [Learn more about DirectTrust messaging](/basics/data-exchange-with-redox/using-directtrust-to-exchange-data-securely).

</details>

## Finding patients

<details>
<summary>Why can’t I find patients in the sandbox?</summary>

As your responder, we use the data you push to Redox to respond to any Carequality queries. We isolate the data you push to improve the robustness, integrity, and consistency of our test system. The downside is that you won’t be able to find the patients you add to Carequality.

If you really do need to find your own patients or documents, you can search your data on demand repository using these queries:

- [`PatientSearch.Query`](https://docs.redoxengine.com/permalink/patient-search-query)
- [`ClinicalSummary.DocumentQuery`](https://docs.redoxengine.com/permalink/clinical-summary-document-query)
- [`ClinicalSummary.DocumentGet`](https://docs.redoxengine.com/permalink/clinical-summary-document-get)

Just make sure you switch the Carequality `destination.ID` to the data on demand `repository.ID` instead. When you search data on demand, your IDs match exactly what you sent. But keep in mind that the record ID isn’t the same one that appears in Carequality.

</details>

<details>
<summary>Why don’t the IDs I use for patients and documents match what’s in Carequality?</summary>

To guarantee uniqueness, Carequality assigns new IDs to all patient and document records they receive. When you push a patient with ID 1234 or a document with ID 5678, you won’t find them in Carequality with those same IDs.

To find the Carequality-assigned IDs, you must perform a patient search with demographics to Redox. Then, find the patient’s related documents. With the Carequality ID, you can retrieve data about the same patient from other Carequality participants.

</details>

<details>
<summary>Why am I not getting any results from my patient search?</summary>

If you receive a successful response without any results, it typically means that there were no matching patients found. You may want to search with a smaller set of demographics or verify that the patient’s information is correct.

</details>

<details>
<summary>Can I search for a patient with an identifier?</summary>

Yes, but only if you have the specific patient ID and matching OID that the organization uses to represent a patient OID type.

For example, if you use a medical record number (MRN), you must have the OID that the organization uses to represent MRNs. However, you typically won’t know these OIDs since organizations often have a specific identifier for Carequality responses.

We recommend starting with a demographics search, even if you do already have an identifier.

</details>

<details>
<summary>If my patient search is taking awhile, how do I check if the query is still running?</summary>

When you use the `PatientSearch.LocationQuery`, our record locator service runs the search for you. However, it might take awhile to return all the results because record locator service sends the query to each site individually. [Learn about checking the status of your search](https://docs.redoxengine.com/permalink/7vkqqC6BJejJqcCd5Ud7g7/#notes-about-the-location-search-response). 

</details>

<details>
<summary>How does Redox's record locator service find patients? </summary>

Redox’s record locator service searches for patients within a 100-mile radius of the sender’s organization (as defined in `Meta.Extensions.sender-organization-id`). The record locator service also searches within a 100-mile radius of the patient’s ZIP code, if provided. This means there could be a radius larger than 100 miles if those two ZIP codes aren’t the same.

This is one of the multiple ways Redox locates matching patients based on the search criteria. The search logic is subject to change without notice if we identify ways to improve the matching rate.

</details>

## Clinical documents

<details>
<summary>I’m getting a lot of documents back on the response. What can I do?</summary>

You can use any of the supported request parameters in `ClinicalSummary.DocumentQuery` to specify a date range or the types of documents to return. Using any of those parameters should limit the number of documents in the response. We recommend using the `Visit.StartDate` to pull documents after a given date of service. 

[Review the supported request parameters for this query](https://docs.redoxengine.com/permalink/clinical-summary-document-query). Just keep in mind that some Carequality participants might not support all of these parameters. 

</details>

<details>
<summary>Why does DocumentGet return the raw XML document?</summary>

We offer the XML response since some organizations have pre-built capabilities to render XML C-CDA documents. There are also many available open-source CDA renderers that can be useful in viewing the XML document.

If you’re interested, check out these options for an open-source C-CDA renderer:

- [HL7 C-CDA Viewer](https://brynlewis.org/challenge/index.htm)
- [Patient Insight 1.0 CCD-CDA Rendering Tool](https://github.com/healthlx/HL7Challenge)

</details>

## Responding to Carequality

<details>
<summary>Can I respond to Carequality myself rather than using Redox as my responder?</summary>

Yes, you can respond to queries from Carequality participants yourself, but you won’t qualify for Network Onramps pricing. [Learn how to be your own responder](/how-to-use-redox/interact-with-clinical-networks/onramp-to-carequality/answer-carequality-requests-without-the-redox-responder).

</details>

<details>
<summary>What data does Redox store?</summary>

We store all requests to and from Carequality per our standard data retention policy. [Learn more about our data retention policy](/security/data-retention).

To be a little more specific, we store all of the data you push to your data on demand repository for the life of your contract. We store it so that we can adequately respond to your incoming Carequality queries. 

</details>

<details>
<summary>When do I have to push information to Redox for responses?</summary>

You must push data (via `ClinicalSummary.VisitPush`) to your data on demand repository for every patient treatment. You don’t have to push data immediately after every treatment, though. For example, you’re welcome to push a daily batch to us instead.

You must also push all patient demographic updates to us so that we can keep your patient demographics current. Remember, we’re responding to incoming Carequality queries for you. Having all your updated data lets us accurately respond when someone asks whether a patient has been seen at your location.

[Learn how to maintain your Redox repository](/how-to-use-redox/interact-with-clinical-networks/onramp-to-carequality/maintain-your-redox-repository-for-carequality). 

</details>

<details>
<summary>Do I need to send historical data?</summary>

Carequality requires you to respond to queries about patients you’ve seen. However, they don’t specify a definite period for historical information. We recommend you start pushing data once you register your organization in production. Then, build your historical data from that point.

If you want to send historical data, you might not qualify for Network Onramps. [Talk to a Redoxer](https://redoxengine.com/forms/contact-us/) to discuss your needs.

</details>
