

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# `$member-match`operación para HealthLake
<a name="reference-fhir-operations-member-match"></a>

AWS HealthLake ahora apoya la `$member-match` operación de recursos para pacientes, lo que permite a las organizaciones de atención médica encontrar el identificador único de un miembro en diferentes sistemas de salud utilizando información demográfica y de cobertura. Esta operación es esencial para lograr el cumplimiento de los CMS y facilitar el intercambio seguro de payer-to-payer datos, al tiempo que se mantiene la privacidad de los pacientes.

Esta operación resulta especialmente útil cuando se necesita:
+ Permitir el intercambio seguro de datos de salud entre organizaciones
+ Mantenga la continuidad de la atención de los pacientes en los diferentes sistemas
+ Support CMS cumple con los requisitos
+ Facilite la identificación precisa de los miembros en todas las redes de atención médica

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

La `$member-match` operación se puede invocar en los recursos del paciente mediante el método POST:

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

## Parámetros admitidos
<a name="member-match-parameters"></a>

HealthLake admite los siguientes `$member-match` parámetros del FHIR:


| Parámetro | Tipo | Obligatorio/a | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | --- | 
| MemberPatient | Paciente | Sí | — | Recurso para pacientes que contiene información demográfica sobre el miembro al que se va a vincular | 
| CoverageToMatch | Cobertura | Sí | — | Recurso de cobertura que se utilizará para compararlo con los registros existentes | 
| CoverageToLink | Cobertura | No | — | Recurso de cobertura que se vinculará durante el proceso de emparejamiento | 
| Consentimiento | Consentimiento | No | — | Recurso de consentimiento para fines de autorización | 

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

### Solicitud POST con 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"
          }
        ]
      }
    }
  ]
}
```

### Respuesta de ejemplo
<a name="member-match-response-example"></a>

La operación devuelve un recurso de parámetros que contiene los resultados coincidentes:

```
{
  "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 respuesta
<a name="member-match-response-parameters"></a>

La respuesta incluye los siguientes parámetros cuando se encuentra una coincidencia:


| Parámetro | Tipo | Description (Descripción) | 
| --- | --- | --- | 
| MemberIdentifier | Identificador | El identificador único del miembro coincidente | 
| MemberId | Referencia | Referencia al recurso para pacientes | 
| Algoritmo de coincidencia | Cadena | Tipo de algoritmo de coincidencia utilizado (EXACT\$1MATCH, STRONG\$1MATCH o DEMOGRAPHIC\$1MATCH) | 
| Detalles del partido | Cadena | Información detallada sobre el proceso de emparejamiento | 
| Campos coincidentes | Cadena | Lista de campos específicos que se emparejaron correctamente | 

## algoritmos coincidentes
<a name="member-match-algorithms"></a>

La `$member-match` API emplea un enfoque de coincidencia de varios niveles para garantizar una identificación precisa de los miembros:

EXACT\$1MATCH  
Utiliza el identificador del paciente combinado con la cobertura SubscriberId  
Proporciona el nivel de confianza más alto para la identificación de miembros

STRONG\$1MATCH  
Utiliza el identificador del paciente con información de cobertura mínima  
Ofrece una gran confianza cuando no se cumplen los criterios de coincidencia exactos

DEMOGRAPHIC\$1MATCH  
Se basa en información demográfica básica  
Se utiliza cuando no es posible la coincidencia basada en identificadores

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

La operación: `$member-match`
+ Acepta como datos los datos demográficos del paciente, los detalles de la cobertura y la información de consentimiento opcional
+ Devuelve un identificador de miembro único que se puede utilizar en interacciones posteriores
+ Implementa una combinación de varios niveles (exacta, sólida y demográfica) para garantizar una identificación precisa de los miembros en los diferentes sistemas de salud
+ Guarda cualquier información de consentimiento proporcionada para futuros fines de autorización
+ Soporta el intercambio seguro payer-to-payer de datos al tiempo que mantiene la privacidad del paciente
+ Cumple con los requisitos de los CMS para el intercambio de datos sanitarios

## Autorización
<a name="member-match-authorization"></a>

La API utiliza el protocolo de autorización SMART on FHIR con los siguientes alcances obligatorios:
+ `system/Patient.read`
+ `system/Coverage.read`
+ `system/Organization.read`(condicional)
+ `system/Practitioner.read`(condicional)
+ `system/PractitionerRole.read`(condicional)
+ `system/Consent.write`(condicional)

## Gestión de errores
<a name="member-match-error-handling"></a>

La operación gestiona las siguientes condiciones de error:
+ `400 Bad Request`: `$member-match` Operación no válida (solicitud no conforme o faltan parámetros obligatorios)
+ `422 Unprocessable Entity`: No se encontraron coincidencias o se encontraron varias coincidencias