Integração Plug-and-Play (Farmácias)

Este guia é focado em integrar rapidamente sistemas de farmácia (PDV/ERP) à SafeMed com o mínimo de atrito.

Fluxo recomendado

1. Sua farmácia envia os itens da venda (nome do medicamento e, quando possível, dose em mg).
2. A API retorna alertas e interações, com recomendações e referências (quando disponíveis).
3. Seu sistema decide como exibir: bloqueio, alerta, ou sugestão de ajuste.

Endpoint principal

• POST /api/v1/pharmacy/check

Ele é compatível com o schema de POST /api/v1/interactions/check, mas é documentado e organizado para uso por farmácias.

Cabeçalhos

• X-API-Key: sm_live_...
• Content-Type: application/json

Exemplo mínimo (venda no balcão)

{
  "medications": [
    {"name": "Warfarina", "dose_mg": "5"},
    {"name": "Omeprazol", "dose_mg": "20"}
  ],
  "language": "pt-BR"
}

Exemplo com contexto do paciente (quando disponível)

{
  "medications": [
    {"name": "Metformina", "dose_mg": "850"},
    {"name": "Losartana", "dose_mg": "50"}
  ],
  "patient_record": {
    "patient_reference": "PRONT-12345",
    "conditions": ["diabetes", "hipertensao"],
    "notes": "Sem PII."
  },
  "language": "pt-BR"
}

Boas práticas (sem atrito)

• Envie sempre name (nome comercial ou princípio ativo); a API faz normalização.
• Se você tiver dose em mg, envie dose_mg (aceita 2,5 como string).
• Não envie PII (nome, CPF, telefone, endereço); use apenas referências internas.