This page is part of the Da Vinci Payer Data Exchange (v1.0.0: STU1) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

PDex Provenance

Previous Page - US Core Procedure

When a Health Plan forwards information as a FHIR Resource it SHOULD create related Provenance record(s) to reflect the original source.

A Provenance resource SHOULD be provided with each member-related resource provided by the Health Plan’s FHIR API.

This SHOULD be used to:

• identify the source of the information.
• whether the data came via a clinical record, or a claim record.

The PDex-Provenance resource is based on the US Core Provenance Profile and is documented here: StructureDefinition-pdex-provenance.html

PDex Provenance adds an extension that uses the ProvenanceSourceFrom ValueSet to the entity element. In the PDex Provenance Profile the extension is included in the Provenance.entity base element.

Provenance.recorded value SHOULD be the date/time when the data is received by the payer.

The purpose of the extension is to identify the source format that the data in the provenance.target resource is taken from.

The Pdex Provenance record SHOULD be populated with the following essential fields (Must Support or Cardinality greater than 0..*) as follows:

Table Definition

Example Provenance Records

Four examples are provided to deal with four different scenarios:

1. Payer is transmitting a bundle ExampleProvenanceTransmitter
2. Organization as source of a record ExampleProvenanceAuthor
3. Solo Practitioner as source of a record ExampleProvenanceSoloPractitioner
4. Payer as source of a record ExampleProvenancePayerSource

Payer Transmitting a bundle

The payer acts as the transmitter. Setting:

agent.type = "Transmitter" 
agent.who = Payer's US Core Organization record

Payer Converts a clinical record from a non-FHIR format

The Payer creates the Provenance record as follows:

target.reference = Reference of the converted record
recorded = Date original record was received
agent.type = Author
agent.who = US Core Organization record for the originating organization
extension.sourceFormat = "ccda" to identify that the record was transformed from a CCDA document

Payer Converts a practitioner’s clinical record from a non-FHIR format

The Payer creates the Provenance record as follows:

target.reference = Reference of the converted record
recorded = Date original record was received
agent.type = Author
agent.who = US Core Practitioner record when the provider is NOT associated with an organization
extension.sourceFormat = "hl7v2" to identify that the record was transformed from a HL7 v2 message

Payer creates a clinical record from internal sources

The Payer creates the Provenance record as follows:

target.reference = Reference of the converted record
recorded = Date original record was received
agent.type = Source
agent.who = Payer's US Core Organization record
extension.sourceFormat = "custom" to identify that the record was transformed from a custom data format such as a CSV file.

The Health Plan SHALL accept and maintain Provenance information associated with information received from contributing entities. The Health Plan SHALL add Provenance record(s) as necessary to document relevant actions taken as the current custodian of the information. Provenance information SHALL be available for any information requested by an external entity as part of exchanges conformant to this implementation guide.

This guide shall define extensions to the provenance value sets as required to document the provenance of the information exchange.

Clinical Information without Provenance

The Health Plan SHOULD create a Provenance Record documenting the source of the records, the identity of the health plan and the action taken to become the custodian of the data.

The updated Provenance record SHOULD be passed on to any downstream entity that requests Provenance information for the records they request.

FHIR Resource from prior Health Plan

The Health Plan SHOULD store the Provenance information and maintain the correlation or links to the records the Provenance Record is documenting.

The Health Plan SHOULD update the Provenance records to add information covering the identity of the health plan and the action taken to become the custodian of the data.

The updated Provenance record SHOULD be passed on to any downstream entity requesting the associated records.

Claim Information from Provider

The Health Plan SHOULD create a Provenance Record documenting the source of the records, the identity of the health plan and the action taken to transform the data to FHIR Clinical Resources.

The updated Provenance record SHOULD be passed on to any downstream entity requesting the associated records.

Example Provenance Record

An example Author Provenance record appears below:

{
  "resourceType" : "Provenance",
  "id" : "1000002",
  "meta" : {
    "versionId" : "1",
    "lastUpdated" : "2020-07-10T16:26:23.217+00:00",
    "profile" : [
      "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-target-provenance"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\">
Generated Narrative
id: 1000002
meta: 
target: <a href=\"encounter/2000003\">encounter/2000003</a>
recorded: Jul 10, 2020 12:26:23 PM
Agents
<table class=\"grid\">-TypeWho*<span title=\"Codes: {http://terminology.hl7.org/CodeSystem/provenanceagenttype author}\">author</span><a href=\"Organization/2\">Organization/2</a></table></div>"
  },
  "extension" : [
    {
      "url" : "sourceFormat",
      "valueCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://hl7.org/fhir/us/davinci-pdex/ValueSet/ProvenancePayerSourceFormatVS",
            "code" : "hl7ccda"
          }
        ]
      }
    }
  ],
  "target" : [
    {
      "reference" : "encounter/2000003"
    }
  ],
  "recorded" : "2020-07-10T16:26:23.217+00:00",
  "agent" : [
    {
      "type" : {
        "coding" : [
          {
            "system" : "http://terminology.hl7.org/CodeSystem/provenanceagenttype",
            "code" : "author"
          }
        ]
      },
      "who" : {
        "reference" : "Organization/2"
      }
    }
  ]
}

Returning Provenance Records

Requesting a provenance resource is accomplished by adding the “_revinclude=Provenance:target” parameter to a search query.

For servers that support the “_revinclude” parameter this will return Provenance records in a bundle along with the resources returned by the search query.

Next Page - US Core Provenance