Connecting with PointClickCare using USCDI Connector FHIR applications
USCDI Connector is PointClickCare’s solution for customers and 3rd party vendors, interested in building ONC compliant FHIR API based integrations with PointClickCare.
PointClickCare’s FHIR API documentation for USCDI Connector lists the details of the FHIR APIs supported (in line with the USCDI v1 data set). For further API details please refer to the FHIR US Core 3.1.1 Implementation Guide.
There are 3 types of USCDI Connector applications that can be registered with PointClickCare – Patient facing, Provider facing & Bulk data. Before Apps can access patient data from PointClickCare, please go through the process below to register your application.
Please note, Users (Patient or Provider) will only have access to patient records that their accounts are authorized to access in PointClickCare.
- Note for PointClickCare Customers: To gain a good understanding of how access levels in PointClickCare map to FHIR patient data resources, please ensure you test the application’s FHIR integration with PointClickCare thoroughly.
Registering a SMART on FHIR Application to access Patient data
- Prior to accessing patient data, you will need to register your application. To start the process, please contact our Partnership team through the ‘Apply for Partnership’ form at: Become a Partner (pointclickcare.com)
.
Once the right Developer program (USCDI Connector or Marketplace) has been determined for your business, you will receive a link via email to apply for your Developer Portal account.
- When creating your Developer Portal account please select 'USCDI Connector'.
- Please fill out the form using the same details you have previously shared with the PointClickCare Partner Manager. After you fill out the form, your account will need to be approved by PointClickCare. You will receive an email verification after which you can access the tabs under your user profile.
To register an App you will also need to set up 2-Factor Authentication. Instructions are listed under the Documentation tab in the Developer Portal.
- Once approved, click your user profile button in the top right corner, to get access to the 'My Apps' tab to create your App.
- Please enter your App name, as you would like it to be displayed to your Users.
- The first App you create has to be 'Development'. This will allow you to test with the PCC Sandbox.
- Select one of the 3 'App Type' options:
- Patient - These are Apps intended for use by patients and will be launched from the Connected Care Center (PointClickCare's Patient Portal product) or directly from a mobile device.
- Provider - These are Apps intended for use by medical providers (i.e. having a PointClickCare user account) and will be launched from the Core PointClickCare application or directly from a mobile device.
- Bulk - These are Apps intended for system to system bulk data queries using the bulk FHIR API standard. They are not visible to Users to launch out of PointClickCare E.H.R or Connected Care Center.
- Describe your Apps functionality with as much detail as possible.
- Select the authentication method used by your App and provide any required details.
- Provide the requested URLs.
- Provide the FHIR scopes (as defined by the SMART on FHIR protocol) that your App will require. If you do not use the correct format (example is provided in the tool tip) your App will not be able to access data. Please note PointClickCare only supports scopes related to the supported FHIR API resources.
- Provide the Common Name for the Certificate in use by your App. Please ensure the certificate is supported by PointClickCare. For a list of supported certificates, please refer to the 'Documentation' tab. If the Common Name is not provided, your application will not be approved.
- If this is your first App being registered with PointClickCare, ignore the Serial Number field. Only provide the Serial Number of the Certificate if it needs to be revoked due to the application being compromised.
- Provide the 'Communication Email' that notifications can be sent to.
- Indicate the platform you are developing for.
- If you are registering a Web App, please provide your Launch URL.
- Please Accept PointClickCare’s Terms & Conditions.
- Development Apps will be auto-approved and enabled in the PointClickCare FHIR Sandbox.
- Production Apps will need PointClickCare approval.
- Your App Client ID & Secret (for Development and Production Apps) will be available through your App listing under 'My Apps'.
Enablement process for USCDI Connector integrations
- Once an app has been registered with PCC, the enablement is driven by PCC customers, by Facility
- PCC customers will need to speak with their PCC Sales Representative about the process to enable a USCDI Connector integration
- The integration enablement will take a minimum of 2 weeks, depending on the number of Facilities where the enablement is requested and the complexity of their patient records
- Note: If you are registering a ‘Patient’ facing App, the customer will have to be enabled with PointClickCare’s Connected Care Center for your Users to access patient data.
Sandbox usage
- PointClickCare provides a shared Sandbox for FHIR Apps to be tested against.
- The Sandbox details are available through 'My Sandboxes' under the user profile button in the top right corner.
- Patient Apps - Please use the credentials beginning with 'ConnecterCareCenterUser'.
- Provider Apps - Please use the credentials beginning with 'vendortest'.
Making your first FHIR API call
- PCCs implementation of SMART on FHIR follows the public standard. Please use the documentation listed here as the guide: https://hl7.org/fhir/smart-app-launch/2021May/
- Note: The base FHIR URL
https://connect2.pointclickcare.com/fhir/R4
will need to have the Tenant ID appended to it before the FHIR resource is called
- Sample URL:
https://connect2.pointclickcare.com/fhir/R4/{tenantId}/CareTeam
- Service Base URLs are available here: https://fhir.pointclickcare.com/R4endpoints.json
Retrieving a CCD (g9)
- You will need to register a patient/provider App to access CCD’s via API.
- To access CCDs you will need to use the FHIR DocumentReference API. The API details to make the successful call can be found on the API Specification page.
- Requesting a current CCD:
- Make DocumentReference call using patient, type set to CCD Loinc code (listed in period element in the API specification).
- Receive 1 Document Reference in the response, with 1 attachment that contains the URL to generate the current CCD.
- API response element that contains the URL: DocumentReference.content.attachment.url
- Traverse the URL to obtain the CCD, which is immediately resolved as XML
- Requesting a CCD for a date/date range
- Make DocumentReference call using the patient, type set to CCD Loinc code and the period (all described in the API specification).
- Receive 1 Document Reference in the response, with a list of CCDs as attachments. Each attachment has a URL for the specific document
- API response element that contains the URL: DocumentReference.content.attachment.url
- Traverse the URL to obtain the CCD, which is immediately resolved as XML
- If the response comes back with 0 results, the current version of the CCD is generated on the fly and immediately resolved as XML
Pricing
USCDI Connector FHIR API pricing uses the following model:
- Customers under PCC’s current pricing model will be charged a flat fee of $65 per App per Facility per Month. This price will be subject to annual revision, in line with costs incurred by PointClickCare.