Compartilhar via


Operação $member-match para a API do Azure para FHIR

Importante

A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para FHIR® dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1º de abril de 2025. O serviço dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.

$member-match é uma operação definida como parte do Da Vinci Health Record Exchange (HRex). Neste guia, vamos explicar o que é a $member-match e como usá-la.

Visão geral do $member-match

A operação $member-match foi criada para facilitar a troca de dados entre pagadores, permitindo que um novo pagador receba um identificador exclusivo para um paciente a partir do pagador anterior. Para usar a operação $member-match, é necessário fornecer três informações no corpo da solicitação:

  • Os dados demográficos do paciente

  • As informações antigas de cobertura

  • As novas informações de cobertura (não são obrigatórias de acordo com a nossa implementação)

Após os dados serem inseridos, a API do Azure para FHIR valida se consegue encontrar um paciente que corresponda exatamente às informações demográficas fornecidas juntamente com as informações de cobertura anteriores. Se for possível encontrar um resultado, a resposta incluirá um pacote com os dados originais do paciente, um novo identificador do pagador antigo e as informações antigas de cobertura.

Observação

A especificação também descreve como enviar e retornar as novas informações de cobertura. Decidimos omitir esses dados para manter os resultados menores.

Exemplo de $member-match

Para usar $member-match, use a seguinte chamada:

POST {{fhirurl}}/Patient/$member-match

Você deve incluir um recurso de parâmetros no corpo que contenha o paciente, a cobertura antiga e a nova cobertura. Para ver uma representação em JSON, confira o exemplo de solicitação $member-match.

Se for possível encontrar uma única correspondência, você receberá uma resposta 200 com um identificador adicional:

Código de resposta 200.

Se o $member-match não conseguir encontrar uma correspondência única, você receberá uma resposta 422 com um código de erro.

Próximas etapas

Neste guia, você aprendeu sobre a operação $member-match. A seguir, você pode aprender como testar o Da Vinci Payer Data Exchange IG no Touchstone, que necessita da operação $member-match.

FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.