Tutorial for Da Vinci Drug Formulary for Azure API for FHIR
Important
Azure API for FHIR will be retired on September 30, 2026. Follow the migration strategies to transition to Azure Health Data Services FHIR® service by that date. Due to the retirement of Azure API for FHIR, new deployments won't be allowed beginning April 1, 2025. Azure Health Data Services FHIR service is the evolved version of Azure API for FHIR that enables customers to manage FHIR, DICOM, and MedTech services with integrations into other Azure services.
In this tutorial, we walk through setting up Azure API for FHIR® to pass the Touchstone tests for the Da Vinci Payer Data Exchange US Drug Formulary Implementation Guide (IG).
Touchstone capability statement
The first test we focus on is testing Azure API for FHIR against the Da Vinci Drug Formulary capability statement. If you run this test without any updates, the test fails due to missing search parameters profiles.
Define search parameters
As part of the Da Vinci Drug Formulary IG, you need to define three new search parameters for the FormularyDrug resource. All three of these are tested in the capability statement.
The rest of the search parameters needed for the Da Vinci Drug Formulary IG are defined by the base specification, and are already available in Azure API for FHIR without additional updates.
Store profiles
Outside of defining search parameters, the only update you need to make to pass this test is to load the required profiles. There are two profiles used as part of the Da Vinci Drug Formulary IG.
Sample rest file
To assist with creation of these search parameters and profiles, there's the Da Vinci Formulary sample HTTP file on the open-source site, which includes all the steps previously outlined in a single file. Once you've uploaded all the necessary profiles and search parameters, you can run the capability statement test in Touchstone. A successful run looks like the following.
Touchstone query test
The second test is on query capabilities. This test validates that you can search for specific Coverage Plan and Drug resources using various parameters. It's recommended you test against resources that you already have in your database, but we also have the Da VinciFormulary_Sample_Resources HTTP file available with sample resources pulled from the examples in the implementation guide that you can use to create the resources and test against.
Next steps
In this tutorial, we walked through how to pass the Da Vinci Payer Data Exchange US Drug Formulary in Touchstone. Next, you can learn how to test the Da Vinci PDex IG in Touchstone.
Note
FHIR® is a registered trademark of HL7 and is used with the permission of HL7.