Partilhar via

Da Vinci Plan Net for Azure API for 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 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.

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

Declaração de capacidade Touchstone

O primeiro teste em que nos concentramos é testar a API do Azure para FHIR em relação à declaração de capacidade Da Vinci Plan-Net. Se você executar esse teste sem atualizações, o teste falhará devido à falta de parâmetros de pesquisa e perfis.

Definir parâmetros de pesquisa

Como parte do Da Vinci Plan-Net IG, você precisa definir seis novos parâmetros de pesquisa para os recursos Serviço de Saúde, Plano de Seguro, Função do Profissional, Organização e Afiliação à Organização. Todos os seis são testados na declaração de capacidade.

Nota

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 estes seja apenas o SearchParameter Name (área de cobertura, tipo de plano ou rede).

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

Perfis da loja

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

Arquivo de repouso de exemplo

Para ajudar na criação desses parâmetros de pesquisa e perfis, temos um arquivo http de exemplo no site de código aberto, que inclui todas as etapas descritas anteriormente em um único arquivo. Depois de carregar todos os perfis e parâmetros de pesquisa necessários, você pode executar o teste de declaração de capacidade no Touchstone.

Da Vinci plan net sample rest test execution script aprovado

Teste de manipulação de erros Touchstone

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

Da Vinci plano net touchstone script de execução de teste de erro passado

Teste de consulta Touchstone

O próximo teste que percorremos é o teste de recursos de consulta. Isso testa a conformidade com os perfis carregados no primeiro teste. Você precisa ter recursos carregados que estejam de acordo com os perfis. Recomendamos que você teste em relação aos 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 IG que você pode usar para criar os recursos e testar.

Falha no teste de consulta net do plano Da Vinci

Nota

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 é retornado várias vezes se atender aos critérios básicos e _include aos critérios. Para obter detalhes, consulte a edição #2037.

Próximos passos

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

Recursos suportados.

Nota

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