As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `$member-remove`operação para HealthLake
<a name="reference-fhir-operations-member-remove"></a>

A `$member-remove` operação permite que você remova membros de uma Lista de Atribuição de Membros do FHIR (recurso de grupo) em. AWS HealthLake Essa operação faz parte do Guia de Implementação de Atribuição de DaVinci Membros e apoia o processo de reconciliação para gerenciar as atribuições de membros.

## Pré-requisitos
<a name="member-remove-prerequisites"></a>
+ AWS HealthLake Armazenamento de dados FHIR
+ Permissões apropriadas do IAM para HealthLake operações
+ Lista de atribuição de membros (recurso do grupo) em status de rascunho ou aberto

## Detalhes da operação
<a name="member-remove-endpoint"></a>

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

Tipo de conteúdo  
`application/fhir+json`

## Parâmetros
<a name="member-remove-parameters"></a>

A operação aceita um recurso de parâmetros FHIR com os seguintes parâmetros opcionais:


| Parâmetro | Cardinalidade | Tipo | Description | 
| --- | --- | --- | --- | 
| memberId | 0,1 | Identificador | Identificador comercial do membro a ser removido | 
| NPI do provedor | 0,1 | Identificador | NPI do provedor atribuído | 
| Referência do paciente | 0,1 | Referência | Referência direta ao recurso do paciente | 
| Referência do provedor | 0,1 | Referência | Referência direta ao recurso do provedor (profissional ou organização) PractitionerRole | 
| Referência de cobertura | 0,1 | Referência | Referência ao recurso de cobertura | 

### Combinações de parâmetros suportadas
<a name="member-remove-parameter-combinations"></a>

As seguintes combinações de parâmetros são suportadas:
+ `memberId`somente - Remove todas as atribuições do membro especificado
+ `memberId`\$1 `providerNpi` - Remove as atribuições da combinação específica de membro-provedor
+ `patientReference`somente - Remove todas as atribuições do paciente especificado
+ `patientReference`\$1 `providerReference` - Remove as atribuições da combinação específica paciente-provedor
+ `patientReference`\$1 `providerReference` \$1 `coverageReference` - Remove a atribuição específica com base no paciente, no provedor e na cobertura

## Exemplo de solicitação
<a name="member-remove-examples"></a>

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

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

### Resposta bem-sucedida
<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>

Requisitos de status  
A operação só funciona em listas de atribuição com status ou `draft` `open`  
Listas com `final` status rejeitarão a operação com um erro 422

Processo de remoção de membros  
*Listas de status preliminares*: os membros são marcados como inativos (`inactive: true`) e sua `changeType` extensão é atualizada para `changed`  
*Listas de status abertas*: comportamento semelhante ao status de rascunho  
*Listas de status finais*: A operação foi rejeitada

Validação  
As referências são validadas para garantir que existam no armazenamento de dados HealthLake   
Se o identificador e a referência forem fornecidos para o mesmo tipo de recurso, eles deverão corresponder ao mesmo recurso  
As combinações de parâmetros são validadas de acordo com os padrões suportados

## Tratamento de erros
<a name="member-remove-error-handling"></a>

### Respostas de erro comuns
<a name="member-remove-common-errors"></a>

Recurso não encontrado (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"]
    }
  ]
}
```

Status final da lista de atribuições (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"]
    }
  ]
}
```

Operação inválida (400)  
Retornado quando as combinações de parâmetros são inválidas ou malformadas.

Várias correspondências encontradas (412)  
Retornado quando os parâmetros fornecidos correspondem a vários membros na lista de atribuição.  

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

## Práticas recomendadas
<a name="member-remove-best-practices"></a>
+ *Use parâmetros específicos*: quando possível, use a combinação de parâmetros mais específica para evitar remoções não intencionais
+ *Status da lista de verificação*: verifique o status da lista de atribuição antes de tentar remoções
+ *Lide com erros normalmente: implemente* o tratamento adequado de erros para todas as condições de erro possíveis
+ *Validar referências*: certifique-se de que todos os recursos referenciados existam antes de fazer a solicitação