Os dados de prontuários médicos são armazenados no formato HL7 FHIR.
O Prontuário eletrônico é compatível com as seguintes versões do Fast Health Interoperable Resources (FHIR):
Tipos de recursos médicos
O FHIR é composto por um conjunto de componentes modulares chamados recursos. O conjunto compatível de recursos do FHIR e as categorias correspondentes se baseiam aproximadamente nas seções do Resumo Internacional do Paciente.
Esses recursos são mapeados para categorias de dados no Conexão Saúde, chamados de Medical Resource Types na API. Os recursos de observação são mapeados com base em conteúdo como nomes e códigos de identificadores de observação lógica (LOINC) e categorias do FHIR.
As observações que não pertencem a nenhuma dessas categorias não são gravadas na Conexão Saúde.
| Tipo de recurso médico do app Conexão Saúde | Recursos do FHIR | Declaração de permissões da Conexão Saúde |
|---|---|---|
| Alergias | AllergyIntolerance |
android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
|
| Condições | Condição |
android.permission.health.READ_MEDICAL_DATA_CONDITIONS
|
| Laboratório |
Observação
|
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
|
| Medicamentos | Medication, MedicationRequest, MedicationStatement |
android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
|
| Dados pessoais | Paciente |
android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
|
| Detalhes do profissional de saúde | Practitioner, PractitionerRole |
android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
|
| Gravidez |
Observação
|
android.permission.health.READ_MEDICAL_DATA_PREGNANCY
|
| Procedimentos | Procedimento |
android.permission.health.READ_MEDICAL_DATA_PROCEDURES
|
| História social |
Observação
|
android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
|
| Vacinas | Imunização |
android.permission.health.READ_MEDICAL_DATA_VACCINES
|
| Visitas | Encontro, Local, Organização |
android.permission.health.READ_MEDICAL_DATA_VISITS
|
| Sinais vitais |
Observação
|
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS
|
Recursos para pacientes
No momento, o app Conexão Saúde foi criado para armazenar dados de históricos médicos de uma única pessoa. Portanto, todos os recursos FHIR escritos precisam pertencer à mesma pessoa.
Não é incomum que vários recursos de paciente do FHIR existam em um sistema para uma única pessoa. É preferível que os apps reconciliem os dados e gravem um único recurso de paciente na Conexão Saúde. No entanto, isso não é obrigatório para acomodar as diferentes estruturas organizacionais que podem existir.
Validação de dados
As APIs de registros médicos aceitam recursos FHIR válidos de versões compatíveis, e a Conexão Saúde realiza algumas validações para confirmar que a especificação FHIR de cada versão compatível é seguida.
As verificações de validação marcadas como Em breve ainda não são aplicadas, mas serão em uma versão futura. Recomendamos desenvolver em relação a todas as verificações de validação listadas para manter a compatibilidade com versões futuras.
| Nível | Verificação de validação | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| JSON válido | Os dados estão em conformidade com o formato JSON. | ||||||||
| FHIR compatível | A versão do FHIR declarada pelo aplicativo de gravação é compatível. As seguintes versões do FHIR são compatíveis com a API Conexão Saúde:
|
||||||||
| FHIR compatível | O tipo de recurso FHIR registrado na instância do recurso é compatível. O app Conexão Saúde é compatível com os seguintes tipos de recursos do FHIR:
|
||||||||
| ID exclusivo do recurso | O recurso tem um campo de ID com um valor que atende aos requisitos de expressão regular. | ||||||||
| ID exclusivo do recurso | O recurso não compartilha um ID com outro recurso FHIR do mesmo
tipo de recurso do mesmo MedicalDataSource. |
||||||||
| Regras de negócios | Não inclui um recurso FHIR contido. Os recursos contidos são recursos FHIR aninhados em um recurso "pai". Eles são usados quando o recurso principal precisa fazer referência a outro recurso, mas o sistema não tem informações suficientes para criar um recurso independente. | ||||||||
| FHIR de base válido | Os campos de nível superior no JSON do FHIR existem na especificação do FHIR para o tipo de recurso especificado. | ||||||||
| FHIR de base válido | Os campos de nível superior não têm valores nulos JSON. | ||||||||
| FHIR de base válido | Todos os campos obrigatórios de nível superior estão presentes. | ||||||||
| FHIR de base válido | Os campos de nível superior definidos como
elementos repetidos no FHIR têm um
tipo de dados JSON array. |
||||||||
| FHIR de base válido | Os campos de nível superior (incluindo elementos em arrays JSON) definidos como tipos complexos no FHIR têm um tipo de dados object JSON. |
||||||||
| FHIR de base válido | Os campos de nível superior (incluindo elementos em arrays JSON) definidos como tipos primitivos em FHIR têm o tipo de dados JSON correto.
|
||||||||
| FHIR de base válido | Os campos de nível superior definidos como tipos primitivos no FHIR atendem aos requisitos de expressão regular. Em breve | ||||||||
| FHIR de base válido | Extensões para tipos primitivos
existem na especificação do FHIR e têm um tipo de dados object JSON. |
||||||||
| FHIR de base válido | Apenas um campo é registrado para campos de escolha (fieldname[x]).Por exemplo, effectiveDateTime e effectivePeriod não podem estar presentes na mesma instância de recurso. |
||||||||
| FHIR de base válido | Tipos de dados complexos contêm campos e tipos de dados que correspondem à especificação FHIR. Em breve | ||||||||
| FHIR de base válido | Elementos de estrutura (e elementos em tipos complexos) contêm campos e tipos de dados que correspondem à especificação do FHIR. Em breve | ||||||||
| FHIR de base válido | O elemento de extensões
Os campos value[x] são um tipo válido e contêm conteúdo
de acordo com esse tipo de dados.
Os elementos de extensão podem ser incluídos em qualquer recurso para representar
informações adicionais que não fazem parte da especificação básica. Eles contêm um campo
url que vincula à definição da extensão e um
campo value[x] que contém o valor da extensão.
value[x] precisa ser de uma lista definida de tipos de dados aceitos.
Em breve |
Dados FHIR transformados
Alguns apps transformam dados do FHIR para atender aos próprios requisitos. Exemplo:
- Unir dados de diferentes fontes (normalmente APIs FHIR).
- Mapear códigos para terminologias globais (por exemplo, SNOMED, LOINC, ICD) e padronizar unidades.
- Consolidar e eliminar a duplicação de dados.
- Corrigir problemas de formatação ou outros problemas de qualidade de dados.
- Filtrar registros com base em regras de negócios específicas do app.
Os dados FHIR transformados e não transformados podem ser gravados na Conexão Saúde, desde que estejam em conformidade com a especificação FHIR R4. Recomendamos que você grave dados transformados sempre que possível. Mas não se esqueça das seguintes considerações:
- Apps com casos de uso restritos podem filtrar um número significativo de registros que outros apps no ecossistema poderiam usar para criar valor para o usuário. Nesses casos, pode ser útil gravar o FHIR não transformado que é mais completo. No entanto, informe aos usuários que esse conjunto de dados mais amplo está sendo compartilhado.
- Se você estiver mesclando dados de fontes diferentes, poderá gravar dados
em um único
MedicalDataSourcena Conexão Saúde. Você também precisa atribuir um novo ID a cada recurso para evitar conflitos e atualizar as referências de recursos para apontar para os novos IDs. - A fusão de dados de várias fontes em um único
MedicalDataSourcepode ocultar a origem dos dados. Como geralmente é útil para os consumidores de dados entenderem a origem deles, recomendamos preencher o campometa.sourcede cada recurso com a fonte original do registro (normalmente um URL base do FHIR).