$member-removeoperazione per HealthLake - AWS HealthLake
PrerequisitiDettagli dell'operazioneParametersEsempio di richiestaRispostaComportamentoGestione erroriBest practice

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-removeoperazione per HealthLake

L'$member-removeoperazione 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

  • 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

Endpoint

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

Content Type

application/fhir+json

Parameters

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

Sono supportate le seguenti combinazioni di parametri:

  • memberIdsolo: rimuove tutte le attribuzioni per il membro specificato

  • memberId+ providerNpi - Rimuove le attribuzioni per la specifica combinazione membro-provider

  • patientReferencesolo: rimuove tutte le attribuzioni per il paziente specificato

  • patientReference+ providerReference - Rimuove le attribuzioni per la combinazione specifica paziente-operatore

  • patientReferenceproviderReference+ coverageReference - Rimuove l'attribuzione specifica in base al paziente, al fornitore e alla copertura

Esempio di richiesta

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

Risposta

Risposta riuscita

{
  "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

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

Risposte di errore comuni

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

  • 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