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.
**Topics**
+ [Pré-requisitos](#ehr-prerequisites)
+ [Processo de configuração](#ehr-setup-process)
+ [Configuração da autenticação](#ehr-authentication)
+ [Recursos do FHIR e configuração da API](#ehr-api-configuration)
+ [Campos de configuração](#ehr-configuration-fields)
+ [Pre-production testando](#ehr-testing)
+ [Implantação na produção](#ehr-production)
## 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](#ehr-authentication) 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](#ehr-api-configuration) 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 em[Campos de configuração](#ehr-configuration-fields).
## 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.
1. 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](#ehr-api-configuration)
1. 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](mailto: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.
1. Ative o aplicativo Amazon Connect Health em seu ambiente Epic de produção usando o ID do cliente de produção.
1. Configure a autenticação do OAuth2 com a URL de produção da JKU fornecida pela AWS.
1. Ative todos os recursos do FHIR e as APIs privadas da Epic no ambiente de produção.
1. Crie e configure o usuário EMP de back-end de produção com os pontos de segurança apropriados.
1. Atualize as credenciais do EHR no console do Amazon Connect Health com os valores de produção.
1. Realize testes de fumaça para verificar a autenticação, a conectividade da API e as consultas básicas de agendamento.
1. Monitore de perto a integração durante o uso inicial da produção.