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 Add

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

Adds a new member to the Group for attribution purposes.

Introduction

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

Implementation Requirements

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

  • memberId + providerNpi: Adds the member and the attributed provider to the Attribution List
  • memberId + ProviderNpi + attributionPeriod: Adds the member, attributed provider and the attribution period to the Attribution List
  • patientReference + providerReference: Adds the member and the attributed provider to the Attribution List
  • patientReference + providerReference + attributionPeriod: Adds the member, attributed provider and the attribution period to the Attribution List

Similar to any FHIR operation, Consumers need to obtain authorization to successfully invoke the operation.

Effect of Attribution List Status on the member-add operation

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

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

APIs : Member Add :

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

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

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

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INmemberId0..1Identifier

The MemberId of the member that needs to be added to the Group.

INproviderNpi0..1Identifier

The Attributed Provider along with the MemberId who needs to be added to the Group.

INpatientReference0..1Reference

The reference of the member to be added to the Group.

INproviderReference0..1Reference

The reference to the Attributed Provider along with the patient reference that needs to be added to the Group.

INattributionPeriod0..1Period

The period over which the patient is being attributed to the provider.