Prescription Search Support
1.0.0 - STU1

Prescription Search Support, published by eHealth Platform Belgium. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-be/pss/ and changes regularly. See the Directory of published versions

## Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

### Logical Models

Data Models representing the data structures and requirements for interoperability.

PSS Consent | Consent statement about using PSS and agreeing with (or opting out of) the Terms and Conditions.
PSS Feedback | Feedback containing the acceptance of the PSS results.
PSS Request | A request for PSS (Prescriber Support System) results.
PSS Response | A response containing the results from the PSS.

### PlanDefinitions (services)

PlanDefinitions defining the service endpoints for using the PSS. These have the inputs and outputs represented by the profiles

GetDataToCollect | Get Data to Collect
GetDiagnoses | Get Diagnoses Data
GetRecommendations | Get recommendations for potential treatments based on patient information

### Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide

PSS anonymised Patient | PSS anonymised Patient
PSS Data Acquisition Form | The PSS Data Acquisition Form is used to inform what data needs to be acquired and provided to the PSS system.
PSS MedicationRequest Task | PSS MedicationRequest - using anonymised patient
PSS Questionnaire Task | PSS Task for Questionnaire - using anonymised patient
PSS Request Bundle | The PSS Request Data Bundle is used to request data from the PSS system.
PSS Response Bundle | The PSS Response Bundle is used to return data from the PSS system.
PSS Response Communication Request | All PSS responses contain a PSS Communication Request conformant to this profile.
PSS Response Medication Request | The PSS Response Medication Request is used when the PSS system returns a MedicationRequest
PSS Response Request Group | All PSS responses contain a PSS RequestGroup conformant to this profile.
PSS Response Service Request | The PSS Response Service Request is used when the PSS system returns a ServiceRequest

### Extensions

These define additional elements that can be exchanged with the respective FHIR resources

AnswerOption Additional Code | An additional code for an option in a choice question
Code ValueSet | A ValueSet used when a question / item can correspond not just to a single code but to a set of concepts
PSS Rating Extension | A clinician-friendly rating, or score, for the recommendation; patient-friendly if the recommendation is patient-facing.
PSS Relevant Patient Age | The approximate, relevant age of the patient at the time of the search.

### Feedback

Feedback resources for the PSS services

PSS Feedback Operation Definition | Operation to provide feedback on PSS suggestions

### Common examples

Common examples - valid to multiple PSS services

Antimicrobiology - No permission to use system - 11.1. Task | Antimicrobiology - No permission to use system - 11.1. Task
Antimicrobiology - PSS not activated- Response | Antimicrobiology - PSS not activated- Response
Generic response - Guidance unavailable | Generic response - PSS not activated- 1. Bundle
Generic response - No permission to use system | Antimicrobiology - No permission to use system - 11.1. RequestGroup
Generic response - No permission to use system - 11. Bundle | Antimicrobiology - No permission to use system - 11. Bundle
Generic response - PSS not activated- 10.1. RequestGroup | Generic response - PSS not activated- 10.1. RequestGroup
Terms and Conditions Consent Form | Terms and Conditions Consent Form

### Examples - Antimicrobiology

Antimicrobiology PSS resource examples

