

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-match`operação para HealthLake
<a name="reference-fhir-operations-member-match"></a>

AWS HealthLake agora oferece suporte à `$member-match` operação de recursos para pacientes, permitindo que as organizações de saúde encontrem o identificador exclusivo de um membro em diferentes sistemas de saúde usando informações demográficas e de cobertura. Essa operação é essencial para alcançar a conformidade com o CMS e facilitar a troca segura de payer-to-payer dados, mantendo a privacidade do paciente.

Essa operação é particularmente útil quando você precisa:
+ Permita a troca segura de dados de saúde entre organizações
+ Mantenha a continuidade do atendimento ao paciente em diferentes sistemas
+ Support os requisitos de conformidade do CMS
+ Facilite a identificação precisa dos membros em todas as redes de saúde

## Usage
<a name="member-match-usage"></a>

A `$member-match` operação pode ser invocada nos recursos do paciente usando o método POST:

```
POST [base]/Patient/$member-match
```

## Parâmetros compatíveis
<a name="member-match-parameters"></a>

HealthLake suporta os seguintes parâmetros FHIR: `$member-match`


| Parâmetro | Tipo | Obrigatório | Padrão | Description | 
| --- | --- | --- | --- | --- | 
| MemberPatient | Paciente | Sim | — | Recurso para pacientes contendo informações demográficas para o membro a ser combinado | 
| CoverageToMatch | Cobertura | Sim | — | Recurso de cobertura que será usado para comparar com os registros existentes | 
| CoverageToLink | Cobertura | Não | — | Recurso de cobertura a ser vinculado durante o processo de correspondência | 
| Consentimento | Consentimento | Não | — | Recurso de consentimento para fins de autorização | 

## Exemplos
<a name="member-match-examples"></a>

### Solicitação POST com parâmetros
<a name="member-match-request-example"></a>

```
POST [base]/Patient/$member-match
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "MemberPatient",
      "resource": {
        "resourceType": "Patient",
        "name": [
          {
            "family": "Jones",
            "given": ["Sarah"]
          }
        ],
        "gender": "female",
        "birthDate": "1985-05-15"
      }
    },
    {
      "name": "CoverageToMatch",
      "resource": {
        "resourceType": "Coverage",
        "status": "active",
        "beneficiary": {
          "reference": "Patient/1"
        },
        "relationship": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
              "code": "self",
              "display": "Self"
            }
          ]
        },
        "payor": [
          {
            "reference": "Organization/payer456"
          }
        ]
      }
    },
    {
      "name": "Consent",
      "resource": {
        "resourceType": "Consent",
        "status": "active",
        "scope": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/consentscope",
              "code": "patient-privacy"
            }
          ]
        },
        "category": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                "code": "IDSCL"
              }
            ]
          }
        ],
        "patient": {
          "reference": "Patient/1"
        },
        "performer": [
          {
            "reference": "Patient/patient123"
          }
        ],
        "sourceReference": {
          "reference": "Document/someconsent"
        },
        "policy": [
          {
            "uri": "http://hl7.org/fhir/us/davinci-hrex/StructureDefinition-hrex-consent.html#regular"
          }
        ]
      }
    }
  ]
}
```

### Resposta da amostra
<a name="member-match-response-example"></a>

A operação retorna um recurso de Parâmetros contendo os resultados correspondentes:

```
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "MemberIdentifier",
      "valueIdentifier": {
        "system": "http://hospital.org/medical-record-number",
        "value": "MRN-123456"
      }
    },
    {
      "name": "MemberId",
      "valueReference": {
        "reference": "Patient/patient123"
      }
    },
    {
      "name": "matchAlgorithm",
      "valueString": "DEMOGRAPHIC_MATCH"
    },
    {
      "name": "matchDetails",
      "valueString": "Demographic match: DOB + Name"
    },
    {
      "name": "matchedFields",
      "valueString": "given,birthdate,gender,family"
    }
  ]
}
```

## Parâmetros de resposta
<a name="member-match-response-parameters"></a>

A resposta inclui os seguintes parâmetros quando uma correspondência é encontrada:


| Parâmetro | Tipo | Description | 
| --- | --- | --- | 
| MemberIdentifier | Identificador | O identificador exclusivo do membro correspondente | 
| MemberId | Referência | Referência ao recurso do paciente | 
| algoritmo de correspondência | String | Tipo de algoritmo de correspondência usado (EXACT\$1MATCH, STRONG\$1MATCH ou DEMOGRAPHIC\$1MATCH) | 
| Detalhes da partida | String | Informações detalhadas sobre o processo de correspondência | 
| Campos correspondentes | String | Lista de campos específicos que foram combinados com sucesso | 

## Algoritmos correspondentes
<a name="member-match-algorithms"></a>

A `$member-match` API emprega uma abordagem de correspondência em vários níveis para garantir a identificação precisa dos membros:

COINCIDÊNCIA EXATA  
Usa o identificador do paciente combinado com a cobertura SubscriberId  
Fornece o mais alto nível de confiança para correspondência de membros

STRONG\$1MATCH  
Usa o Patient Identifier com informações mínimas de cobertura  
Oferece alta confiança quando os critérios de correspondência exata não são atendidos

CORRESPONDÊNCIA DEMOGRÁFICA  
Baseia-se em informações demográficas básicas  
Usado quando a correspondência baseada em identificador não é possível

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

A `$member-match` operação:
+ Aceita dados demográficos do paciente, detalhes da cobertura e informações de consentimento opcionais como entrada
+ Retorna um identificador de membro exclusivo que pode ser usado para interações subsequentes
+ Implementa a correspondência em vários níveis (exata, forte, demográfica) para garantir a identificação precisa dos membros em diferentes sistemas de saúde
+ Salva todas as informações de consentimento fornecidas para fins de autorização futura
+ Oferece suporte à troca segura de payer-to-payer dados enquanto mantém a privacidade do paciente
+ Cumpre os requisitos do CMS para troca de dados de saúde

## Autorização
<a name="member-match-authorization"></a>

A API usa SMART no protocolo de autorização FHIR com os seguintes escopos obrigatórios:
+ `system/Patient.read`
+ `system/Coverage.read`
+ `system/Organization.read`(condicional)
+ `system/Practitioner.read`(condicional)
+ `system/PractitionerRole.read`(condicional)
+ `system/Consent.write`(condicional)

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

A operação trata das seguintes condições de erro:
+ `400 Bad Request`: `$member-match` operação inválida (solicitação não conforme ou ausência de parâmetros obrigatórios)
+ `422 Unprocessable Entity`: Nenhuma correspondência ou várias correspondências encontradas