$member-removeoperación para HealthLake - AWS HealthLake
Requisitos previosDetalles de la operaciónParametersEjemplo de solicitudRespuestaComportamientoGestión de erroresPrácticas recomendadas

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-removeoperación para HealthLake

La $member-remove operación le permite eliminar miembros de una lista de atribución de miembros de la FHIR (recurso grupal) en. AWS HealthLake Esta operación forma parte de la Guía de implementación de la atribución de DaVinci miembros y apoya el proceso de conciliación para gestionar las atribuciones de los miembros.

Requisitos previos

  • AWS HealthLake Almacén de datos FHIR

  • Permisos de IAM adecuados para las operaciones HealthLake

  • Lista de atribuciones de miembros (recurso grupal) en estado borrador o abierta

Detalles de la operación

Punto de conexión

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

Tipo de contenido

application/fhir+json

Parameters

La operación acepta un recurso de parámetros del FHIR con los siguientes parámetros opcionales:

Parámetro Cardinalidad Tipo Description (Descripción)
memberId 0.1 Identificador Identificador empresarial del miembro que se va a eliminar
NPI del proveedor 0.1.. Identificador NPI del proveedor atribuido
Referencia del paciente 0.1.. Referencia Referencia directa al recurso para pacientes
Referencia del proveedor 0.1.. Referencia Referencia directa al recurso del proveedor (profesional u organización) PractitionerRole
Referencia de cobertura 0.1.. Referencia Referencia al recurso Cobertura

Combinaciones de parámetros compatibles

Se admiten las siguientes combinaciones de parámetros:

  • memberIdsolo: elimina todas las atribuciones del miembro especificado

  • memberId+ providerNpi - Elimina las atribuciones de la combinación específica de miembro y proveedor

  • patientReferencesolo: elimina todas las atribuciones del paciente especificado

  • patientReference+ providerReference - Elimina las atribuciones de la combinación específica de paciente y proveedor

  • patientReference+ providerReference + coverageReference - Elimina la atribución específica en función del paciente, el proveedor y la cobertura

Ejemplo de solicitud

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

Respuesta

Respuesta correcta

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

Comportamiento

Requisitos de estado

La operación solo funciona en listas de atribución con estado draft o open

Las listas con final estado rechazarán la operación con un error 422

Proceso de eliminación de miembros

Borradores de listas de estado: los miembros se marcan como inactivos (inactive: true) y su changeType extensión se actualiza a changed

Listas de estado abiertas: comportamiento similar al estado preliminar

Listas de estado finales: se rechaza la operación

Validación

Las referencias se validan para garantizar que existan en el HealthLake almacén de datos

Si se proporcionan tanto el identificador como la referencia para el mismo tipo de recurso, deben corresponder al mismo recurso

Las combinaciones de parámetros se validan de acuerdo con los patrones admitidos

Gestión de errores

Respuestas de error comunes

Recurso no encontrado (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"]
    }
  ]
}
Estado final de la lista de atribuciones (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"]
    }
  ]
}
Operación no válida (400)

Se devuelve cuando las combinaciones de parámetros no son válidas o están mal formadas.

Se han encontrado varias coincidencias (412)

Se devuelve cuando los parámetros proporcionados coinciden con varios miembros de la lista de atribuciones.

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

Prácticas recomendadas

  • Utilice parámetros específicos: cuando sea posible, utilice la combinación de parámetros más específica para evitar eliminaciones involuntarias

  • Estado de la lista de atribuciones: comprueba el estado de la lista de atribuciones antes de intentar eliminarla

  • Maneje los errores con elegancia: implemente un manejo de errores adecuado para todas las condiciones de error posibles

  • Valide las referencias: asegúrese de que existan todos los recursos a los que se hace referencia antes de realizar la solicitud