DaVinci Payer Data Exchange (PDex) US Drug Formulary
2.1.0 - STU 3 (ci-build)
DaVinci Payer Data Exchange (PDex) US Drug Formulary
2.1.0 - STU 3 (ci-build)
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 2.1.0 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
| Page standards status: Informative |
The following high level changes addressed in this release:
Specific JIRA tickets applied in this update are listed below:
The following issues are addressed in this release:
Corrected SearchParameter-Basic-Subject by changing code from code to subject.
Changed the InsurancePlan.coverage[drug-coverage].benefit[drug-plan].type in Payer Insurance Plan from the deprecated code Drug to drug.
Changed the binding of Payer Insurance Plan PayerInsurancePlan.plan[drug-plan].specificCost.benefit.type Drug Tier VS from a required to extensible to match the Formulary Item Drug Tier binding to allow the inclusion of drug tiers beyond those identified in the IG.
Specify the contexts for all IG defined extensions.
Da Vinci Payer Data Exchange (PDex) US Drug Formulary for FHIR R4 (STU 2)
The following issues are addressed in this release:
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:
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.
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.
Changed cardinality of usdf-PharmacyBenefitType-extension in Formulary Item profile (formerly usdf-MailOrder-extension in Formulary Drug profile) to 1..* and MS.
Created an extension on FormularyItem profile to allow the expression of additional coverage information.
Created an Insurance Plan Location profile for an InsurancePlan to support geolocation.
Add invariant to Insurance Plan Location profile requiring at least an address or a geolocation.
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.
Improve drug searching through making MedicationKnowledge.doseform Must Support on the FormularyDrug profile and adding a doseform SearchParameter.
Created a Conformance Expectations section which inherits the HRex conformance expectations which includes the definition of Must Support.
Removed US Core as a dependency (since no profiles are directly derived from US Core).
Changes Must Support flags on the PayerInsurancePlan, Formulary, FormularyItem, FormularyDrug, and InsurancePlanLocation profiles (includes data elements included in previous version profiles on different resources).
Made the capability expectation for Insurance Plan Location profile SHALL in the CapabilityStatement.
Remove requirement to support HTTP error response 410 for deleted resources in server CapabilityStatement
Add requirement in the Conformance Expectations that servers support CapabilityStatement.instantiates pointing to the included CapabilityStatement.
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.
Combine the copay and coinsurance cost sharing options into a single Cost Sharing Option CodeSystem.
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.
Added deductible-waived to Copay qualifier and Coinsurance qualifier CodeSystems.
Added guidance for Bulk Data Export.
Remove the invalid 'eq' comparator from Drug Name Search Parameter.
Updated the HRex references to point to version 1.0.0.
Added guidance regarding presenting drug alternative.
Added more descriptive descriptions to the extensions included in the FormularyItem profile.
<!– 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
–>
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:
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.”
Added guidance that CoveragePlan.MarketingURL, CoveragePlan.SummaryURL, and CoveragePlan.FormularyURL can point to a page providing links for multiple language options.
Changed the type of CoveragePlan.MarketingURL, CoveragePlan.SummaryURL, and CoveragePlan.FormularyURL extensions from a String value to a URL value.
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.
Added an optional boolean MailOrder extension to FormularyDrug profile. The MailOrder value in FormularyDrug overrides the MailOrder value in the DrugTierDefinition extension for CoveragePlan.
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.
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.
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.
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.
Changed the code display in Formulary Drug cmspi9, to "doxepin hydrochloride 50 MG/ML Topical Cream" to match the given code of #1000091.
Added guidance to enter "Not applicable" in the Network extension for a CoveragePlan that has no applicable network associated with it.
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.
Guidance was added to Additional Guidance regarding searching for FormularyDrugs with know PlanIDs and without.
Updated search parameter descriptions to include all of the search parameters in the CapabilityStatement.
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.
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.
Changes were implemented to improve the navigation by updating the Table of Contents, the specification menu, and page design.
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.
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.
Added guidance for searching by drug name strings.
Added guidance on drug name searching with description of RxNorm term types, formats, and drug names that might appear on a formulary.
IG © 2022+ HL7 International / Pharmacy. Package hl7.fhir.us.davinci-drug-formulary#2.1.0 based on FHIR 4.0.1. Generated 2024-12-16
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change