View a markdown version of this page

Integração Epic EHR - Amazon Connect Health

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração Epic EHR

O Amazon Connect Health se integra diretamente ao Epic EHR por meio do aplicativo Amazon Connect Health para a Epic, que é listado de forma privada. A integração usa a autenticação OAuth2 com as APIs FHIR R4 e as APIs privadas da Epic para dar suporte aos fluxos de trabalho de verificação de pacientes e gerenciamento de consultas.

Pré-requisitos

Antes de começar, verifique se você tem o seguinte:

  • Instância épica acessível via endpoint FHIR R4

  • Administrador da Epic com acesso ao Epic Showroom

  • Entre em contato com a equipe de contas da AWS para iniciar a integração

  • Configuração de JWK Set URL (JKU)

Processo de configuração

O aplicativo Amazon Connect Health para a Epic está listado de forma privada e não está disponível publicamente no Epic Showroom. Siga estas etapas para concluir a integração.

Etapa 1: enviar uma solicitação de organização interessada

Seu administrador da Epic pesquisa o aplicativo Amazon Connect Health usando o ID do cliente e envia uma solicitação de organização interessada por meio do Epic Showroom.

  • Non-production ID do cliente: cd1e1810-5406-43bb-9eba-7c8c0f2eb9cb

  • ID do cliente de produção: c86ee400-3608-449e-93ea-1046eeae00da

Etapa 2: verificação da AWS e provisionamento de URL da JKU

A AWS analisa e verifica sua organização antes de conceder acesso. Aguarde de 2 a 3 dias úteis para essa etapa. Depois de aprovada, a AWS gera a URL da JKU específica do cliente e a compartilha com você.

Etapa 3: configurar a autenticação no Epic

A AWS configura a autenticação quando você solicita o download do aplicativo Amazon Connect Health. Consulte Configuração da autenticação para obter mais detalhes.

Etapa 4: instalar o aplicativo e configurar o usuário EMP de back-end

Seu administrador Epic instala o aplicativo Amazon Connect Health e configura o usuário de back-end do EMP com os pontos de segurança apropriados para todas as APIs necessárias. Consulte Recursos do FHIR e configuração da API a lista completa das APIs necessárias.

Etapa 5: Configurar credenciais de EHR no console de IA da AWS Healthcare

Após a instalação, configure sua integração com o EHR no console do Amazon Connect Health usando os campos descritos emCampos de configuração.

Integração do EHR no aplicativo Amazon Connect Health

Configuração da autenticação

O Amazon Connect Health usa a autenticação OAuth2 com JWK Set URL (JKU) para gerenciamento e rotação seguros de chaves.

Configurar usuário EMP de back-end

  1. Siga o processo padrão da Epic para configurar um usuário EMP de back-end para o aplicativo Amazon Connect Health.

  2. Conceda pontos de segurança ao usuário do EMP de back-end para todas as APIs listadas em. Recursos do FHIR e configuração da API

  3. Verifique se o usuário pode acessar todos os recursos FHIR necessários e as APIs privadas da Epic.

Recursos do FHIR e configuração da API

Configurações do aplicativo

Configuração Valor

Versão SMART Scope

SMART versão 1

IDs FHIR

Sem restrições

Recursos públicos do FHIR R4

Ative os seguintes recursos com os endpoints de segurança apropriados:

Recurso Categoria Versão Finalidade

Appointment.Read

Nomeações

R4

Leia os detalhes do compromisso

Appointment.Search

Nomeações

R4

Pesquisar compromissos

Location.Read

Local

R4

Leia as informações de localização

Paciente. $match

Dados demográficos

R4

Combine os registros dos pacientes

Patient.Read

Dados demográficos

R4

Leia as informações do paciente

PatientLookup

Consulta de pacientes

2012

Pesquisa de pacientes antigos

Practitioner.Read

Praticante

R4

Leia os detalhes do profissional

PractitionerRole.Search

Papel do profissional

R4

Pesquise funções de profissionais

Recursos de API privada da Epic

