Content Repository Management Infrastructure Implementation Guide
3.0.0-ballot - STU 3 Ballot International flag

Content Repository Management Infrastructure Implementation Guide, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/crmi-ig/ and changes regularly. See the Directory of published versions

: MME Conversion Factors Supplement Example

Page standards status: Informative

Raw xml | Download


<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="mme-conversion-factors-example"/>
  <meta>
    <profile
             value="http://hl7.org/fhir/StructureDefinition/shareablecodesystem|4.0.2"/>
    <profile
             value="http://hl7.org/fhir/StructureDefinition/publishablecodesystem"/>
    <profile
             value="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-shareablecodesystem"/>
    <profile
             value="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-publishablecodesystem"/>
  </meta>
  <language value="en"/>
  <text>
    <status value="generated"/>
    <div xml:lang="en" xmlns="http://www.w3.org/1999/xhtml" lang="en"><p class="res-header-id"><b>Generated Narrative: CodeSystem mme-conversion-factors-example</b></p><a name="mme-conversion-factors-example"> </a><a name="hcmme-conversion-factors-example"> </a><div style="display: inline-block; background-color: #fbffeb; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px">Language: en</p><p style="margin-bottom: 0px">Profiles: <a href="StructureDefinition-shareablecodesystem.html">Shareable CodeSystem</a> version: 4.0.2, <a href="StructureDefinition-publishablecodesystem.html">Publishable CodeSystem</a>, <a href="StructureDefinition-crmi-shareablecodesystem.html">CRMI Shareable CodeSystem</a>, <a href="StructureDefinition-crmi-publishablecodesystem.html">CRMI Publishable CodeSystem</a></p></div><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>conversion-factor</td><td>conversion-factor</td><td>decimal</td><td>Defines the conversion factor for a specific ingredient, when the conversion factor is the same for all dose forms and dose amounts for the ingredient. The value of this property will be the decimal representation of the conversion factor.</td></tr><tr><td>dose-form-conversion-factor</td><td>dose-form-conversion-factor</td><td>string</td><td>Defines the conversion factor for an ingredient when the conversion factor varies by the dose form of the medication. The value of this property will be a string of the form &lt;dose-form-code&gt;:&lt;conversion-factor&gt;[@&lt;doses-per-day&gt;], e.g. 970789:130, where '970789' is the RxNorm dose form code, and '130' is the decimal representation of the conversion factor. An example of a per-day conversion factor is fentanyl, 316987:7200@0.33333333, where 316987 is RxNorm dose form code, 7200 is the conversion factor, and 0.33333333 is the dosesPerDay, expressed as a decimal with a maximum of 8 digits after the decimal.</td></tr><tr><td>dose-range-conversion-factor</td><td>dose-range-conversion-factor</td><td>string</td><td>Defines the conversion factor for an ingredient when the conversion factor varies by the overall dose of the medication. The value of this property will be a string of the form &lt;low-value&gt;-&lt;high-value&gt;:&lt;conversion-factor&gt;, e.g. 1-20:4. Note that the low-value or high-value may be a wildcard '*' to indicate the range continues (e.g. '61-*:12' indicates the range is 61 or greater).</td></tr></table><p><b>Concepts</b></p><p>This code system supplement <code>http://hl7.org/fhir/uv/crmi/CodeSystem/mme-conversion-factors-example</code> defines properties on the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>conversion-factor</b></td><td><b>dose-form-conversion-factor</b></td><td><b>dose-range-conversion-factor</b></td></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=2670">2670</a><a name="mme-conversion-factors-example-2670"> </a></td><td>Codeine</td><td>0.15</td><td/><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=4337">4337</a><a name="mme-conversion-factors-example-4337"> </a></td><td>Fentanyl</td><td/><td>316987:7200@0.33333333</td><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=5489">5489</a><a name="mme-conversion-factors-example-5489"> </a></td><td>Hydrocodone</td><td>1</td><td/><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=3423">3423</a><a name="mme-conversion-factors-example-3423"> </a></td><td>Hydromorphone</td><td>4</td><td/><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=6813">6813</a><a name="mme-conversion-factors-example-6813"> </a></td><td>Methadone</td><td/><td/><td>1-20:4, 21-40:8, 41-60:10, 61-*:12</td></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=7052">7052</a><a name="mme-conversion-factors-example-7052"> </a></td><td>Morphine</td><td>1</td><td/><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=7804">7804</a><a name="mme-conversion-factors-example-7804"> </a></td><td>Oxycodone</td><td>1.5</td><td/><td/></tr><tr><td><a style="white-space:nowrap" href="https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&amp;searchTerm=7814">7814</a><a name="mme-conversion-factors-example-7814"> </a></td><td>Oxymorphone</td><td>3</td><td/><td/></tr></table></div>
  </text>
  <url
       value="http://hl7.org/fhir/uv/crmi/CodeSystem/mme-conversion-factors-example"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.4.642.40.38.16.9"/>
  </identifier>
  <version value="3.0.0-ballot"/>
  <name value="MMEConversionFactorsExample"/>
  <title value="MME Conversion Factors Supplement Example"/>
  <status value="active"/>
  <experimental value="true"/>
  <date value="2026-11-09"/>
  <publisher value="HL7 International / Clinical Decision Support"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/committees/dss"/>
    </telecom>
  </contact>
  <description
               value="Example of an RxNorm code system supplement used to share configuration data, in this case the clinical conversion factors used to calculate Morphine Milligram Equivalents (MME), as described in the CDC Opioid Prescribing Guideline. The supplement defines a conversion factor for each opioid ingredient in one of three ways: as a direct conversion factor for the ingredient, as a dose-form-specific conversion factor, or as a dose-quantity-ranged conversion factor. All conversion factors are in 'mg/d'. This example is based on the [CDCMMEClinicalConversionFactors](https://fhir.org/guides/cdc/opioid-mme-r4/CodeSystem-CDCMMEClinicalConversionFactors.html) code system supplement published in the CDC Opioid MME implementation guide."/>
  <useContext>
    <code>
      <system
              value="http://terminology.hl7.org/CodeSystem/usage-context-type"/>
      <code value="focus"/>
      <display value="Clinical Focus"/>
    </code>
    <valueCodeableConcept>
      <coding>
        <system value="http://snomed.info/sct"/>
        <code value="182888003"/>
        <display value="Medication requested (situation)"/>
      </coding>
    </valueCodeableConcept>
  </useContext>
  <useContext>
    <code>
      <system
              value="http://terminology.hl7.org/CodeSystem/usage-context-type"/>
      <code value="focus"/>
      <display value="Clinical Focus"/>
    </code>
    <valueCodeableConcept>
      <coding>
        <system value="http://snomed.info/sct"/>
        <code value="82423001"/>
        <display value="Chronic pain (finding)"/>
      </coding>
    </valueCodeableConcept>
  </useContext>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="840"/>
      <display value="United States of America (USA)"/>
    </coding>
  </jurisdiction>
  <purpose
           value="Illustrates sharing configuration data (MME conversion factors) as properties defined in a code system supplement, so that the configuration can be distributed and versioned using the same artifact management infrastructure as the logic that uses it."/>
  <copyright
             value="Conversion factors are derived from the CDC Opioid Prescribing Guideline, Copyright 2019+ Centers for Disease Control and Prevention (CDC). This material contains content from RxNorm, which is publicly available courtesy of the U.S. National Library of Medicine (NLM)."/>
  <content value="supplement"/>
  <supplements value="http://www.nlm.nih.gov/research/umls/rxnorm"/>
  <property>
    <code value="conversion-factor"/>
    <description
                 value="Defines the conversion factor for a specific ingredient, when the conversion factor is the same for all dose forms and dose amounts for the ingredient. The value of this property will be the decimal representation of the conversion factor."/>
    <type value="decimal"/>
  </property>
  <property>
    <code value="dose-form-conversion-factor"/>
    <description
                 value="Defines the conversion factor for an ingredient when the conversion factor varies by the dose form of the medication. The value of this property will be a string of the form &lt;dose-form-code&gt;:&lt;conversion-factor&gt;[@&lt;doses-per-day&gt;], e.g. 970789:130, where '970789' is the RxNorm dose form code, and '130' is the decimal representation of the conversion factor. An example of a per-day conversion factor is fentanyl, 316987:7200@0.33333333, where 316987 is RxNorm dose form code, 7200 is the conversion factor, and 0.33333333 is the dosesPerDay, expressed as a decimal with a maximum of 8 digits after the decimal."/>
    <type value="string"/>
  </property>
  <property>
    <code value="dose-range-conversion-factor"/>
    <description
                 value="Defines the conversion factor for an ingredient when the conversion factor varies by the overall dose of the medication. The value of this property will be a string of the form &lt;low-value&gt;-&lt;high-value&gt;:&lt;conversion-factor&gt;, e.g. 1-20:4. Note that the low-value or high-value may be a wildcard '*' to indicate the range continues (e.g. '61-*:12' indicates the range is 61 or greater)."/>
    <type value="string"/>
  </property>
  <concept>
    <code value="2670"/>
    <display value="Codeine"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="0.15"/>
    </property>
  </concept>
  <concept>
    <code value="4337"/>
    <display value="Fentanyl"/>
    <property>
      <code value="dose-form-conversion-factor"/>
      <valueString value="316987:7200@0.33333333"/>
    </property>
  </concept>
  <concept>
    <code value="5489"/>
    <display value="Hydrocodone"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="1"/>
    </property>
  </concept>
  <concept>
    <code value="3423"/>
    <display value="Hydromorphone"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="4"/>
    </property>
  </concept>
  <concept>
    <code value="6813"/>
    <display value="Methadone"/>
    <property>
      <code value="dose-range-conversion-factor"/>
      <valueString value="1-20:4"/>
    </property>
    <property>
      <code value="dose-range-conversion-factor"/>
      <valueString value="21-40:8"/>
    </property>
    <property>
      <code value="dose-range-conversion-factor"/>
      <valueString value="41-60:10"/>
    </property>
    <property>
      <code value="dose-range-conversion-factor"/>
      <valueString value="61-*:12"/>
    </property>
  </concept>
  <concept>
    <code value="7052"/>
    <display value="Morphine"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="1"/>
    </property>
  </concept>
  <concept>
    <code value="7804"/>
    <display value="Oxycodone"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="1.5"/>
    </property>
  </concept>
  <concept>
    <code value="7814"/>
    <display value="Oxymorphone"/>
    <property>
      <code value="conversion-factor"/>
      <valueDecimal value="3"/>
    </property>
  </concept>
</CodeSystem>