$member-removeoperação para HealthLake - AWS HealthLake
Pré-requisitosDetalhes da operaçãoParametersExemplo de solicitaçãoRespostaComportamentoTratamento de errosPráticas recomendadas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

$member-removeoperação para HealthLake

A $member-remove operação permite que você remova membros de uma Lista de Atribuição de Membros do FHIR (recurso de grupo) em. AWS HealthLake Essa operação faz parte do Guia de Implementação de Atribuição de DaVinci Membros e apoia o processo de reconciliação para gerenciar as atribuições de membros.

Pré-requisitos

  • AWS HealthLake Armazenamento de dados FHIR

  • Permissões apropriadas do IAM para HealthLake operações

  • Lista de atribuição de membros (recurso do grupo) em status de rascunho ou aberto

Detalhes da operação

Endpoint

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

Tipo de conteúdo

application/fhir+json

Parameters

A operação aceita um recurso de parâmetros FHIR com os seguintes parâmetros opcionais:

Parâmetro Cardinalidade Tipo Description
memberId 0,1 Identificador Identificador comercial do membro a ser removido
NPI do provedor 0,1 Identificador NPI do provedor atribuído
Referência do paciente 0,1 Referência Referência direta ao recurso do paciente
Referência do provedor 0,1 Referência Referência direta ao recurso do provedor (profissional ou organização) PractitionerRole
Referência de cobertura 0,1 Referência Referência ao recurso de cobertura

Combinações de parâmetros suportadas

As seguintes combinações de parâmetros são suportadas:

  • memberIdsomente - Remove todas as atribuições do membro especificado

  • memberId+ providerNpi - Remove as atribuições da combinação específica de membro-provedor

  • patientReferencesomente - Remove todas as atribuições do paciente especificado

  • patientReference+ providerReference - Remove as atribuições da combinação específica paciente-provedor

  • patientReference+ providerReference + coverageReference - Remove a atribuição específica com base no paciente, no provedor e na cobertura

Exemplo de solicitação

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

Resposta

Resposta bem-sucedida

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

Requisitos de status

A operação só funciona em listas de atribuição com status ou draft open

Listas com final status rejeitarão a operação com um erro 422

Processo de remoção de membros

Listas de status preliminares: os membros são marcados como inativos (inactive: true) e sua changeType extensão é atualizada para changed

Listas de status abertas: comportamento semelhante ao status de rascunho

Listas de status finais: A operação foi rejeitada

Validação

As referências são validadas para garantir que existam no armazenamento de dados HealthLake

Se o identificador e a referência forem fornecidos para o mesmo tipo de recurso, eles deverão corresponder ao mesmo recurso

As combinações de parâmetros são validadas de acordo com os padrões suportados

Tratamento de erros

Respostas de erro comuns

Recurso não 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"]
    }
  ]
}
Status final da lista de atribuições (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"]
    }
  ]
}
Operação inválida (400)

Retornado quando as combinações de parâmetros são inválidas ou malformadas.

Várias correspondências encontradas (412)

Retornado quando os parâmetros fornecidos correspondem a vários membros na lista de atribuição.

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

Práticas recomendadas

  • Use parâmetros específicos: quando possível, use a combinação de parâmetros mais específica para evitar remoções não intencionais

  • Status da lista de verificação: verifique o status da lista de atribuição antes de tentar remoções

  • Lide com erros normalmente: implemente o tratamento adequado de erros para todas as condições de erro possíveis

  • Validar referências: certifique-se de que todos os recursos referenciados existam antes de fazer a solicitação