<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="NHSEngland-Provenance-Genomics" />
  <url value="https://fhir.nhs.uk/StructureDefinition/NHSEngland-Provenance-Genomics" />
  <version value="0.3.0" />
  <name value="NHSEngland_Provenance_Genomics" />
  <title value="NHSEngland Provenance Genomics" />
  <status value="active" />
  <date value="2026-04-16" />
  <publisher value="NHS England" />
  <contact>
    <name value="NHS England" />
    <telecom>
      <system value="email" />
      <value value="interoperabilityteam@nhs.net" />
      <use value="work" />
      <rank value="1" />
    </telecom>
  </contact>
  <description value="This profile defines the Genomics constraints and extensions on the International FHIR resource [Provenance](http://hl7.org/fhir/StructureDefinition/Provenance)." />
  <purpose value="The Genomics Provenance SHOULD be provided alongside updates to controlled documents such as ServiceRequests and DiagnosticReports by integrated systems on any update operation to ensure auditability for any changes to resources.&#xD;&#xA;&#xD;&#xA;It is not expected that updates which do not affect the clinical content of the document will need associated Provenance resources, e.g. addition of local identifiers (though for the purporses of the Genomic Order Management Alpha, all updates to ServiceRequest and DiagnosticReport resources will be expected to have accompanying Provenance resources). On material changes to controlled resources, ServiceRequest and DiagnosticReport, users SHOULD use the transaction endpoint on the server to bundle the updated resource and Provenance event into a single transaction.&#xD;&#xA;&#xD;&#xA;The HL7 FHIR specification also provides the capability to attach a Provenance resource using a custom header parameter. Using this mechanism would allow clients to submit requests to the resource specific PUT enpoints for ServiceRequests and DiagnosticReports, while still aloowing changes to be captured within a Provenance resource using a single interaction." />
  <copyright value="Copyright © 2026+ NHS England Licensed under the Apache License, Version 2.0 (the \\\&quot;License\\\&quot;); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \\\&quot;AS IS\\\&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html." />
  <fhirVersion value="4.0.1" />
  <kind value="resource" />
  <abstract value="false" />
  <type value="Provenance" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Provenance" />
  <derivation value="constraint" />
  <differential>
    <element id="Provenance.target">
      <path value="Provenance.target" />
      <definition value="SHALL be provided. This SHOULD be a reference to the resource on the central GMS system that was updated." />
      <type>
        <code value="Reference" />
        <targetProfile value="https://fhir.nhs.uk/StructureDefinition/NHSEngland-ServiceRequest-Genomics" />
        <targetProfile value="https://fhir.nhs.uk/StructureDefinition/NHSEngland-DiagnosticReport-GenomicReport" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Resource" />
        <aggregation value="referenced" />
        <aggregation value="bundled" />
      </type>
    </element>
    <element id="Provenance.recorded">
      <path value="Provenance.recorded" />
      <definition value="SHALL be provided, the date/time when the update took place." />
    </element>
    <element id="Provenance.reason">
      <path value="Provenance.reason" />
      <definition value="The reason why the update took place. If the codes provided by HL7 are not granular enough, or additional notes need to be recorded detailing the reasoning behind a change, this SHOULD be added as text to 'reason.text'." />
      <min value="1" />
    </element>
    <element id="Provenance.agent">
      <path value="Provenance.agent" />
      <definition value="SHOULD be provided where actions are user initiated. The user which performed the change, as identified through CIS2 authentication token." />
    </element>
    <element id="Provenance.signature">
      <path value="Provenance.signature" />
      <definition value="Signed, encrypted copy of the document, for validation that the document has not been tampered with (the requirement to include this field has not yet been validated)." />
    </element>
  </differential>
</StructureDefinition>