30551ce1-5a28-4356-b684-2e639094ad48 | Example anonymised patient A
Antimicrobiology - S2 Get data to collect - Request - 1. - Bundle | Antimicrobiology - S2 Get data to collect - Request - 1. Bundle
Antimicrobiology - S2 Get data to collect - Request - 1.1. Diagnostic hypothesis - vulvovaginitis | Antimicrobiology - S2 Get data to collect - Request - 1.1. Diagnostic hypothesis - vulvovaginitis
Antimicrobiology - S2 Get data to collect - Request - 1.2. Known allergy - sulfonamide | Antimicrobiology - S2 Get data to collect - Request - 1.2. Known allergy - sulfonamide
Antimicrobiology - S2 Get data to collect - Request - 1.3. Considered treatment - clindamycin | Antimicrobiology - S2 Get data to collect - Request - 1.3. Considered treatment - clindamycin
Antimicrobiology - S2 Get data to collect - Response - 1. Bundle | Antimicrobiology - S2 Get data to collect - Response - 1. Bundle
Antimicrobiology - S2 Get data to collect - Response - 1.1. RequestGroup | Antimicrobiology - S2 Get data to collect - Response - 1.1. RequestGroup
Antimicrobiology - S2 Get data to collect - Response - 1.2. Task for collecting information | Antimicrobiology - S2 Get data to collect - Response - 1.2. Task for collecting information
Antimicrobiology - S2 Get data to collect - Response - 1.3. Questionnaire | Antimicrobiology - S2 Get data to collect - Response - 1.3. Questionnaire
Antimicrobiology - S3 Get Recommendations - Request- 1. Bundle | Antimicrobiology - S3 Get Recommendations - Request- 1. Bundle
Antimicrobiology - S3 Get Recommendations - Request- 1.1. QuestionnaireResponse | Antimicrobiology - S3 Get Recommendations - Request- 1.1. QuestionnaireResponse
Antimicrobiology - S3 Get Recommendations - Response - 1. Bundle | Antimicrobiology - S3 Get Recommendations - Response - 1. Bundle
Antimicrobiology - S3 Get Recommendations - Response - 1.1. RequestGroup | Antimicrobiology - S3 Get Recommendations - Response - 1.1. RequestGroup
Antimicrobiology - S3 Get Recommendations - Response - 1.1.1. option 1 - Generic Antibiotic Advice | Antimicrobiology - S3 Get Recommendations - Response - 1.1.1. option 1 - Generic Antibiotic Advice
Antimicrobiology - S3 Get Recommendations - Response - 1.1.2. option 2 - metronidazol | Antimicrobiology - S3 Get Recommendations - Response - 1.1.2. option 2 - metronidazol
Antimicrobiology - S3 Get Recommendations - Response - 1.1.3. option 3.1 - Clindamycine ovule | Antimicrobiology - S3 Get Recommendations - Response - 1.1.3. option 3.1 - Clindamycine ovule
Antimicrobiology - S3 Get Recommendations - Response - 1.1.4. option 4 - fluconazol | Antimicrobiology - S3 Get Recommendations - Response - 1.1.4. option 4 - fluconazol
Antimicrobiology - S3 Get Recommendations - Response - 1.1.5. option 5 - miconazol | Antimicrobiology - S3 Get Recommendations - Response - 1.1.5. option 5 - miconazol
Pregnancy Codes | Pregnancy Codes - used for EHRs to consider pregnancy status

### Examples - Radiology

Radiology PSS resource examples

Anonymised Patient R | Example anonymised patient R
Radiology - S1 Get Diagnoses - Request - 1. Bundle | Radiology - S1 Get Diagnoses - Request - 1. Bundle
Radiology - S1 Get Diagnoses - Request - 1.1. Observed data | Radiology - S1 Get Diagnoses - Request - 1.1. Observed data
Radiology - S1 Get Diagnoses - Request - 1.3 Original suggestion - CT head wo IV contrast | Radiology - S1 Get Recommendations - Request - 1.3 Original suggestion - CT head wo IV contrast
Radiology - S1 Get Diagnoses - Response - 1. Bundle | Radiology - S1 Get Diagnoses - Response - 1. Bundle
Radiology - S1 Get Diagnoses - Response - 1.1. RequestGroup with options | Radiology - S1 Get Diagnoses - Response - 1.1. RequestGroup with options
Radiology - S1 Get Diagnoses - Response - 1.10. Task to propose diagnosis - Post-trauma ataxia | Radiology - S1 Get Diagnoses - Response - 1.10. Task to propose diagnosis - Post-trauma ataxia
Radiology - S1 Get Diagnoses - Response - 1.11. Diagnosis - Post-trauma ataxia | Radiology - S1 Get Diagnoses - Response - 1.11. Diagnosis - Post-trauma ataxia
Radiology - S1 Get Diagnoses - Response - 1.2. Task to propose diagnosis - Stroke | Radiology - S1 Get Diagnoses - Response - 1.2. Task to propose diagnosis - Stroke
Radiology - S1 Get Diagnoses - Response - 1.3. Diagnosis - Stroke | Radiology - S1 Get Diagnoses - Response - 1.3. Diagnosis - Stroke
Radiology - S1 Get Diagnoses - Response - 1.4. Task to propose diagnosis - Infection | Radiology - S1 Get Diagnoses - Response - 1.4. Task to propose diagnosis - Infection
Radiology - S1 Get Diagnoses - Response - 1.5. Diagnosis - Infection | Radiology - S1 Get Diagnoses - Response - 1.5. Diagnosis - Infection
Radiology - S1 Get Diagnoses - Response - 1.6. Task to propose diagnosis - Head trauma | Radiology - S1 Get Diagnoses - Response - 1.6. Task to propose diagnosis - Head trauma
Radiology - S1 Get Diagnoses - Response - 1.7. Diagnosis - Head trauma | Radiology - S1 Get Diagnoses - Response - 1.7. Diagnosis - Head trauma
Radiology - S1 Get Diagnoses - Response - 1.8. Task to propose diagnosis - Chronic or slow progression-ataxia | Radiology - S1 Get Diagnoses - Response - 1.8 Task to propose diagnosis - Chronic or slow progression-ataxia
Radiology - S1 Get Diagnoses - Response - 1.9. Diagnosis - Chronic or slow progression-ataxia | Radiology - S1 Get Diagnoses - Response - 1.9. Diagnosis - Chronic or slow progression-ataxia
Radiology - S3 Get Recommendations - Request- 1. request Bundle | Radiology - S3 Get Recommendations - Request - 1. request Bundle
Radiology - S3 Get Recommendations - Request- 1.1. Initial diagnosis of head trauma | Radiology - S3 Get Recommendations - Request- 1.1. Initial diagnosis of head trauma
Radiology - S3 Get Recommendations - Request- 1.2 Scored procedure from initially considered: CT head wo IV contrast | Radiology - S3 Get Recommendations - Request- 1.2. Initially considered procedure: CT head wo IV contrast
Radiology - S3 Get Recommendations - Response - 1. Bundle | Radiology - S3 Get Recommendations - Response - 1. Bundle
Radiology - S3 Get Recommendations - Response - 1.1. RequestGroup | Radiology - S3 Get Recommendations - Response - 1.1. RequestGroup
Radiology - S3 Get Recommendations - Response - 1.2 Scored procedure option 1 (original suggestion) - CT head wo IV contrast | Radiology - S3 Get Recommendations - Response - 1.2 Scored procedure option 1 (original suggestion) - CT head wo IV contrast
Radiology - S3 Get Recommendations - Response - 1.3 Scored procedure option 3 - CT head wo/w iv contrast | Radiology - S3 Get Recommendations - Response - 1.3 Scored procedure option 3 - CT head wo/w iv contrast
Radiology - S3 Get Recommendations - Response - 1.4 Scored procedure option 2 - MR head wo iv contrast | Radiology - S3 Get Recommendations - Response - 1.4 Scored procedure option 2 - MR head wo iv contrast

### Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

PSS Provider System Capability Statement | CapabilityStatement for PSS provider systems.

### Behavior: Search Parameters

These define the properties by which a RESTful server can be searched. They can also be used for sorting and including related resources.

requestgroup-action | Resources referenced anywhere in RequestGroup.action[*.].resource (supports one level of nested actions).

### Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

PSS Feedback Task | Task to collect feedback on PSS suggestions
PSS Response Bundle | The PSS Response Bundle is used to return data from the PSS system.

### Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Bacterial Codes | Bacterial Codes
Candida Codes | Candida Codes
Chlamydia Codes | Chlamydia Codes
CompromisedImmuneSystem Codes | CompromisedImmuneSystem Codes
Gonokok Codes | Gonokok Codes
Mycoplasma Codes | Mycoplasma Codes
OncologyPatient Codes | OncologyPatient Codes
Other Codes | Other Codes
PSS Exception ValueSet | ValueSet including exception codes for Patient Summary (PSS).
PSS Feedback Code Reasons | Feedback code reasons for PSS
PSS Feedback Codes | Feedback codes for PSS
Trichomonas Codes | Trichomonas Codes
Types of rating provided by the PSS system | ValueSet - Types of rating provided by the PSS system

### Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

CodeSystem: Types of rating provided by the PSS system | CodeSystem: Types of rating provided by the PSS system
PSS Bundle Tags | PSS Bundle Tags - Feedback, Recommendation
PSS Exception Codes | Exception codes for Patient Summary (PSS) processing.
PSS Feedback Codes | Feedback codes for PSS
PSS-QSI condition codes | Condition codes from the QSI system
PSS-QSI procedure codes | Procedure codes from the QSI system
PSSa Feedback Code Reasons | Feedback code reasons for PSS antimicrobial
PSSr Feedback Code Reasons | Feedback code reasons for PSS radiology

### Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Antimicrobial - Select another option that is not in the recommendations | Prescriber decides to use another treatment that is not in the PSS recommendations
Antimicrobial - Select green recommendation | Prescriber selects a green antimicrobial recommendation
Antimicrobial - Select red recommendation | Prescriber selects an red antimicrobial recommendation with a reason
Antimicrobial feedback - green recommendation | Prescriber selects a green antimicrobial recommendation
Antimicrobial feedback - red recommendation | Prescriber selects an red antimicrobial recommendation with a reason
Antimicrobiology - S3 Get Recommendations - Response - 1.1.3. option 3.2 - Clindamycine vaginale crème | Antimicrobiology - S3 Get Recommendations - Response - 1.1.3. option 3.2 - Clindamycine vaginale crème
Example of feedback on a PSS suggestion | Example of how to provide feedback on a PSS suggestion, including the outcome of the suggestion and the reason for overriding it.
Radiology - Select green recommendation | Prescriber selects a green recommendation
Radiology - Select orange recommendation | Prescriber selects an orange recommendation
Radiology - Select other recommendation | Prescriber selects an other recommendation
Radiology feedback |
alternative-request |
alternative-request-bundle |