PrescribeIT® Specification and Guide Version 5.0


v5.0 of this specification has been superseded by v5.3. v5.3 is compatible but adds additional features for Quebec.

The version (Bundle.meta.tag:version) that is sent in the message will remain PrescribeIT5.0

 

PrescribeIT® eRx Pharmacy Management System

(Requirements Definition)

http://prescribeit.ca/fhir/Conformance/conformance-erx-pms Published: 2016-06-03 (draft)

Published by: Canada Health Infoway

This role defines the capabilities of Pharmacy Management Systems (EMRs) that participate in the Shared Health http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text. PMSs are systems that can fill medication and device prescriptions. They also create renewal requests, request management of prescriptions and may respond to advice requests. This role interoperates by creating and submitting messages and by polling for messages from other participants. This Conformance statement builds on the conformance-common-pos Conformance statement which the PMS must also comply with.

General

FHIR Version: $ver$
Supported formats: xml

REST behavior

Operations:



Messaging

Messages are sent by POSTing them to the Bundle end-point of PrescribeIT® Switch. They are received by querying the Bundle endpoint for all current messages and then subsequently deleting messages that have been successfully retrieved and committed.

Event Category Mode Focus Request Response Notes
Consequence sender Task http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999

This message allows the transmission of one or more tasks from a PMS system to an EMR or another PMS system. A response is only sent if the receiver has an inability to parse or otherwise consume the received message.

Notification receiver OperationOutcome

This message allows the EMR to indicate that it was uable to process a received message

Consequence receiver Task http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999

This message allows the receipt of one or more tasks from an EMR system or another PMS. The response is only sent if the receiver has an inability to parse or otherwise consume the received message.

Consequence receiver Task http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997

