DaVinci Payer Data Exchange (PDex) US Drug Formulary
1.1.0 - STU 1.1

Publication Build: This will be filled in by the publication tooling

## Change Notes

### Changes and Updates for Version 1.1.0

The current official published version of Da Vinci Payer Data Exchange (PDex) US Drug Formulary for FHIR R4 (STU Update of STU 1)

This STU Update addressed several fixes, technical corrections, errata, and clarifications listed below.

To make a comment on the STU Update:

1. Create a new Jira tracker (New trackers can be made by clicking on the link in the page footer entitled "Propose a change" and clicking the "Create" button at the top of the Jira page)
2. Select "US Da Vinci PDex Formulary (FHIR)" as the Specification and fill in other relevant information.
3. Include the related Jira issue in the "Related Issues" section on the "Advanced" tab.

The following issues are to be 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 paramteter for the Medication Knowledge and List resouce 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 resouce in a future release instead of the List resource.

- FHIR-32625:

  Chanegs 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 indicaitng 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 medicatioin 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.