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.
- Cobertura C4BB
- Institucional do Paciente Internado ExplanationOfBenefit C4BB
- Institucional do Paciente Ambulatorial ExplanationOfBenefit C4BB
- Farmácia ExplanationOfBenefit C4BB
- NonClinician Professional ExplanationOfBenefit C4BB
- OrganizaçãoC4BB
- Paciente C4BB
- Profissional C4BB
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.
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.
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.
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.
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.