diff --git a/SUMMARY.md b/SUMMARY.md index e602a94f3..db56eaf6c 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -431,6 +431,7 @@ * [Pharmacies Synchronization](modules/eprescription/pharmacies-synchronization.md) * [Prescribing](modules/eprescription/prescribing/README.md) * [NewRx Message](modules/eprescription/prescribing/newrx-message.md) + * [Compound Medications](modules/eprescription/prescribing/compound-medications.md) * [CancelRx Message](modules/eprescription/prescribing/cancelrx-message.md) * [RxFillIndicatorChange Message](modules/eprescription/prescribing/rx-fill-indicator-change.md) * [Pharmacy-initiated messages](modules/eprescription/prescribing/pharmacy-initiated-messages/README.md) @@ -446,6 +447,7 @@ * [List Permissions](modules/eprescription/epcs/access-management/list-permissions.md) * [Access-Change Requests](modules/eprescription/epcs/access-management/access-change-requests.md) * [Location Compliance Status](modules/eprescription/epcs/access-management/location-compliance-status.md) + * [DEA Schedules](modules/eprescription/epcs/dea-schedules.md) * [Practitioner Log](modules/eprescription/epcs/practitioner-log.md) * [Directory](modules/eprescription/directory/README.md) * [DirectoryDownload Message](modules/eprescription/directory/directorydownload-message.md) diff --git a/docs/modules/eprescription/epcs/README.md b/docs/modules/eprescription/epcs/README.md index a44bf4ffc..c7ee1b073 100644 --- a/docs/modules/eprescription/epcs/README.md +++ b/docs/modules/eprescription/epcs/README.md @@ -10,4 +10,5 @@ The module does not support prescribing controlled substances yet, but we are wo * [Enable EPCS](enable-epcs.md): configure the module and your EHR so that prescribers can sign controlled prescriptions. * [EPCS Access Management](access-management/README.md): appoint the people who manage EPCS access at each location. +* [DEA Schedules](dea-schedules.md): store DEA schedules on medications and compound ingredients. * [Practitioner Log](practitioner-log.md): retrieve the controlled prescriptions a practitioner signed in a period. diff --git a/docs/modules/eprescription/epcs/dea-schedules.md b/docs/modules/eprescription/epcs/dea-schedules.md new file mode 100644 index 000000000..9ae585235 --- /dev/null +++ b/docs/modules/eprescription/epcs/dea-schedules.md @@ -0,0 +1,88 @@ +--- +description: Store DEA schedules on medications and compound ingredients, and see how the Aidbox ePrescription module classifies a controlled prescription from them. +--- + +# DEA Schedules + +The module treats a prescription as a **controlled prescription** when its medication has a DEA schedule. + +## Store a DEA Schedule + +Store the schedule in the `http://aidbox.app/ePrescription/FHIRSchema/medication-dea-schedule` extension of the medication code: + +* `MedicationRequest.medicationCodeableConcept` for a prescription without a `Medication` resource +* `Medication.code` +* `Medication.ingredient.itemCodeableConcept` for each scheduled ingredient of a compound (see [Ingredient Schedules](../prescribing/compound-medications.md#ingredient-schedules)) + +
+ +Schedule extension example + +```json +{ + "url": "http://aidbox.app/ePrescription/FHIRSchema/medication-dea-schedule", + "valueCodeableConcept": { + "coding": [ + { + "system": "http://terminology.hl7.org/CodeSystem/v2-0477", + "code": "II", + "display": "Schedule II" + } + ] + } +} +``` + +
+ +## Schedules in NCPDP Messages + +The module sends each schedule in `DEASchedule/Code` as its NCI Thesaurus (NCIt) code: + +* `I`: `C48672` +* `II`: `C48675` +* `III`: `C48676` +* `IV`: `C48677` +* `V`: `C48679` + +`DrugCoded/DEASchedule` carries the schedule of the prescription: + +* for a compound, the strictest ingredient schedule +* for any other medication, the schedule stored on its code + +`CompoundIngredient/DEASchedule` carries the schedule of each ingredient. + +## Schedule Checks + +When EPCS is disabled (`EPCS_MODE=disabled`), the module rejects a controlled prescription with `epcs-disabled`, including a compound with a scheduled ingredient. + +A request that fails a check returns `422` with an `OperationOutcome`. + +
+ +Error Responses + +* The medication code (`Medication.code` or `MedicationRequest.medicationCodeableConcept`): + * `medication-has-multiple-dea-schedules`: the code has more than one schedule extension, or more than one coding under `http://terminology.hl7.org/CodeSystem/v2-0477` in one extension. + * `dea-schedule-coding-system-is-not-supported`: a schedule extension has codings, and none of them is a coding under `http://terminology.hl7.org/CodeSystem/v2-0477` that has a code. + * `controlled-substance-invalid-dea-schedule`: the schedule is not one of `I` to `V`. + +Example response for `controlled-substance-invalid-dea-schedule`: + +```json +{ + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "text": "Controlled substance DEASchedule must be one of I, II, III, IV, V" + }, + "diagnostics": "null" + } + ] +} +``` + +
diff --git a/docs/modules/eprescription/prescribing/compound-medications.md b/docs/modules/eprescription/prescribing/compound-medications.md new file mode 100644 index 000000000..317509f47 --- /dev/null +++ b/docs/modules/eprescription/prescribing/compound-medications.md @@ -0,0 +1,121 @@ +--- +description: Represent a compound medication in FHIR, store the DEA schedules and NDCs of its ingredients, and see the checks the Aidbox ePrescription module runs on it. +--- + +# Compound Medications + +The module treats a `Medication` as a compound when either of these is true: + +* its `http://aidbox.app/ePrescription/FHIRSchema/medication-is-compound` extension has `valueBoolean: true` +* it has `ingredient` entries and `Medication.code` has no National Drug Code (NDC) coding + +## Ingredient NDCs + +Store an 11-digit NDC for each scheduled ingredient as a coding under `http://hl7.org/fhir/sid/ndc` in its `itemCodeableConcept`. + +## Ingredient Schedules + +Store the schedule of each scheduled ingredient in the [DEA schedule extension](../epcs/dea-schedules.md#store-a-dea-schedule) of its `Medication.ingredient.itemCodeableConcept`. + +A prescription whose compound has at least one scheduled ingredient is a [controlled prescription](../epcs/dea-schedules.md). +Its schedule is the strictest ingredient schedule. +`I` is the strictest and `V` the least strict, so a compound with a Schedule II and a Schedule IV ingredient follows the rules of Schedule II. + +A schedule on `Medication.code` of a compound is optional. +When you store one, it must equal the strictest ingredient schedule. +The module never classifies a compound by that schedule. + +Only an active ingredient can have a schedule, so leave the extension out of an ingredient with `isActive: false`. + +
+ +Compound with a scheduled ingredient + +```json +{ + "resourceType": "Medication", + "id": "compound-example", + "code": { + "text": "Hydrocodone 1 mg/mL in oral suspension base" + }, + "extension": [ + { + "url": "http://aidbox.app/ePrescription/FHIRSchema/medication-is-compound", + "valueBoolean": true + } + ], + "ingredient": [ + { + "itemCodeableConcept": { + "text": "Hydrocodone bitartrate powder", + "coding": [ + { + "system": "http://hl7.org/fhir/sid/ndc", + "code": "38779052405" + } + ], + "extension": [ + { + "url": "http://aidbox.app/ePrescription/FHIRSchema/medication-dea-schedule", + "valueCodeableConcept": { + "coding": [ + { + "system": "http://terminology.hl7.org/CodeSystem/v2-0477", + "code": "II" + } + ] + } + } + ] + }, + "isActive": true + }, + { + "itemCodeableConcept": { + "text": "Oral suspension base" + }, + "isActive": false + } + ] +} +``` + +
+ +## Compound Checks + +
+ +Error Responses + +* The compound's `Medication.code`: + * `compound-root-dea-schedule-without-ingredient-schedules`: the code of a compound has a schedule, and no ingredient has one. + * `compound-root-dea-schedule-mismatch`: the code of a compound has a schedule other than the strictest ingredient schedule. +* A compound ingredient: + * `compound-ingredient-has-multiple-dea-schedules`: the ingredient has more than one schedule extension, or more than one coding under `http://terminology.hl7.org/CodeSystem/v2-0477` in one extension. + * `compound-ingredient-dea-schedule-coding-system-is-not-supported`: a schedule extension has codings, and none of them is under `http://terminology.hl7.org/CodeSystem/v2-0477`. + * `compound-ingredient-invalid-dea-schedule`: the schedule is not one of `I` to `V`, or a schedule extension's codings under `http://terminology.hl7.org/CodeSystem/v2-0477` have no code. + * `compound-inactive-ingredient-has-dea-schedule`: an ingredient with `isActive: false` has a schedule. +* A scheduled ingredient of a compound: + * `controlled-compound-ingredient-missing-ndc`: the ingredient has no coding under `http://hl7.org/fhir/sid/ndc`. + * `controlled-compound-ingredient-invalid-ndc`: the ingredient's NDC coding has no code, or its code does not have 11 digits. + +Example response for `controlled-compound-ingredient-missing-ndc` on the first ingredient of the compound above: + +```json +{ + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "text": "Compound ingredient with a DEASchedule must include an NDC" + }, + "diagnostics": "{\"in\":[\"Medication\",\"ingredient\",0],\"resourceType\":\"Medication\",\"id\":\"compound-example\"}" + } + ] +} +``` + +