Operação de correspondência de $member 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 o serviço 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 FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerir serviços FHIR, DICOM e MedTech com integrações noutros serviços do Azure.

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

Descrição geral da operação $member-match

A operação de correspondência $member foi criada para ajudar no intercâmbio de dados entre ordenantes, permitindo que um novo ordenante obtenha um identificador único para um doente do anterior pagador do doente. A operação de $member-match requer três informações a serem passadas no corpo da solicitação:

  • Dados demográficos dos doentes

  • As informações de cobertura antigas

  • As novas informações de cobertura (não necessárias com base na nossa implementação)

Depois que os dados são passados, a API do Azure para FHIR valida que pode encontrar um paciente que corresponda exatamente aos dados demográficos transmitidos com as informações de cobertura antigas transmitidas. Se um resultado for encontrado, a resposta será um pacote com os dados originais do paciente, além de um novo identificador adicionado do pagador antigo e as informações de cobertura antigas.

Nota

A especificação descreve a passagem e devolução das novas informações de cobertura. Decidimos omitir esses dados para manter os resultados menores.

Exemplo de correspondência $member

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

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

Você precisará incluir um recurso de parâmetros no corpo que inclua o paciente, a cobertura antiga e a nova cobertura. Para ver uma representação JSON, consulte $member solicitação de exemplo de correspondência.

Se uma única correspondência for encontrada, você receberá uma resposta 200 com outro identificador adicionado:

200 cem código de resposta.

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

Próximos passos

Neste guia, você aprendeu sobre a operação de correspondência de $member. Em seguida, você pode aprender sobre como testar o Da Vinci Payer Data Exchange IG no Touchstone, que requer a operação de correspondência de $member.

FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.