Messages Overview

medication history for populations fhir object model panel and prescription notifications (except first fill not picked up ) are mapped using the following object model in the surescripts fhir server this model illustrates the relationships between the various resources involved note prescription notifications is constrained to 1…1 relationship between the communication and medication dispensed fhir resources prescription notification first fill not picked up fhir object model the prescription notification for first fill not picked up (ffnpu) is mapped using the following object model in the surescripts fhir server this model illustrates the relationship between the resources involved and bases the communication resource on the medicationrequest , since the medication has not been dispensed or picked up by the patient about medication history for populations fhir api medication history for populations is implemented with fhir® release 4 panels and prescription notifications are retrieved using a search request search operation should contain parameters for at least a start and end date with time the following should be considered this creates a window of time for which panel responses and/or notifications are retrieved the maximum retrieval frequency rate for running a search request should be every two hours in the past the parameters specified identify what fhir resources will be retrieved results paging is supported the search operation is stateless, which means requesting the same window multiple times will result in the same response it is the customer's responsibility to track which panels and notifications have already been processed, and handle duplicates appropriately identical notification will not appear twice within a bundle, but duplicates may occur across multiple bundles depending on the retrieval window used, as well as surescripts internal generation of notifications response will be a bundle of fhir® resources which represent a fhir response resources include (but not necessarily limited to) bundle, patient, organization, practitioner, medicationrequest, medicationdispense, medication, condition, and communication data deduplication and augmentation in fhir api panel messages data deduplication and augmentation are optional features and require no configuration or certification by the provider vendor the customer may opt in to one or both features data deduplication surescripts removes duplicate medication history dispense data across data sources a duplicate medication record is defined as the same medication for the same patient, written by the same provider, dispensed on the same day at the same pharmacy data augmentation surescripts adds data to missing fields from data suppliers for example, by adding address or phone in the pharmacy or prescriber segment \<font color="#002a3b">notes \</font> surescripts offers two options for deduplication and augmentation basic and premium for more information, contact your account manager surescripts will never overwrite or replace existing data from data suppliers logic used to identify duplicates and data fields augmented is subject to change please work with a surescripts account manager or integration resource for more information medication history for populations request medication history for populations panel and prescription notifications are primarily retrieved using a fhir search of the communication resource for details on request parameter rules and definitions, such as lastupdated, refer to medication history for populations element details docid 1wcalmwvfu9wlhllwttf5 note times specified for the request must use utc format docid\ igygvxuo1yihy2x42wkf3 to receive search requests within the desired time window, make sure to convert your local time to this format base prefix for communication get https //fqdn/ext/v1/communication associated fhir resource bundles patient organization practitioner medication request medication dispense medication condition communication capability statement operation outcome fhir message response types type description recommended fix ssl connect error missing client certificate this error is due to missing client certificate in the request include client certificate 400 – bad request missing or badly formatted parameter(s) the data provided in the query string will not validate to the rules the response will return a bundle with an operationoutcome example lastupdated date of 2018 09 0600 00 00z is formatted incorrectly refer to the bad request message example docid\ lg7is7zasagpdoeplk vb for more information the error messages defined on the model will appear in the operationoutcome so that the query parameters can be manually corrected to resolve the issue 401 – unauthorized invalid certificate issuer or subject the request is received with a client certificate, but it is not matched with what is configured at surescripts use the same certificate configured 403 – forbidden product is not set up for this participant id, or resource id requested is not permitted for your participant id check if setup by surescripts verify the resource id returned from a previous fhir request 404 – not found resource does not exist 200 – ok response with or without results if no results appear, there were no notifications generated within the provided search window