DaVinci Payer Data Exchange (PDex) US Drug Formulary, published by HL7 International / Pharmacy. 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/davinci-pdex-formulary/ and changes regularly. See the Directory of published versions
Change Notes
Changes and Updates for Version 3.0.0-ballot
The following high level changes were addressed in this release:
- Added support for Bulk Publish and updated details on Bulk Export for compatibility with Bulk Data 4.0.0-ballot (will move to the published version when available).
- Updated PDex dependency to the 2.0.0-ballot version.
- Updated formulary guidance on authenticated lookups using the Coverage resource and corrected the Availability Status extension description.
- Updated Formulary Item search parameter naming and addressed the extensible binding of PayerInsurancePlan.type.
- Added the CPT intellectual property statement to the IG's IP statements.
Specific JIRA tickets included in this update are grouped below by the JIRA Change Impact classification:
Non-Compatible
- FHIR-48865 Add a prefix to Formulary-Item search parameters
Substantive
- FHIR-44804 PayerInsurancePlan.type extensible binding may cause issues w/use of InsurancePlan.type in client queries
Non-substantive
Changes and Updates for Version 2.1.0
The following high level changes addressed in this release:
- Updated dependencies to reference to multiple versions of US Core per latest Da Vinci recommendations (7.0.0, 6.1.0, and 3.1.1)
- Updated dependencies to reference Da Vinci HRex version 1.1.0
- Updated IG organization and structure to match the latest Da Vinci recommendations
Specific JIRA tickets applied in this update are listed below:
- FHIR-45633 DaVinci vs. Da Vinci for IG name/title/narrative
- FHIR-45443 Incorrect _include search format in examples
- FHIR-45280 Change Cardinality of PayerInsurancePlan InsurancePlan.plan:drug-plan.specificCost.benefit.cost.value
- FHIR-44796 Clients & Servers need a way to know which Payer Insurance Plan InsurancePlan.plan entries (plans) a member has access to
- FHIR-44720 Formulary Drug Profile - Add an invariant for slices on MedicationKnowledge.code.coding
- FHIR-41608 Add guidance for support of Bulk data changes
- FHIR-40542 Add "preferred" and "non-preferred" to Drug Tier Value Set
- FHIR-37717 Add guidance for granular pharmacy benefits
- FHIR-37623 String and Token Search Parameters for FormularyDrug (DrugName, DrugTier, and DrugPlan) incorrectly include the comparator "eq"
- FHIR-37587 References Plan Net InsurancePlan <> Formulary Payer Insurance Plan
- FHIR-36330 Provide more guidance for authenticated access
Changes and Updates for Version 2.0.1
The following issues are addressed in this release:
Changes and Updates for Version 2.0.0
Da Vinci Payer Data Exchange (PDex) US Drug Formulary for FHIR R4 (STU 2)
The following issues are addressed in this release:
- FHIR-33181: Changed CoveragePlan profile from using a List resource to two InsurancePlan profiles; one defining the higher level Payer Insurance Plan and the other defining the Formulary provides general information about a formulary and acts as an organizing construct to create a formulary list.
This change also addresses:
- FHIR-33182: Created a Formulary Item profile that links a drug with a drug (formulary) plan and includes the attributes that relate the two. As part of this change, several extensions moved to this profile from the Formulary Drug profile.
- FHIR-37717: Added Specific Drug Coverage Details section that includes guidance on how to provide details for drugs with different coverages but are represented by the same RxNorm code.
- FHIR-36142: Changed cardinality of usdf-PharmacyBenefitType-extension in Formulary Item profile (formerly usdf-MailOrder-extension in Formulary Drug profile) to
1..* and MS.
- FHIR-35197: Created an extension on FormularyItem profile to allow the expression of additional coverage information.
- FHIR-33186: Created an Insurance Plan Location profile for an InsurancePlan to support geolocation.
- FHIR-36143: Add invariant to Insurance Plan Location profile requiring at least an address or a geolocation.
- FHIR-29964: Added Prior Authorization new Starts Only Extension, Step Therapy New Starts Only Extension, and Quantity Limit Detail Extension on FormularyItem to support more details beyond the original boolean values.
- FHIR-33184: Improve drug searching through making MedicationKnowledge.doseform Must Support on the FormularyDrug profile and adding a doseform SearchParameter.
- FHIR-34526 and FHIR-36264: Created a Conformance Expectations section which inherits the HRex conformance expectations which includes the definition of Must Support.
- FHIR-37478: Removed US Core as a dependency (since no profiles are directly derived from US Core).
- FHIR-34527: Changes Must Support flags on the PayerInsurancePlan, Formulary, FormularyItem, FormularyDrug, and InsurancePlanLocation profiles (includes data elements included in previous version profiles on different resources).
- FHIR-36137: Made the capability expectation for Insurance Plan Location profile SHALL in the CapabilityStatement.
- FHIR-33248: Remove requirement to support HTTP error response 410 for deleted resources in server CapabilityStatement
- FHIR-36169: Add requirement in the Conformance Expectations that servers support CapabilityStatement.instantiates pointing to the included CapabilityStatement.
- FHIR-34085: Added slicing on FormularyDrug code.coding to support granular (ingredient, strength, and form) RxNorm Code and general (ingredient and form group) to enable finding drugs with different strengths and added guidance on searching formulary drugs.
- FHIR-34758: Combine the copay and coinsurance cost sharing options into a single Cost Sharing Option CodeSystem.
- FHIR-36302: Updated the BenefitCodeTypeCS, DrugTierCS, PharmacyBenefitTypeCS, and PlanContactTypeCS CodeSystems id to include "" in order to note to implementers that the URL is likely to change (to terminology.hl7.org defined CodeSystems) in the future.
- FHIR-31349: Added deductible-waived to Copay qualifier and Coinsurance qualifier CodeSystems.
- FHIR-33188 and FHIR-35367: Added guidance for Bulk Data Export.
- FHIR-37623: Remove the invalid 'eq' comparator from Drug Name Search Parameter.
- FHIR-34456: Updated the HRex references to point to version 1.0.0.
- FHIR-35196: Added guidance regarding presenting drug alternative.
- FHIR-35365: Added more descriptive descriptions to the extensions included in the FormularyItem profile.
Editorial note (previously an HTML comment):
The Following are only changes from the ballot version and final published version
FHIR-34756 - Improve the name of value set "Type of pharmacies"
FHIR-35366 - Simplify FormularyItem by inlining drug codes
Changes and Updates for Version 1.2.0
Changes and Updates for Version 1.1.0
Da Vinci Payer Data Exchange (PDex) US Drug Formulary for FHIR R4 (STU Update of STU 1)
The following issues are addressed in this release:
-
FHIR-28293: Changed the PlanID extension description to from:
“Unique, 14-character, HIOS-generated Plan ID number (Plan IDs must be unique, even across different markets.)”
to:
“Unique, generated Plan ID number, such as HIOS ID for QHPs or Contract Number for Medicare Advantage Plans. Plan IDs must be unique within each organization that manages their formulary data.”
- FHIR-29965: Added guidance that CoveragePlan.MarketingURL, CoveragePlan.SummaryURL, and CoveragePlan.FormularyURL can point to a page providing links for multiple language options.
- FHIR-30412: Changed the type of CoveragePlan.MarketingURL, CoveragePlan.SummaryURL, and CoveragePlan.FormularyURL extensions from a String value to a URL value.
- FHIR-30924: Added "Not applicable" to the usdf-CopayOptionCS code system. Zero-deductible cost sharing is represented by a co-pay value of "Not applicable" and a co-insurance value of "No charge", consistent with updated QHP guidelines.
- FHIR-30925: Added an optional boolean MailOrder extension to FormularyDrug profile. The MailOrder value in FormularyDrug overrides the MailOrder value in the DrugTierDefinition extension for CoveragePlan.
- FHIR-30933: Changed the type of EmailPlanContact extension from String to URL. We also added narrative to EmailPlanContact that a FHIR URL type can be a web-url or an email address.
- FHIR-31031: Since _profile search parameter is not required for anticipated client queries, we removed the "_profile" search parameter for the Medication Knowledge and List resource examples.
- FHIR-31037: The CoveragePlan PlanIDType extension was not defined for non-HIOS plans so we included narrative in Plan ID Type, to include "For all other plans this should be: OTHER-PLAN-ID as part of the definition.
- FHIR-31073: Added guidance for behavior for authenticated member access, when the member has already selected a plan or not, when they belong to a plan group or not.
- FHIR-31591: Changed the code display in Formulary Drug cmspi9, to "doxepin hydrochloride 50 MG/ML Topical Cream" to match the given code of #1000091.
- FHIR-31672: Added guidance to enter "Not applicable" in the Network extension for a CoveragePlan that has no applicable network associated with it.
- FHIR-31683: We changed List.code to be set to the code
DRUGPOL and changed the cardinality to 1..1 in the Formulary Coverage Plan. Additionally, in Anticipated Client Queries the queries that reference list now reference the DRUGPOL code.
- FHIR-31684: Guidance was added to Additional Guidance regarding searching for FormularyDrugs with know PlanIDs and without.
- FHIR-31762: Updated search parameter descriptions to include all of the search parameters in the CapabilityStatement.
- FHIR-32178: Added "charge" to the usdf-CopayOptionCS and the usdf-CoinsuranceOptionCScode systems to handle drugs that consist of a charge, but are not subject to a deductible.
- FHIR-32622: Guidance was added to Formulary Coverage Plan indicating that we are considering basing the CoveragePlan profile off of the InsurancePlan resource in a future release instead of the List resource.
- FHIR-32625: Changes were implemented to improve the navigation by updating the Table of Contents, the specification menu, and page design.
- FHIR-32627: Guidance was added to Search Parameters indicating that the search parameters DrugName, DrugPlan, and DrugTier will be changed to more compliant names like: lower-case 'drug-name', 'drug-plan', and 'drug-tier' in a future release.
- FHIR-32723: Several value sets found in Terminology: Code Systems were not properly displaying the value and description correctly for "code for qualifier for coinsurance rate", "codes for qualifier of copay amount" and "codes for medication drug tiers in health plans". This has been corrected. The definition column has been updated to no longer be blank and contain the proper information.
- FHIR-32958: Added guidance for searching by drug name strings.
- FHIR-32958: Added guidance on drug name searching with description of RxNorm term types, formats, and drug names that might appear on a formulary.
Changes and Updates for Version 1.0.1
- Technical correction to version 1.0.0
Changes and Updates for Version 1.0.0
Changes and Updates for Version 0.1.0
- Initial draft implementation guide for testing