HL7 FHIR R4 · Padrão Ouro

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.

RecursoPropósitoSystems / EstruturaEndpoint
PractitionerMédico cooperado com CRM ativourn:cfm:br:crm/fhir/Practitioner
PractitionerRoleVínculo médico × organizaçãoReference(Practitioner) + Reference(Organization)/fhir/PractitionerRole
OrganizationHospital, clínica, cooperativaurn:receita:br:cnpj · urn:cnes:br/fhir/Organization
LocationUnidade física com geofenceposition.latitude + position.longitude/fhir/Location
ScheduleEscala mensal de plantõesactor[]: Practitioner + Location/fhir/Schedule
SlotPlantão individual (busy/free)status + start + end + extension:Money/fhir/Slot
ChargeItemEvento faturável após check-outcode: CBHPM/TUSS/fhir/ChargeItem
InvoiceFatura consolidada de Produção MédicalineItem[] + 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