$member-removeopération pour HealthLake - AWS HealthLake
PrérequisDétails de l'opérationParametersExemple de requêteRéponseComportementGestion des erreursBonnes pratiques

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

$member-removeopération pour HealthLake

L'$member-removeopération vous permet de supprimer des membres d'une liste d'attribution de membres FHIR (ressource de groupe) dans AWS HealthLake. Cette opération fait partie du guide de mise en œuvre de l'attribution des DaVinci membres et soutient le processus de rapprochement pour la gestion des attributions des membres.

Prérequis

  • AWS HealthLake Banque de données FHIR

  • Autorisations IAM appropriées pour les opérations HealthLake

  • Liste d'attribution des membres (ressource du groupe) en version provisoire ou ouverte

Détails de l'opération

Endpoint

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

Type de contenu

application/fhir+json

Parameters

L'opération accepte une ressource de paramètres FHIR avec les paramètres facultatifs suivants :

Paramètre Cardinalité Type Description
memberId 0,1 Identifiant Identifiant professionnel du membre à supprimer
Fournisseur NPI 0,1 Identifiant NPI du fournisseur attribué
Référence du patient 0,1 Référence Référence directe à la ressource destinée aux patients
Référence du fournisseur 0,1 Référence Référence directe à la ressource du fournisseur (praticien ou organisation) PractitionerRole
Référence de couverture 0,1 Référence Référence à la ressource Coverage

Combinaisons de paramètres prises en charge

Les combinaisons de paramètres suivantes sont prises en charge :

  • memberIduniquement - Supprime toutes les attributions pour le membre spécifié

  • memberId+ providerNpi - Supprime les attributions pour la combinaison membre-fournisseur spécifique

  • patientReferenceuniquement - Supprime toutes les attributions pour le patient spécifié

  • patientReference+ providerReference - Supprime les attributions pour la combinaison patient-fournisseur spécifique

  • patientReference+ providerReference + coverageReference - Supprime l'attribution spécifique en fonction du patient, du fournisseur et de la couverture

Exemple de requête

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

Réponse

Réponse réussie

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

Comportement

Exigences relatives au statut

L'opération ne fonctionne que sur les listes d'attribution avec statut draft ou open

Les listes avec un final statut rejetteront l'opération avec une erreur 422

Processus de suppression d'un membre

Brouillons de listes de statut : les membres sont marqués comme inactifs (inactive: true) et leur changeType extension est mise à jour pour changed

Listes de statut ouvertes : comportement similaire à celui du statut des brouillons

Listes de statut final : l'opération est rejetée

Validation

Les références sont validées pour garantir leur existence dans la HealthLake banque de données

Si l'identifiant et la référence sont fournis pour le même type de ressource, ils doivent correspondre à la même ressource

Les combinaisons de paramètres sont validées selon les modèles pris en charge

Gestion des erreurs

Réponses aux erreurs courantes

Ressource introuvable (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"]
    }
  ]
}
État final de la liste d'attribution (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"]
    }
  ]
}
Opération non valide (400)

Renvoyé lorsque les combinaisons de paramètres ne sont pas valides ou sont mal formées.

Plusieurs résultats trouvés (412)

Renvoyé lorsque les paramètres fournis correspondent à plusieurs membres de la liste d'attribution.

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

Bonnes pratiques

  • Utiliser des paramètres spécifiques : Dans la mesure du possible, utilisez la combinaison de paramètres la plus spécifique pour éviter les suppressions involontaires

  • État de la liste de vérification : vérifiez l'état de la liste d'attribution avant de tenter de le supprimer

  • Gérez les erreurs avec élégance : implémentez une gestion des erreurs appropriée pour toutes les conditions d'erreur possibles

  • Valider les références : assurez-vous que toutes les ressources référencées existent avant de faire la demande