HL7 v2

Envie um pedido de medicamento no formato HL7 v2 (ORM^O01 / RDE^O11) e receba a análise de risco nativa da SauBit. Útil para integrações legadas que ainda trafegam HL7 v2.

Copia um prompt pronto com fluxo de integração, payload e exemplos.

Endpoint

POST /api/v1/hl7v2/$check (autenticação por API key, escopo interactions:check).

O corpo pode ser:

• a mensagem HL7 crua (Content-Type: text/plain), com segmentos separados por \r; ou
• um envelope JSON: { "message": "MSH|^~\\&|..." }.

Segmentos lidos

Segmento	Uso
MSH	Cabeçalho; separadores de campo/componente.
PID	Idade (de PID-7, data de nascimento) e sexo (PID-8).
AL1	Alergias (AL1-3).
DG1	Condições/diagnósticos (DG1-3/DG1-4).
RXO / RXE	Medicamentos: nome (RXO-1/RXE-2), dose (RXO-2/RXE-3 + unidades; g→mg).
RXR	Via de administração (associada ao último medicamento).
OBX	Laboratórios por identificador/texto: potássio, INR, QTc.

O nome do medicamento usa o componente de texto do campo codificado (ex.: IBUPRO^Ibuprofeno^L → Ibuprofeno).

Exemplo

curl -X POST "https://api.saubit.com.br/api/v1/hl7v2/\$check" \
  -H "X-API-Key: sm_live_..." \
  -H "Content-Type: text/plain" \
  --data-binary $'MSH|^~\\&|EHR|HOSP|SAUBIT|SAUBIT|20260629||RDE^O11|MSG1|P|2.5\rPID|1||123||SILVA^JOAO||19500101|M\rDG1|1||N18.5^Insuficiência renal crônica^I10\rRXE|1|IBUPRO^Ibuprofeno^L|400|||mg\rRXE|2|NAPRO^Naproxeno^L|500|||mg'

A resposta é o JSON nativo da SauBit (prescription_risk_level, interactions, clinical_alerts, …), idêntico ao /interactions/check. Mensagens sem MSH ou sem RXO/RXE retornam 422.

Suporta também Idempotency-Key (ver Boas práticas).