Compartilhar via


Guia de Implementação CARIN para Blue Button® para 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.

Neste tutorial, percorreremos pelas etapas para configurar a API do Azure para FHIR® para passar nos testes Touchstone para o Guia de Implementação CARIN para Blue Button (C4BB IG).

Instrução de funcionalidade Touchstone

O primeiro teste que focaremos é testar a API do Azure para FHIR na Instrução de funcionalidade C4BB IG. Caso execute esse teste na API do Azure para FHIR sem nenhuma atualização, o teste falhará devido a parâmetros de pesquisa ausentes e perfis ausentes.

Definir parâmetros de pesquisa

Como parte do C4BB IG, é necessário definir três novos parâmetros de pesquisa para o recurso ExplanationOfBenefit. Dois deles são testados na instrução de funcionalidade (tipo e data do serviço) e um é necessário para pesquisas _include (garantidor).

Observação

No JSON bruto para esses parâmetros de pesquisa, o nome é definido como ExplanationOfBenefit_<SearchParameter Name>. O teste Touchstone espera que os nomes para esses parâmetros sejam tipo, data de serviço, e seguradora.

O restante dos parâmetros de pesquisa necessários para o C4BB 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 de repositório

Além de definir parâmetros de pesquisa, a outra atualização necessária para passar neste teste é carregar os perfis obrigatórios. Existem oito perfis definidos dentro C4BB IG.

Exemplo de arquivo rest

Para auxiliar na criação desses parâmetros de pesquisa e perfis, temos um arquivo http de exemplo que inclui todas as etapas descritas neste tutorial em apenas um 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.

Resultados da execução do script de teste de capacidades.

Teste de leitura Touchstone

Após testar a instrução de funcionalidades, teste as funcionalidades de leitura na API do Azure para FHIR em relação ao C4BB IG. Este é um teste de conformidade com os oito perfis carregados no primeiro teste. Você precisará ter recursos carregados em conformidade com os perfis. É recomendável testar com recursos que você já tem em seu banco de dados, mas também temos um arquivo http disponível com recursos de exemplo extraídos dos exemplos no IG que você poderá usar para criar os recursos e testar.

Resultados da execução do teste de leitura Touchstone.

Teste de consulta EOB Touchstone

O próximo teste que vamos revisar é o teste de consulta EOB. Se você já concluiu o teste de leitura, já tem todos os dados que precisa carregados. Esse teste valida se você pode pesquisar recursos específicos Patient e ExplanationOfBenefit usando vários parâmetros.

Resultados da execução do teste de consulta EOB Touchstone.

Teste de tratamento de erros do Touchstone

O teste final que faremos é o teste de tratamento de erros. A única etapa que você precisa fazer é excluir um recurso ExplanationOfBenefit do banco de dados e usar a ID do recurso ExplanationOfBenefit excluído no teste.

Resultados do tratamento de erros do teste de consulta EOB Touchstone.

Próximas etapas

Neste tutorial, explicamos como passar nos testes CARIN IG para Blue Button no Touchstone. Em seguida, você pode revisar como testar os testes de formulários Da Vinci.

Observação

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