Autorização

Análise de pedido de autorização

Tier 2

Confere protocolo clínico e cobertura de um pedido de autorização antes da resposta.

Preço a definir

O sandbox abre para esta API quando o preço dela for definido.

Como funciona

Lê o pedido de autorização — procedimento, CID, justificativa clínica — e confere aderência ao protocolo clínico e à cobertura contratual, devolvendo um parecer de apoio e as evidências que o sustentam. Não decide a autorização; apoia quem decide.

Exemplo

Requisição

curl https://api.exemplo.com/v1/authorization/analyze \
  -H "Authorization: Bearer aid_live_..." \
  -H "Content-Type: application/json" \
  -d '{"beneficiario_id":"ben_58291","procedimento_tuss":"31009018","cid":"M17.1","justificativa":"Dor e limitação funcional há 8 meses, falha em tratamento conservador."}'

Resposta

{
  "id": "auth_01J8XD",
  "protocol_match": {
    "compatible": true,
    "protocol": "Artroplastia de joelho — DUT 63"
  },
  "coverage": {
    "covered": true,
    "requires_second_opinion": false
  },
  "evidence": [
    {
      "type": "tratamento_conservador",
      "detail": "Falha documentada de tratamento conservador por mais de 6 meses",
      "weight": 0.4
    }
  ],
  "note": "Parecer de apoio. Não substitui a decisão da auditoria médica.",
  "billing": {
    "sku": "authorization.analyze",
    "units": 1,
    "amount": null,
    "currency": "BRL"
  }
}

O que não é cobrado

Essas situações não geram cobrança, mesmo que a chamada aconteça.

Erro de validação de entrada
Qualquer erro 5xx

Desconto por volume

Faixa mensal	Desconto
0 a 10.000 pedidos	Sem desconto
10.000 a 100.000 pedidos	7%
Acima de 100.000 pedidos	15%

O desconto vale só para as unidades dentro de cada faixa — as primeiras 10.000 seguem no preço cheio, como nas faixas do imposto de renda.

Tier 2 — o que falta para desbloquear

Exige CNPJ ativo e e-mail corporativo