BateEscala é FHIR Ready
Arquitetura de integração baseada no padrão mundial HL7 FHIR R4 (Fast Healthcare Interoperability Resources). Se o seu ERP é moderno, a gente conecta sem reescrever código.
Recursos FHIR publicados
Endpoints REST padrão HL7 FHIR R4.
| Recurso | Propósito | Systems / Estrutura | Endpoint |
|---|---|---|---|
| Practitioner | Médico cooperado com CRM ativo | urn:cfm:br:crm | /fhir/Practitioner |
| PractitionerRole | Vínculo médico × organização | Reference(Practitioner) + Reference(Organization) | /fhir/PractitionerRole |
| Organization | Hospital, clínica, cooperativa | urn:receita:br:cnpj · urn:cnes:br | /fhir/Organization |
| Location | Unidade física com geofence | position.latitude + position.longitude | /fhir/Location |
| Schedule | Escala mensal de plantões | actor[]: Practitioner + Location | /fhir/Schedule |
| Slot | Plantão individual (busy/free) | status + start + end + extension:Money | /fhir/Slot |
| ChargeItem | Evento faturável após check-out | code: CBHPM/TUSS | /fhir/ChargeItem |
| Invoice | Fatura consolidada de Produção Médica | lineItem[] + totalNet + totalGross | /fhir/Invoice |
Arquitetura em camadas
┌─────────────────────────────────────────────────────────┐
│ BateEscala (Business Layer) │
│ Shifts · Payments · MedScore · Geofencing │
└───────────────────┬─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ FHIR R4 Abstraction Layer (Middle Layer) │
│ Practitioner · PractitionerRole · Organization │
│ Schedule · Slot · ChargeItem · Invoice · Consent │
└───────────────────┬─────────────────────────────────────┘
│
┌──────────┼──────────┬──────────┬──────────┐
▼ ▼ ▼ ▼ ▼
┌────────────┐ ┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐
│ MV (Soul) │ │ Tasy │ │ SGU │ │ Cardio │ │ SAP S/4 │
│ rest-nat │ │ hl7v2 │ │ rest │ │ rest │ │ rest │
└────────────┘ └─────────┘ └────────┘ └────────┘ └─────────┘
PLANO B UNIVERSAL
│
▼
┌───────────────────┐
│ Export Engine │
│ TISS XML · CSV │
│ Configurável por │
│ gestor hospitalar │
└───────────────────┘Exemplo: Practitioner com CRM
Payload FHIR R4 que o BateEscala publica ao registrar um médico cooperado.
{
"resourceType": "Practitioner",
"id": "be-prac-12345",
"identifier": [
{
"use": "official",
"system": "urn:cfm:br:crm",
"value": "SP:123456"
}
],
"active": true,
"name": [{ "text": "Dra. Ana Silva", "family": "Silva", "given": ["Ana"] }],
"telecom": [{ "system": "email", "value": "ana@exemplo.com" }],
"qualification": [
{
"code": {
"coding": [
{ "system": "urn:ans:br:tuss", "code": "225125", "display": "Clínica Médica" }
]
},
"period": { "start": "2019-03-01" },
"issuer": { "display": "CFM" }
}
]
}Dúvidas técnicas comuns
O que significa ser "FHIR Ready"?
Significa que a plataforma modela seus dados nativamente segundo o padrão HL7 FHIR R4 — Practitioner, PractitionerRole, Organization, Schedule, Slot, ChargeItem e Invoice. Qualquer ERP hospitalar com gateway FHIR se conecta sem desenvolvimento custom — o padrão é mundial, mantido pelo HL7 International desde 2014.
Por que FHIR e não HL7 v2?
HL7 v2 (mensagens via MLLP) ainda domina em ambientes assistenciais legados, mas FHIR R4 é o padrão adotado por todos os novos sistemas (Tasy Cloud, MV Atlas, Philips HealthSuite, SAP S/4HANA Health). O BateEscala suporta HL7 v2 como fallback para integrações legadas, mas FHIR é o caminho principal.
Quais recursos FHIR o BateEscala publica?
Practitioner (médico + CRM), PractitionerRole (vínculo médico × hospital), Organization (hospital/cooperativa), Location (unidade física com geofence), Schedule (escala mensal), Slot (plantão individual), ChargeItem (evento faturável após check-out) e Invoice (fatura consolidada mensal de Produção Médica).
Como funciona a autenticação na camada FHIR?
OAuth 2.0 com SMART-on-FHIR para integrações clínicas. Para integrações server-to-server, client credentials com mTLS. Todas as requisições são assinadas com JWS e auditadas em logs imutáveis por 5 anos (requisito CFM).
Vocês usam Terminology Services?
Sim. CBHPM (AMB), TUSS (ANS) e SNOMED CT Brasil para especialidades. Para códigos proprietários de hospitais específicos, mantemos um mapper configurável na UI de administrador.
Receba acesso à documentação FHIR completa
Compartilhamos OpenAPI specs, exemplos de Bundle FHIR, Postman collections e credenciais sandbox com CIOs e arquitetos de integração hospitalar.
Solicitar documentação técnica