Ative as seguintes APIs privadas da Epic com os endpoints de segurança apropriados:

solicitações de Versão Finalidade

CancelAppointment

2019

Cancelar consultas com pacientes

GetAccountDemographics

2018

Recuperar dados demográficos da conta

GetFutureAppointments

2014

Consulte os próximos compromissos

GetGuarantorsAndCoverage

2014

Acesse as informações do seguro

GetOpenSlots

2019

Encontre horários de agendamento disponíveis

GetProviders

2019

Recuperar informações do provedor

ScheduleAppointment

2019

Marque novos compromissos

ScheduleAppointmentWithInsurance

2019

Marque consultas com seguro

Lista de verificação de configuração de segurança

  • Todos os recursos do FHIR R4 habilitados

  • Todas as APIs privadas da Epic habilitadas

  • O usuário do Backend EMP recebeu acesso a todos os recursos

  • Endpoints de segurança configurados de acordo com a documentação da Epic

  • Permissões testadas e verificadas

Campos de configuração

Os campos a seguir são obrigatórios para configurar a integração do Epic EHR no console Amazon Connect Health:

Campo Description Exemplo

E-mail da organização

Endereço de e-mail administrativo associado ao ambiente Epic

admin@healthsystem.org

Endpoint do servidor FHIR

URL base do endpoint da API Epic FHIR R4

https://epic_xyz.xxyy.com/FhirProxy/api/FHIR/R4/

Endpoint de metadados

URL usada para recuperar metadados do servidor OAuth 2.0

https://epic_xyz.xxyy.com/FhirProxy/api/FHIR/R4/metadata

Sistema de identificação MRN

URI do sistema usado para identificar valores de MRN na Epic

execução: oid: 1.2.840.114350.646473.0

Tipo de identificador MRN

Código usado para classificar o identificador MRN

MR

Número de série do compromisso (ASN)

Sistema de identificação usado para números de série de compromissos na Epic

execução: oid: 1.2.840.114350.1.13.0.1.7.2.798268

Pre-production testando

Os testes devem ocorrer em um ambiente Epic que não seja de produção, usando somente dados simulados do paciente. Não use PHI real no ambiente UAT. O ambiente de não produção tem total paridade de recursos com a produção.

Lista de verificação de testes

  • ❏ Aplicativo ativado com sucesso em Epic, que não é de produção

  • ❏ Autenticação trabalhando com URL JKU

  • ❏ Todos os recursos do FHIR acessíveis

  • ❏ Todas as APIs privadas da Epic estão respondendo corretamente

  • ❏ fluxo de consultas de End-to-end pacientes testado

  • ❏ Tratamento de erros validado

  • ❏ Benchmarks de desempenho atendidos

  • ❏ Equipe treinada em configuração e solução de problemas

Implantação na produção

Conclua todos os testes de pré-produção e resolva quaisquer problemas antes da implantação na produção.

Pre-deployment lista de verificação

  • ❏ Pre-production teste concluído com sucesso

  • ❏ Todos os problemas do teste foram resolvidos

  • ❏ URL da JKU de produção recebida da AWS

  • ❏ ID do cliente de produção documentada

  • ❏ Plano de reversão preparado

  • ❏ Equipe de suporte informada

Etapas de configuração de produção

  1. Solicite a ativação da produção da sua equipe de contas da AWS, caso ainda não tenha obtido.

  2. Ative o aplicativo Amazon Connect Health em seu ambiente Epic de produção usando o ID do cliente de produção.

  3. Configure a autenticação do OAuth2 com a URL de produção da JKU fornecida pela AWS.

  4. Ative todos os recursos do FHIR e as APIs privadas da Epic no ambiente de produção.

  5. Crie e configure o usuário EMP de back-end de produção com os pontos de segurança apropriados.

  6. Atualize as credenciais do EHR no console do Amazon Connect Health com os valores de produção.

  7. Realize testes de fumaça para verificar a autenticação, a conectividade da API e as consultas básicas de agendamento.

  8. Monitore de perto a integração durante o uso inicial da produção.