This message allows the transmission of a Communication from the PoS system to another PoS system. The PoS will only get a response if the receiver has an inability to parse or otherwise consume the received message or cannot deliver it to one of the intended recipients. In addition to receiving back a 997, the system may also receive back a 998 (FHIR STU 2 does not support the declaration of multiple response messages so it's not listed in the table.)

Consequence receiver Task http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999

This message allows the receipt of one or more tasks from an EMR system that were not targeted to a specific PMS. A response is only sent if the receiver has an inability to parse or otherwise consume the received message.

Notification sender

This message allows the PoS to reject the receipt of a particular 305 message. Potential reasons include: patient not recognized, message was directed to the wrong system, system is currently unable to process the message, message fails validation checks, etc.

Notification receiver

This message indicates that the PoS system that was an identified recipient of a 301 message did not receive it. Potential reasons include: attachments were not received, attachments failed virus checking, system failure of the inbox, etc.

Raw XML


<Conformance xmlns="http://hl7.org/fhir">
  <id value="conformance-erx-pms"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <h2>PrescribeIT® eRx Pharmacy Management System</h2>
      <p>(Requirements Definition)</p>
      <p>http://prescribeit.ca/fhir/Conformance/conformance-erx-pms Published: 2016-06-03 (draft)</p>
      <p>Published by: <b>Canada Health Infoway</b>
      </p>
      <p>This role defines the capabilities of Pharmacy Management Systems (EMRs) that participate in the Shared Health http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text.  PMSs are systems that can fill medication and device prescriptions.  They also create renewal requests, request management of prescriptions and may respond to advice requests. This role interoperates by creating and submitting messages and by polling for messages from other participants. This Conformance statement builds on the conformance-common-pos Conformance statement which the PMS must also comply with.</p>
      <h2>General</h2>
      <div class="table-wrapper">
        <table>
          <tbody>
            <tr>
              <th>FHIR Version:</th>
              <td>$ver$</td>
            </tr>
            <tr>
              <th>Supported formats:</th>
              <td>xml</td>
            </tr>
          </tbody>
        </table>
      </div>
      <h2>REST  behavior</h2>
      <p>
        <b>Operations:</b>
      </p>
      <ul>
        <li>
          <a href="http://prescribeit.ca/fhir/operationdefinition/formulary">formulary</a>
        </li>
      </ul>
      <br/>
      <br/>
      <h2>Messaging</h2>
      <p>Messages are sent by POSTing them to the Bundle end-point of PrescribeIT® Switch.  They are received by querying the Bundle endpoint for all current messages and then subsequently deleting messages that have been successfully retrieved and committed.</p>
      <div class="table-wrapper">
        <table class="grid">
          <thead>
            <tr>
              <th>Event</th>
              <th>Category</th>
              <th>Mode</th>
              <th>Focus</th>
              <th>Request</th>
              <th>Response</th>
              <th>Notes</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td/>
              <td>Consequence</td>
              <td>sender</td>
              <td>Task</td>
              <td/>
              <td>
                <a href="../common/interaction-bundle-999.html">http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999</a>
              </td>
              <td>
                <p>This message allows the transmission of one or more tasks from a PMS system to an EMR or another PMS system.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message.</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Notification</td>
              <td>receiver</td>
              <td>OperationOutcome</td>
              <td/>
              <td/>
              <td>
                <p>This message allows the EMR to indicate that it was uable to process a received message</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Consequence</td>
              <td>receiver</td>
              <td>Task</td>
              <td/>
              <td>
                <a href="../common/interaction-bundle-999.html">http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999</a>
              </td>
              <td>
                <p>This message allows the receipt of one or more tasks from an EMR system or another PMS.  The response is only sent if the receiver has an inability to parse or otherwise consume the received message.</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Consequence</td>
              <td>receiver</td>
              <td>Task</td>
              <td/>
              <td>
                <a href="../common/interaction-bundle-997.html">http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997</a>
              </td>
              <td>
                <p>This message allows the transmission of a Communication from the PoS system to another PoS system.  The PoS will only get a response if the receiver has an inability to parse or otherwise consume the received message or cannot deliver it to one of the intended recipients.  In addition to receiving back a 997, the system may also receive back a 998 (FHIR STU 2 does not support the declaration of multiple response messages so it's not listed in the table.)</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Consequence</td>
              <td>receiver</td>
              <td>Task</td>
              <td/>
              <td>
                <a href="../common/interaction-bundle-999.html">http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999</a>
              </td>
              <td>
                <p>This message allows the receipt of one or more tasks from an EMR system that were not targeted to a specific PMS.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message.</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Notification</td>
              <td>sender</td>
              <td/>
              <td/>
              <td/>
              <td>
                <p>This message allows the PoS to reject the receipt of a particular 305 message.  Potential reasons include: patient not recognized, message was directed to the wrong system, system is currently unable to process the message, message fails validation checks, etc.</p>
              </td>
            </tr>
            <tr>
              <td/>
              <td>Notification</td>
              <td>receiver</td>
              <td/>
              <td/>
              <td/>
              <td>
                <p>This message indicates that the PoS system that was an identified recipient of a 301 message did not receive it.  Potential reasons include: attachments were not received, attachments failed virus checking, system failure of the inbox, etc.</p>
              </td>
            </tr>
          </tbody>
        </table>
      </div>
    </div>
  </text>
  <url value="http://prescribeit.ca/fhir/Conformance/conformance-erx-pms"/>
  <version value="5.0"/>
  <name value="PrescribeIT® eRx Pharmacy Management System"/>
  <status value="draft"/>
  <date value="2016-06-03T00:00:00-04:00"/>
  <publisher value="Canada Health Infoway"/>
  <contact>
    <telecom>
      <system value="other"/>
      <value value="http://prescribeit.ca"/>
    </telecom>
  </contact>
  <description
               value="This role defines the capabilities of Pharmacy Management Systems (EMRs) that participate in the Shared Health http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text.  PMSs are systems that can fill medication and device prescriptions.  They also create renewal requests, request management of prescriptions and may respond to advice requests. This role interoperates by creating and submitting messages and by polling for messages from other participants. This Conformance statement builds on the conformance-common-pos Conformance statement which the PMS must also comply with."/>
  <kind value="requirements"/>
  <fhirVersion value="1.4.0"/>
  <acceptUnknown value="extensions"/>
  <format value="xml"/>
  <rest>
    <mode value="client"/>
    <operation>
      <name value="formulary"/>
      <definition>
        <reference
                   value="http://prescribeit.ca/fhir/OperationDefinition/formulary"/>
      </definition>
    </operation>
  </rest>
  <messaging>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="201"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Consequence"/>
      </extension>
      <extension url="mode">
        <valueCode value="sender"/>
      </extension>
      <extension url="focus">
        <valueString value="Task"/>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-201"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the transmission of one or more tasks from a PMS system to an EMR or another PMS system.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="999"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Notification"/>
      </extension>
      <extension url="mode">
        <valueCode value="receiver"/>
      </extension>
      <extension url="focus">
        <valueString value="OperationOutcome"/>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <display value="N/A"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the EMR to indicate that it was uable to process a received message"/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="101"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Consequence"/>
      </extension>
      <extension url="mode">
        <valueCode value="receiver"/>
      </extension>
      <extension url="focus">
        <valueString value="Task"/>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-101"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the receipt of one or more tasks from an EMR system or another PMS.  The response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="305"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Consequence"/>
      </extension>
      <extension url="mode">
        <valueCode value="receiver"/>
      </extension>
      <extension url="focus">
        <valueString value="Task"/>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-305"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the transmission of a Communication from the PoS system to another PoS system.  The PoS will only get a response if the receiver has an inability to parse or otherwise consume the received message or cannot deliver it to one of the intended recipients.  In addition to receiving back a 997, the system may also receive back a 998 (FHIR STU 2 does not support the declaration of multiple response messages so it&#39;s not listed in the table.)"/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="401"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Consequence"/>
      </extension>
      <extension url="mode">
        <valueCode value="receiver"/>
      </extension>
      <extension url="focus">
        <valueString value="Task"/>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-401"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the receipt of one or more tasks from an EMR system that were not targeted to a specific PMS.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="997"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Notification"/>
      </extension>
      <extension url="mode">
        <valueCode value="sender"/>
      </extension>
      <extension url="focus">
        <valueCode>
          <extension
                     url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
            <valueCode value="unsupported"/>
          </extension>
        </valueCode>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <display value="N/A"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message allows the PoS to reject the receipt of a particular 305 message.  Potential reasons include: patient not recognized, message was directed to the wrong system, system is currently unable to process the message, message fails validation checks, etc."/>
      </extension>
    </extension>
    <extension
               url="http://hl7.org/fhir/1.0/StructureDefinition/extension-Conformance.messaging.event">
      <extension url="code">
        <valueCoding>
          <system
                  value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
          <code value="998"/>
        </valueCoding>
      </extension>
      <extension url="category">
        <valueCode value="Notification"/>
      </extension>
      <extension url="mode">
        <valueCode value="receiver"/>
      </extension>
      <extension url="focus">
        <valueCode>
          <extension
                     url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
            <valueCode value="unsupported"/>
          </extension>
        </valueCode>
      </extension>
      <extension url="request">
        <valueReference>
          <reference
                     value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-998"/>
        </valueReference>
      </extension>
      <extension url="response">
        <valueReference>
          <display value="N/A"/>
        </valueReference>
      </extension>
      <extension url="documentation">
        <valueString
                     value="This message indicates that the PoS system that was an identified recipient of a 301 message did not receive it.  Potential reasons include: attachments were not received, attachments failed virus checking, system failure of the inbox, etc."/>
      </extension>
    </extension>
    <documentation
                   value="Messages are sent by POSTing them to the Bundle end-point of PrescribeIT® Switch.  They are received by querying the Bundle endpoint for all current messages and then subsequently deleting messages that have been successfully retrieved and committed."/>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="201"/>
      </code>
      <category value="Consequence"/>
      <mode value="sender"/>
      <focus value="Task"/>
      <request>
        <reference
                   value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-201"/>
      </request>
      <response>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
      </response>
      <documentation
                     value="This message allows the transmission of one or more tasks from a PMS system to an EMR or another PMS system.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="999"/>
      </code>
      <category value="Notification"/>
      <mode value="receiver"/>
      <focus value="OperationOutcome"/>
      <request>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
      </request>
      <response>
        <display value="N/A"/>
      </response>
      <documentation
                     value="This message allows the EMR to indicate that it was uable to process a received message"/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="101"/>
      </code>
      <category value="Consequence"/>
      <mode value="receiver"/>
      <focus value="Task"/>
      <request>
        <reference
                   value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-101"/>
      </request>
      <response>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
      </response>
      <documentation
                     value="This message allows the receipt of one or more tasks from an EMR system or another PMS.  The response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="305"/>
      </code>
      <category value="Consequence"/>
      <mode value="receiver"/>
      <focus value="Task"/>
      <request>
        <reference
                   value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-305"/>
      </request>
      <response>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997"/>
      </response>
      <documentation
                     value="This message allows the transmission of a Communication from the PoS system to another PoS system.  The PoS will only get a response if the receiver has an inability to parse or otherwise consume the received message or cannot deliver it to one of the intended recipients.  In addition to receiving back a 997, the system may also receive back a 998 (FHIR STU 2 does not support the declaration of multiple response messages so it&#39;s not listed in the table.)"/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="401"/>
      </code>
      <category value="Consequence"/>
      <mode value="receiver"/>
      <focus value="Task"/>
      <request>
        <reference
                   value="http://prescribeit.ca/fhir/StructureDefinition/interaction-bundle-401"/>
      </request>
      <response>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999"/>
      </response>
      <documentation
                     value="This message allows the receipt of one or more tasks from an EMR system that were not targeted to a specific PMS.  A response is only sent if the receiver has an inability to parse or otherwise consume the received message."/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="997"/>
      </code>
      <category value="Notification"/>
      <mode value="sender"/>
      <focus>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
          <valueCode value="unsupported"/>
        </extension>
      </focus>
      <request>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-997"/>
      </request>
      <response>
        <display value="N/A"/>
      </response>
      <documentation
                     value="This message allows the PoS to reject the receipt of a particular 305 message.  Potential reasons include: patient not recognized, message was directed to the wrong system, system is currently unable to process the message, message fails validation checks, etc."/>
    </event>
    <event>
      <code>
        <system
                value="https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents"/>
        <code value="998"/>
      </code>
      <category value="Notification"/>
      <mode value="receiver"/>
      <focus>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
          <valueCode value="unsupported"/>
        </extension>
      </focus>
      <request>
        <reference
                   value="http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-998"/>
      </request>
      <response>
        <display value="N/A"/>
      </response>
      <documentation
                     value="This message indicates that the PoS system that was an identified recipient of a 301 message did not receive it.  Potential reasons include: attachments were not received, attachments failed virus checking, system failure of the inbox, etc."/>
    </event>
  </messaging>
</Conformance>