The Carequality Interoperability Framework has disparate, varied errors. Below, we describe common errors and the steps you can take.
If you need extra support to resolve any Carequality issues, submit a ticket via our Help Desk.
If there's an issue on the Carequality side, you may see any of these errors returned after you initiate a request:
If you receive an
So if you see an
This may be returned if you attempt to create a new organization or patient record with an existing OID.
This error occurs because your request body has to contain:
(a) at least one identifier element;
(b) a valid type element;
(c) at least one contact element (for implementer only); and
(d) valid display names for any defined endpoints.
This may be returned if you attempt to update or delete an organization or patient record with an OID that doesn't currently exist.
The patient or document you're looking for isn't found.
If this is returned, it's possible that there was a change to the patient record. We recommend running the PatientSearch.Query with the patient’s updated demographics to get the correct network patient ID.
If you receive the error below, it means that the correct ID is missing in the
No subscriptions. Meta.Destinations needs to contain a destination from existing subscription.
In other words, we don’t recognize a valid connection, so you need to populate the ID in
Meta.Destinations to indicate where you intend to send your request. The table below lists the correct destination IDs based on the request purpose for both staging and production environments:
|Request purpose||Staging ID||Production ID|
|Query for/create/update/delete an organization|
|Search for a patient with record locator service|
|Search for a patient within a specific organization|
|Search for a clinical summary/document|
|Save patient details and documents to your repository||This is specific to your org—you can find the correct ID in the digital record retrieval wizard.||This is specific to your org—you can find the correct ID in the digital record retrieval wizard.|
You may receive an error that states:
Repository URL and certificate are required. Review destination configuration.
This means that we couldn't find the organization specified in your request. This can happen if:
If you find a match via PatientSearch then try the ClinicalSummary.PatientQuery, you may receive an error that states:
Something Went Wrong Retrieving The Document List. Error: Could Not Find Any Documents.
This occurs when the organization doesn't have any documents available for the patient. In these cases, it's possible that patient consent is missing or that the patient is registered but hasn't had a visit yet, so there isn't any clinical data available.
If you expect documents but aren't getting any, submit a ticket via our Help Desk so that we can reach out to the relevant implementers and Carequality participants.
You may receive an error that states:
Request received a response with status code 504.
Socket hang up
Client network socket disconnected before secure TLS connection was established.
This may occur as different systems undergo maintenance or small outages. Given that these connectivity errors are typically temporary, we recommend retrying the request. If you see persistent problems with an organization, submit a ticket via our Help Desk.
We follow Carequality’s Technical Trust Policy in order to connect to the Framework. This includes provisions like which certificates to exchange to participate in the Framework. You may see any of these certificate errors:
This means that the organization you're requesting data from incorrectly installed its certificate and security is compromised.
Or, that the certificate issuers in the sandbox (i.e., staging) environment changed, and one or more of the Carequality participants hasn't updated to this new certificate chain.
To avoid this error, we recommend using the Redox test patients and Postman examples to test with since they should always work. We keep them current and working correctly on our end so that you can just focus on testing.
This means that the organization you're requesting data from installed the wrong certificate.
Connectivity with Carequality depends on mutual TLS authentication to ensure security. The certificates issued by Carequality need to be refreshed and reinstalled periodically.
If you see any certificate errors, submit a ticket via our Help Desk so that we can reach out to the relevant implementers and Carequality participants.
You may get this error when sending a PatientAdmin or ClinicalSummary to your data on demand repository:
Cannot process messages for Data Chateau environment 'environment', the environment is in a 'error' state.
We work to ensure first-in, first-out (FIFO) order so that data arrives in its intended order. Receiving this error indicates that there was an error processing an incoming message.
At this point, we pause future messages from filing to ensure that data is not missed or corrupted. Submit a Help Desk ticket to reset the environment.