Interoperabilidade FHIR expõe pacientes e consultas no padrão HL7 FHIR R4 para operadoras, hospitais e prontuários externos.
Ativar
1. Funcionalidades → FHIR e API para parceiros
2. Setup em /produtos/fhir_interoperability/setup
3. Chave Bearer em /api_keys
Endpoints
GET /api/fhir/patients/:id— Bundle com PatientGET /api/fhir/appointments/:id— Appointment
Autenticação: Authorization: Bearer hs_live_…
Cada exportação gera log de auditoria LGPD. Encounter e Observation estão no roadmap (fase 2).
Sobre o módulo
Endpoints FHIR R4 para pacientes e consultas (integrações externas)..
Passos de configuração
1. Ativar módulo FHIR (feature_flags_path) — Habilite Interoperabilidade FHIR em Funcionalidades para esta clínica.
2. Ativar API para parceiros (feature_flags_path) — A exportação FHIR usa chaves Bearer da API REST v1 — ative o módulo de parceiros primeiro.
3. Gerar chave de API (api_keys_path) — Crie uma chave nomeada para o integrador (ERP, operadora ou parceiro técnico).
4. Dados clínicos de teste (patients_path) — Cadastre ao menos um paciente (e consultas, se necessário) para validar a exportação.
5. Testar exportação FHIR (product_feature_setup_path) — Execute uma chamada GET de teste com a chave e confirme o JSON FHIR R4.
Tour do gestor (FeatureSetups)
1. O que é interoperabilidade FHIR? — FHIR R4 permite que operadoras, hospitais e parceiros leiam pacientes e consultas da clínica em formato padrão HL7 — com isolamento por organização e trilha de auditoria LGPD.
2. Ativar módulos necessários — Ative «Interoperabilidade FHIR» e «API para parceiros» em Funcionalidades. Sem a API parceiros, não há chaves Bearer para autenticar integrações.
3. Emitir chave para o integrador — Em Chaves de API, gere um token com nome identificável (ex.: «Operadora XYZ — FHIR»). O token completo só aparece uma vez — oriente o parceiro a armazená-lo com segurança.
4. Compartilhar guia do parceiro — Envie ao integrador o guia de onboarding (endpoints, exemplos curl e escopo de dados). Está disponível na página de configuração FHIR e em docs/features/fhir-interoperability-partner-onboarding.md.
5. Monitorar exportações PHI — Cada exportação de paciente FHIR gera log em Auditoria (ação phi.fhir_patient_exported). Revise periodicamente quem acessou dados sensíveis via API.
Atalhos úteis
- Configuração FHIR
- Chaves de API
- Pacientes (REST v1)