Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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)
Expand Down
1 change: 1 addition & 0 deletions docs/modules/eprescription/epcs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
88 changes: 88 additions & 0 deletions docs/modules/eprescription/epcs/dea-schedules.md
Original file line number Diff line number Diff line change
@@ -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))

<details>

<summary>Schedule extension example</summary>

```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"
}
]
}
}
```

</details>

## 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`.

<details>

<summary>Error Responses</summary>

* 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"
}
]
}
```

</details>
121 changes: 121 additions & 0 deletions docs/modules/eprescription/prescribing/compound-medications.md
Original file line number Diff line number Diff line change
@@ -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`.

<details>

<summary>Compound with a scheduled ingredient</summary>

```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
}
]
}
```

</details>

## Compound Checks

<details>

<summary>Error Responses</summary>

* 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\"}"
}
]
}
```

</details>
Loading