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-match`operazione per HealthLake
<a name="reference-fhir-operations-member-match"></a>

AWS HealthLake ora supporta l'`$member-match`operazione Patient Resources, consentendo alle organizzazioni sanitarie di trovare l'identificatore univoco di un membro in diversi sistemi sanitari utilizzando informazioni demografiche e di copertura. Questa operazione è essenziale per raggiungere la conformità CMS e facilitare lo scambio sicuro payer-to-payer dei dati, mantenendo al contempo la privacy dei pazienti.

Questa operazione è particolarmente utile quando è necessario:
+ Consentire lo scambio sicuro di dati sanitari tra le organizzazioni
+ Mantieni la continuità dell'assistenza ai pazienti tra diversi sistemi
+ Supporta i requisiti di conformità CMS
+ Facilita l'identificazione accurata dei membri attraverso le reti sanitarie

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

L'`$member-match`operazione può essere richiamata sulle risorse del paziente utilizzando il metodo POST:

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

## Parametri supportati
<a name="member-match-parameters"></a>

HealthLake supporta i seguenti parametri FHIR`$member-match`:


| Parametro | Tipo | Obbligatorio | Predefinita | Description | 
| --- | --- | --- | --- | --- | 
| MemberPatient | Paziente | Sì | — | Risorsa per il paziente contenente informazioni demografiche relative al membro da abbinare | 
| CoverageToMatch | Copertura | Sì | — | Risorsa di copertura che verrà utilizzata per il confronto con i record esistenti | 
| CoverageToLink | Copertura | No | — | Risorsa di copertura da collegare durante il processo di abbinamento | 
| Consenso | Consenso | No | — | Risorsa di consenso a fini di autorizzazione | 

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

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

### Risposta di esempio
<a name="member-match-response-example"></a>

L'operazione restituisce una risorsa Parameters contenente i risultati corrispondenti:

```
{
  "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"
    }
  ]
}
```

## Parametri di risposta
<a name="member-match-response-parameters"></a>

La risposta include i seguenti parametri quando viene trovata una corrispondenza:


| Parametro | Tipo | Description | 
| --- | --- | --- | 
| MemberIdentifier | Identificatore | L'identificatore univoco per il membro corrispondente | 
| MemberId | Documentazione di riferimento | Riferimento alla risorsa Patient | 
| Match Algoritm | Stringa | Tipo di algoritmo di corrispondenza utilizzato (EXACT\_MATCH, STRONG\_MATCH o DEMOGRAPHIC\_MATCH) | 
| Dettagli della partita | Stringa | Informazioni dettagliate sul processo di abbinamento | 
| Campi corrispondenti | Stringa | Elenco di campi specifici che sono stati abbinati correttamente | 

## Algoritmi di corrispondenza
<a name="member-match-algorithms"></a>

L'`$member-match`API utilizza un approccio di abbinamento a più livelli per garantire un'identificazione accurata dei membri:

EXACT\_MATCH  
Utilizza l'identificatore del paziente combinato con la copertura SubscriberId  
Fornisce il massimo livello di confidenza per l'abbinamento dei membri

STRONG\_MATCH  
Utilizza Patient Identifier con informazioni minime sulla copertura  
Offre un'elevata affidabilità quando non vengono soddisfatti i criteri di corrispondenza esatti

ABBINAMENTO DEMOGRAFICO  
Si basa su informazioni demografiche di base  
Utilizzato quando non è possibile la corrispondenza basata su identificatori

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

L'operazione: `$member-match`
+ Accetta come input i dati demografici dei pazienti, i dettagli sulla copertura e le informazioni facoltative sul consenso
+ Restituisce un identificatore di membro univoco che può essere utilizzato per le interazioni successive
+ Implementa la corrispondenza a più livelli (esatta, forte, demografica) per garantire l'identificazione accurata dei membri nei diversi sistemi sanitari
+ Salva tutte le informazioni di consenso fornite per scopi di autorizzazione futuri
+ Supporta lo scambio sicuro di payer-to-payer dati mantenendo al contempo la privacy del paziente
+ Conforme ai requisiti CMS per lo scambio di dati sanitari

## Autorizzazione
<a name="member-match-authorization"></a>

L'API utilizza il protocollo di autorizzazione SMART on FHIR con i seguenti ambiti richiesti:
+ `system/Patient.read`
+ `system/Coverage.read`
+ `system/Organization.read`(condizionale)
+ `system/Practitioner.read`(condizionale)
+ `system/PractitionerRole.read`(condizionale)
+ `system/Consent.write`(condizionale)

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

L'operazione gestisce le seguenti condizioni di errore:
+ `400 Bad Request`: `$member-match` operazione non valida (richiesta non conforme o parametri obbligatori mancanti)
+ `422 Unprocessable Entity`: nessuna corrispondenza o più corrispondenze trovate