# Set up your onramp to TEFCA-CommonWell With Network Onramps, you can integrate with TEFCA via CommonWell. [Learn about TEFCA](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell). ## Qualify for TEFCA Before you get started, your organization has to go through a vetting process with TEFCA before being entered into their directory. The aim of this vetting process is to ensure that your organization qualifies for the appropriate treatment (i.e., Purpose of Use) type. > **Treatment** > > The U.S. Department of Health and Human Services (HHS) defines _treatment_ in the Privacy Rule at 45 CFR 164.501: > > > “Treatment” generally means the provision, coordination, or management of health care and related services by one or more health care providers, including the coordination or management of health care by a health care provider with a third party, consultation between health care providers relating to a patient, or the referral of a patient for health care from one health care provider to another. You can start the vetting process during your onboarding to Redox or the beginning of your new implementation project with TEFCA. The time for this process can vary, but you should plan for around 3 weeks for the full vetting process. 1. Your Technical Account Manager provides an organization submission form. 2. Fill out the submission form and include any documentation to demonstrate your right to be part of the Purpose of Use treatment type. 3. Return the form and any documentation to your Technical Account Manager. 4. We send your documentation to CommonWell for review. 1. If requirements are met, you receive an approval email for your organization entry. Proceed to step #5. 2. If requirements aren’t met, you receive a denial email. We will follow up within 3 business days to discuss why the organization entry wasn’t approved. You may be able to resubmit. 5. CommonWell submits all received entries to the Recognized Coordinating Entity (RCE). The entries are available for other QHINs to review. Any QHIN can file objections during the 10-day objection period. Either of these outcomes can occur: 1. If an objection is raised, you receive a notification within 3 business days. CommonWell works directly with you to move you to a new process for further evaluation. 2. If no objection is raised, your organization is allowed to be added to TEFCA. Proceed to step #6. 6. We provide a delegation notice to you, which appoints Redox as your delegate organization. Sign the notice to complete the vetting process. ## Set up credentials and OIDs You’ll work with Redox to set up the appropriate credentials and OIDs for working with TEFCA-CommonWell. These are the things you’ll need: - source identifier - API key - API secret - patient OID - organization OID - document OID - data on demand destination ID ### What you’ll do 1. [Create and authenticate an OAuth API key](/api-reference/redox-data-model-api/authenticate-an-oauth-api-key). 2. Refer to the API reference and complete dev work for using the relevant data models. You’ll need these to query and write data to TEFCA-CommonWell. - [`Organization.New`](https://docs.redoxengine.com/permalink/organization-new) - [`Organization.Update`](https://docs.redoxengine.com/permalink/organization-update) - [`PatientSearch.LocationQuery`](https://docs.redoxengine.com/permalink/patient-search-location-query) - [`ClinicalSummary.DocumentQuery`](https://docs.redoxengine.com/permalink/clinical-summary-document-query) - [`ClinicalSummary.DocumentGet`](https://docs.redoxengine.com/permalink/clinical-summary-document-get) - [`PatientAdmin.NewPatient`](https://docs.redoxengine.com/permalink/patient-admin-new-patient) - [`PatientAdmin.PatientUpdate`](https://docs.redoxengine.com/permalink/patient-admin-patient-update) - [`PatientAdmin.PatientMerge`](https://docs.redoxengine.com/permalink/patient-admin-patient-merge) - [`ClinicalSummary.VisitQuery`](https://docs.redoxengine.com/permalink/clinical-summary-visit-query) - [`ClinicalSummary.VisitPush`](https://docs.redoxengine.com/permalink/clinical-summary-visit-push) 3. [Submit a Help Desk request](https://redoxengine.zendesk.com/hc/en-us/requests/new?ticket_form_id=35298451431956) ( **Onboarding** \> **Tech validation** type) to begin the tech validation process (review details below). ### What Redox will do 1. Set up your data on demand destination that you can push data to. 2. Configure subscriptions to TEFCA-CommonWell. You must have already created an OAuth API key for a Redoxer to complete this step. 3. Provide all identifiers, or OIDs, for testing. This includes these OIDs. You can use these to test your integration. [Learn about testing with the Network Onramps sandbox](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/test-sandbox-for-onramp-to-tefca-commonwell).
Destination IDs for TEFCA-CommonWell You must populate any test requests with the appropriate destination ID in the `Meta.Destinations` array based on the environment and type of requests: | **Query purpose** | **Development ID** | **Production ID** | | --- | --- | --- | | Perform a patient search (`PatientSearch.LocationQuery`) | `3122bfff-f1fb-4fdf-97de-294f24338229` | `7fd005ac-d788-40c5-b4e8-b57bb8e310a9` | | Create or update an organization (`Organization.New`, `Organization.Update`) | `3122bfff-f1fb-4fdf-97de-294f24338229` | `7fd005ac-d788-40c5-b4e8-b57bb8e310a9` | | Search for a clinical summary/document (`ClinicalSummary.DocumentQuery`, `ClinicalSummary.DocumentGet`) | `cf1dca0e-98de-432b-8c9a-dd039816df0e` | `79981c00-b9c4-40a9-9844-01980e6e524e` | | Save patient details to your repository (`PatientAdmin.NewPatient`, `PatientAdmin.PatientUpdate`, `PatientAdmin.PatientMerge`) | `3122bfff-f1fb-4fdf-97de-294f24338229` | `7fd005ac-d788-40c5-b4e8-b57bb8e310a9` | | Save documents to your repository (`ClinicalSummary.VisitQuery`, `ClinicalSummary.VisitPush`) | This is specific to your organization. Redox provides the correct ID. | This is specific to your organization. Redox provides the correct ID. | ##
## Tech validation Before go-live, you must perform tech validation. [Learn about submitting a tech validation request](https://docs.redoxengine.com/permalink/4h0GI8VNWmiktosfODJQz9/#submit-a-request-to-redox-help-center) (**Onboarding** \> **Tech validation** type) to the Redox Help Center. You'll want to test that you can perform the steps outlined in these how-tos (except send messages to the sandbox environment instead): 1. [Create and maintain your organization record](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/create-a-tefca-commonwell-organization-record). 2. [Search for patient records](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/search-tefca-commonwell-for-patient-records). 3. [Request patient documents](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/request-patient-documents-from-tefca-commonwell). 4. [Maintain your Redox repository](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/maintain-your-redox-repository-for-tefca-commonwell). ## Migrate to production Once you’ve finished tech validation with Redox,[ submit a go-live readiness request](https://redoxengine.zendesk.com/hc/en-us) (**New/implementing connection** \> **Go live readiness** request type) so that we can help you migrate to production. After migrating to production, make sure to push patient demographics and visit details to your data on demand repository. This allows us to respond to incoming requests from other TEFCA-CommonWell participants. > **Don’t use test data in production** > > You shouldn’t use test data with other clinical network participants in production. Doing so could result in your network access being temporarily suspended. > **Onramp to TEFCA resources** > > **Basic information** > > - [Interact with clinical networks](/how-to-use-redox/interact-with-clinical-networks) > - [TEFCA identity and organization structure](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/tefca-identity-and-organization-structure) > > **How-to** > > - [Set up your onramp to TEFCA-CommonWell](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/set-up-your-onramp-to-tefca-commonwell) > - [Test sandbox for onramp to TEFCA-CommonWell](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/test-sandbox-for-onramp-to-tefca-commonwell) > - [Populate your patient repository for TEFCA-CommonWell](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/populate-your-patient-repository-for-tefca-commonwell) > - [Create a TEFCA-CommonWell organization record](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/create-a-tefca-commonwell-organization-record) > - [Search TEFCA-CommonWell for patient records](/how-to-use-redox/interact-with-clinical-networks/onramp-to-carequality/search-for-patient-records) > - [Request patient documents from TEFCA-CommonWell](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/request-patient-documents-from-tefca-commonwell) > - [Maintain your Redox repository](/how-to-use-redox/interact-with-clinical-networks/onramp-to-tefca-commonwell/maintain-your-redox-repository-for-tefca-commonwell) > > **Troubleshooting** > > - [Common TEFCA errors](/troubleshooting/troubleshoot-tefca-commonwell-errors)