Magentus Practice Management FHIR Implementation Guide
1.2.60 - ci-build

Magentus Practice Management FHIR Implementation Guide - Local Development build (v1.2.60) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## : Diagnostic Request Claim Operation - XML Representation

Active as of 2026-04-03

Raw xml | Download

    <OperationDefinition xmlns="http://hl7.org/fhir">
      <id value="EOrderClaimOperation"/>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition EOrderClaimOperation</b></p><a name="EOrderClaimOperation"> </a><a name="hcEOrderClaimOperation"> </a><p>URL: [base]/Task/$claim</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>requisition</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Identifier">Identifier</a></td><td/><td><div><p>The group identifier for the request, typically the barcode.</p>
    </div></td></tr><tr><td>IN</td><td>organization</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/references.html#Reference">Reference</a> (<a href="StructureDefinition-gs-organization.html" title="http://fhir.geniesolutions.io/StructureDefinition/gs-organization">Genie Organization</a>)</td><td/><td><div><p>Reference to the branded organization claiming the request.</p>
    </div></td></tr><tr><td>OUT</td><td>groupTask</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/references.html#Reference">Reference</a> (<a href="StructureDefinition-eorders-task-fulfillment-group.html" title="http://fhir.geniesolutions.io/StructureDefinition/eorders-task-fulfillment-group">EOrders Task Fulfillment Request Group</a>)</td><td/><td><div><p>Returns a reference to the group <code>Task</code> assigned to the requesting organisation or nothing if an error occurred.</p>
    </div></td></tr><tr><td>OUT</td><td>result</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Coding">Coding</a></td><td><a href="ValueSet-eorder-claim-result-type-valueset.html">Request Claim Result Type ValueSet</a> (Required)</td><td><div><p>The result of the attempting request claim.</p>
    </div></td></tr></table></div>
      </text>
      <url
           value="http://fhir.geniesolutions.io/OperationDefinition/EOrderClaimOperation"/>
      <version value="1.2.60"/>
      <name value="EOrderClaimOperation"/>
      <title value="Diagnostic Request Claim Operation"/>
      <status value="active"/>
      <kind value="operation"/>
      <date value="2026-04-03"/>
      <publisher value="Magentus Practice Management"/>
      <contact>
        <name value="Magentus Practice Management"/>
        <telecom>
          <system value="url"/>
          <value value="https://www.magentus.com/practice-management"/>
        </telecom>
        <telecom>
          <system value="email"/>
          <value value="andy.bond@magentus.com"/>
        </telecom>
      </contact>
      <contact>
        <name value="Magentus Practice Management"/>
        <telecom>
          <system value="url"/>
          <value value="https://www.magentus.com/practice-management"/>
          <use value="work"/>
        </telecom>
      </contact>
      <description
                   value="This operation is used to claim a request based on a scanned barcode and returns a group `Task` reference.  An `Organization` reference is also supplied so that a particular brand of service may be required for the transfer of the request.

    The transferred request will result in the creation of a new set of `Task`s, including a group `Task` and child `Task`s, each of which will be placed in a `requested` status.  To distinguish a request that has been claimed, the `businessStatus` of the `Task`s will be set to `claimed-request` and a tag will be set to the same `claimed-request` value.  The reason for the tag is that the businessStatus will change over time but the tag is persistent between resource versions.

    The original `Task` will be placed in a `cancelled` status and the `businessStatus` will be set to `claimed-cancel`.  To prevent re-discovering `Cancelled` tasks, the original filler should set the `businessStatus` to `cancel-handled` and when searching for new `requested` or `cancelled` tasks, explicitly exclude those that have already been handled via the `businessStatus`.

    The operation will return a `Coding` value that indicates the result of the claim attempt.  If the claim is successful, the group `Task` reference will be returned.  If the claim is unsuccessful, an error code will be returned."/>
      <jurisdiction>
        <coding>
          <system value="urn:iso:std:iso:3166"/>
          <code value="AU"/>
        </coding>
      </jurisdiction>
      <code value="claim"/>
      <resource value="Task"/>
      <system value="false"/>
      <type value="true"/>
      <instance value="false"/>
      <parameter>
        <name value="requisition"/>
        <use value="in"/>
        <min value="1"/>
        <max value="1"/>
        <documentation
                       value="The group identifier for the request, typically the barcode."/>
        <type value="Identifier"/>
      </parameter>
      <parameter>
        <name value="organization"/>
        <use value="in"/>
        <min value="1"/>
        <max value="1"/>
        <documentation
                       value="Reference to the branded organization claiming the request."/>
        <type value="Reference"/>
        <targetProfile
                       value="http://fhir.geniesolutions.io/StructureDefinition/gs-organization"/>
      </parameter>
      <parameter>
        <name value="groupTask"/>
        <use value="out"/>
        <min value="0"/>
        <max value="1"/>
        <documentation
                       value="Returns a reference to the group `Task` assigned to the requesting organisation or nothing if an error occurred."/>
        <type value="Reference"/>
        <targetProfile
                       value="http://fhir.geniesolutions.io/StructureDefinition/eorders-task-fulfillment-group"/>
      </parameter>
      <parameter>
        <name value="result"/>
        <use value="out"/>
        <min value="1"/>
        <max value="1"/>
        <documentation value="The result of the attempting request claim."/>
        <type value="Coding"/>
        <binding>
          <strength value="required"/>
          <valueSet
                    value="http://fhir.geniesolutions.io/ValueSet/eorder-claim-result-type-valueset"/>
        </binding>
      </parameter>
    </OperationDefinition>