Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `$member-remove`operazione per HealthLake
<a name="reference-fhir-operations-member-remove"></a>

L'`$member-remove`operazione consente di rimuovere membri da una lista di attribuzione dei membri FHIR (risorsa di gruppo) in. AWS HealthLake Questa operazione fa parte della DaVinci Member Attribution Implementation Guide e supporta il processo di riconciliazione per la gestione delle attribuzioni dei membri.

## Prerequisiti
<a name="member-remove-prerequisites"></a>
+ AWS HealthLake Datastore FHIR
+ Autorizzazioni IAM appropriate per le operazioni HealthLake 
+ Elenco di attribuzione dei membri (risorsa di gruppo) in bozza o in stato aperto

## Dettagli dell'operazione
<a name="member-remove-endpoint"></a>

Endpoint  
`POST /Group/{id}/$member-remove`

Content Type  
`application/fhir+json`

## Parameters
<a name="member-remove-parameters"></a>

L'operazione accetta una risorsa FHIR Parameters con i seguenti parametri opzionali:


| Parametro | Cardinalità | Tipo | Description | 
| --- | --- | --- | --- | 
| memberId | 0.1.. | Identificatore | Identificativo aziendale del membro da rimuovere | 
| ProviderNPI | 0.1.. | Identificatore | NPI del fornitore attribuito | 
| Riferimento per il paziente | 0.. 1 | Documentazione di riferimento | Riferimento diretto alla risorsa per i pazienti | 
| Riferimento del fornitore | 0.1.. | Documentazione di riferimento | Riferimento diretto alla risorsa del Fornitore (professionista o PractitionerRole organizzazione) | 
| Riferimento alla copertura | 0.1.. | Documentazione di riferimento | Riferimento alla risorsa Coverage | 

### Combinazioni di parametri supportate
<a name="member-remove-parameter-combinations"></a>

Sono supportate le seguenti combinazioni di parametri:
+ `memberId`solo: rimuove tutte le attribuzioni per il membro specificato
+ `memberId`\$1 `providerNpi` - Rimuove le attribuzioni per la specifica combinazione membro-provider
+ `patientReference`solo: rimuove tutte le attribuzioni per il paziente specificato
+ `patientReference`\$1 `providerReference` - Rimuove le attribuzioni per la combinazione specifica paziente-operatore
+ `patientReference``providerReference`\$1 `coverageReference` - Rimuove l'attribuzione specifica in base al paziente, al fornitore e alla copertura

## Esempio di richiesta
<a name="member-remove-examples"></a>

```
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/12345"
      }
    },
    {
      "name": "providerReference",
      "valueReference": {
        "reference": "Practitioner/67890"
      }
    }
  ]
}
```

## Risposta
<a name="member-remove-response"></a>

### Risposta riuscita
<a name="member-remove-success-response"></a>

```
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "effectiveDate",
      "valueDate": "2024-06-30"
    },
    {
      "name": "status",
      "valueCode": "inactive"
    },
    {
      "name": "message",
      "valueString": "Member successfully removed from attribution list"
    }
  ]
}
```

## Comportamento
<a name="member-remove-behavior"></a>

Requisiti di status  
L'operazione funziona solo su elenchi di attribuzione con stato o `draft` `open`  
Gli elenchi con `final` stato rifiuteranno l'operazione con un errore 422

Procedura di rimozione dei membri  
*Bozze di elenchi di status*: i membri sono contrassegnati come inattivi (`inactive: true`) e la loro `changeType` estensione è aggiornata a `changed`  
*Liste di stato aperte*: comportamento simile alla bozza di stato  
*Elenchi di stato finali*: l'operazione è rifiutata

Convalida  
I riferimenti vengono convalidati per garantire che esistano nel HealthLake datastore  
Se vengono forniti sia l'identificatore che il riferimento per lo stesso tipo di risorsa, devono corrispondere alla stessa risorsa  
Le combinazioni di parametri vengono convalidate in base ai modelli supportati

## Gestione errori
<a name="member-remove-error-handling"></a>

### Risposte di errore comuni
<a name="member-remove-common-errors"></a>

Risorsa non trovata (404)  

```
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "details": {
        "text": "Patient with identifier 'http://example.org/fhir/identifiers|99999' not found in system"
      },
      "diagnostics": "Cannot remove member from attribution list. Verify patient identifier and try again.",
      "expression": ["memberId"]
    }
  ]
}
```

Stato finale dell'elenco di attribuzione (422)  

```
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "business-rule",
      "details": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/us/davinci-atr/CodeSystem/atr-error-codes",
            "code": "list-final",
            "display": "Attribution list is final and cannot be modified"
          }
        ]
      },
      "diagnostics": "Cannot modify attribution list with status 'final'. List modifications are not permitted after finalization.",
      "expression": ["Group.status"]
    }
  ]
}
```

Operazione non valida (400)  
Restituito quando le combinazioni di parametri non sono valide o non sono corrette.

Trovate più corrispondenze (412)  
Restituito quando i parametri forniti corrispondono a più membri nell'elenco di attribuzione.  

```
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "processing",
      "diagnostics": "Multiple members found matching the criteria"
    }
  ]
}
```

## Best practice
<a name="member-remove-best-practices"></a>
+ *Usa parametri specifici*: quando possibile, utilizza la combinazione di parametri più specifica per evitare rimozioni involontarie
+ Stato della *lista di controllo: verifica lo stato* dell'elenco di attribuzione prima di tentare le rimozioni
+ *Gestisci gli errori con garbo*: implementa una corretta gestione degli errori per tutte le possibili condizioni di errore
+ *Convalida i riferimenti*: assicurati che tutte le risorse referenziate esistano prima di effettuare la richiesta