Da Vinci - Member Attribution (ATR) List
2.0.0 - STU 2.0.0 United States of America flag

This page is part of the Risk Based Contracts Member Attribution List FHIR IG (v2.0.0: STU2 Release 1) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

OperationDefinition: Member Remove

Official URL: http://hl7.org/fhir/us/davinci-atr/OperationDefinition/member-remove Version: 2.0.0
Active as of 2021-07-22 Computable Name: MemberRemove

Removes a member from the Group based on existing attribution.

Introduction

This operation is used to remove a member along with the attributed provider from the Member Attribution List. This allows the consumer (client) to remove members from the Group during the reconciliation process.

Implementation Requirements

The following combinations of parameters SHALL be supported by the server implementing the operation.

  • memberId only: Removes all attributions for the Member specified by the MemberId
  • memberId + providerNpi: Removes all attributions for the combination of Member and Provider specified
  • patientReference: Removes all attributions for the Member
  • patientReference + providerReference: Removes all attributions for the combination of Member and Provider specified
  • patientReference + providerReference + coverageReference: Removes the attribution for the combination of Member and Provider and Coverage resources

Effect of Attribution List Status on the member-remove operation

  • The Producer SHALL allow the member-remove operation only when the attribution list status is “draft”.

  • When the attribution list status is in a “draft” status, member-remove operations will change the member’s active flag to false, indicating the the member is going to be removed from the list, however as part of the data exchange the member SHALL be included in the list as long as the status is draft.

  • Once the list has a status of final, the producer SHOULD remove the inactive members from the list and may only retain the active members.

  • When the attribution list status is “final” the Producer SHALL reject the operation with appropriate OperationOutcome.

APIs : Member Remove :

POST [Base FHIR Url]/Group/[id]/$member-remove

Producers SHALL return values from the operation as per the FHIR Operation Response Specification.

URL: [base]/Group/[id]/$member-remove

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INmemberId0..1Identifier

The MemberId of the member to be removed from the Group.

INproviderNpi0..1Identifier

The Provider attributed to the member who has to be removed in combination with the MemberId.

INpatientReference0..1Reference

The reference of the member to be removed from the Group.

INproviderReference0..1Reference

The Provider reference attributed to the member who has to be removed in combination with the patientReference.

INcoverageReference0..1Reference

The reference to the coverage based on which the attribution has to be removed.