Compartilhar via

Da Vinci Plan Net para API do Azure para FHIR

  • Artigo

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.

Neste tutorial, vamos percorrer a configuração do serviço FHIR® na API do Azure para FHIR para passar nos testes do Touchstone para o Guia de Implementação (IG) do Da Vinci PDEX Payer Network (Plan-Net).

Instrução de funcionalidade Touchstone

O primeiro teste em que nos concentraremos é testar a API do Azure para FHIR na Instrução de funcionalidade Da Vinci Plan-Net. Se você executar esse teste sem nenhuma atualização, o teste falhará devido à ausência de perfis e parâmetros de pesquisa.

Definir parâmetros de pesquisa

Como parte do IG do Da Vinci Plan-Net, você precisa definir seis novos parâmetros de pesquisa para os recursos serviço de saúde, plano de seguro, função de praticante, organização e afiliação da organização. Todos os seis são testados na instrução de funcionalidade.

Observação

No JSON bruto para esses parâmetros de pesquisa, o nome é definido como Plannet_sp_<Resource Name>_<SearchParameter Name>. O teste Touchstone espera que o nome para eles seja apenas a SearchParameter Name (área de cobertura, tipo de plano ou rede).

O restante dos parâmetros de pesquisa necessários para o Guia de Implementação do Da Vinci Plan-Net são definidos pela especificação base e já estão disponíveis na API do Azure para FHIR sem atualizações adicionais.

Perfis de repositório

Além de definir parâmetros de pesquisa, você precisa carregar os perfis e extensões necessários para passar nesse teste. Há nove perfis usados como parte do IG da Da Vinci Plan-Net.

Exemplo de arquivo rest

Para ajudar na criação desses parâmetros e perfis de pesquisa, temos um arquivo http de exemplo no site de software livre que inclui todas as etapas previamente descritas em um único arquivo. Depois de carregar todos os perfis e parâmetros de pesquisa necessários, você poderá executar o teste de instrução de funcionalidade no Touchstone.

Script de execução de teste de rest de exemplo de da Vinci aprovado

Teste de tratamento de erros do Touchstone

O segundo teste que faremos é o teste de tratamento de erros. A única etapa que você deve fazer é excluir um recurso HealthcareService do banco de dados e usar a ID do recurso HealthcareService excluído no teste. O arquivo DaVinci_PlanNet.http de exemplo no site de software livre fornece um exemplo de HealthcareService para postar e excluir para esta etapa.

Script de execução de teste de erro do da Vinci plan net touchstone aprovado

Teste de consulta touchstone

O próximo teste que examinaremos é o teste de funcionalidades de consulta. Esse teste verifica a conformidade com os perfis carregados no primeiro teste. Você precisa ter recursos carregados em conformidade com os perfis. Recomendamos que você teste com recursos que você já tem em seu banco de dados. Também temos o arquivo DaVinci_PlanNet_Sample_Resources.http com recursos de exemplo extraídos dos exemplos no Guia de Implementação, que você pode usar para criar os recursos e testar.

Falha no teste de consulta net do plano Da Vinci

Observação

Com os recursos de exemplo fornecidos, você deve esperar uma taxa de sucesso de 98% dos testes de consulta. Há um problema aberto do GitHub no servidor FHIR que está fazendo com que um desses testes falhe.

Um recurso retornará várias vezes se atender a critérios base e critérios _include. Para mais obter detalhes, consulte o problema nº 2037.

Próximas etapas

Neste tutorial, percorremos a configuração da API do Azure para FHIR para passar nos testes do Touchstone para o Guia de Implementação do Da Vinci PDEX Payer Network (Plan-Net). Para obter mais informações sobre os recursos com suporte na API do Azure para FHIR, confira

Recursos compatíveis.

Observação

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