Business Rules

DHDR Consumer Data Query Business Rules

The following Business rules should be considered for implementation:

Yogi ID	Business Rule
DHDR-BR-DO-001	Dispensed Date should be supported if provided by the PoS application. The dispensed date should allow for a date range (FROM date and TO date). If Dispensed Date is not provided by the PoS application, the DHDR response shall provide the records for the last 120 days
DHDR-BR-DO-003	When searching the DHDR, if the same record/event is found in community pharmacy dispensed data and HNS data, DHDR returns the community pharmacy dispensed record only.

Here is the list of query parameters and data elements with descriptions that consumers may expect from DHDR.

The following table summarizes the mandatory and optional parameters for the query

Mandatory Parameters:

Data Element	Definition	Example
Patient identifier	Only the 10 digit Ontario health card number (HCN) is allowed as an ID parameter in the current release. Note: HCN Version is not supported. DHDR uses Ontario HCN for unique identification of a patient while a version number is usually used for verification of the provincial coverage eligibility, which is out of scope for DHDR.	3821694372
Composition Type	This parameter specifies the type of document	http://loinc.org 29550-1 (Medication Dispense) http://loinc.org 80565-5 (Medication Administration)

Optional Parameter:

Data Element	Definition	Example
whenprepared	This parameter contains the dispensed date of the substance. Note: If there is no lower limit in the search request, the server will use a configured default, e.g. 120 days back.	gt2015-02-24
Gender	This parameter should contain the sex at birth as noted on the Ontario health card number	male or female
Birth Date	This parameter should contain the date of birth of the patient as on the Ontario health card number	1929-11-29
effective-time	This parameter contains the administration time of the medication. Note: If there is no lower limit in the search request, the server will use the default configuration value of 120 days for hospital administration medication query.	2015-01-15T04:30:00+01:00