analise_uso_plano - Pipo Public API

Retorna a análise detalhada do uso do plano de saúde de uma empresa: tendências de utilização e como o uso se distribui entre os beneficiários.

Parâmetros

Parâmetro	Obrigatório	Descrição
`company_id`	Sim	UUID da empresa na Pipo.
`carrier_name`	Não	Nome da operadora, como aparece em `listar_operadoras_da_empresa`. Se você não informar, a ferramenta não busca a análise. Ela devolve os contratos e as bases publicadas da empresa, para você escolher a operadora.
`start_date`	Não	Mês de início, no formato `YYYY-MM`. Padrão: 11 meses antes do mês atual (uma janela de 12 meses).
`end_date`	Não	Mês de fim, no formato `YYYY-MM`. Padrão: mês atual.

A ferramenta recusa o período quando o início é posterior ao fim. Ela também recusa um intervalo de mais de 36 meses entre o início e o fim.

Há uma limitação conhecida na base de uso do plano: o período dos dados pode não ser igual ao período pedido. A ferramenta não detecta nem avisa essa diferença. O campo requested_period da resposta mostra só o período pedido, não o período dos dados. Antes de comparar com outras análises, confira os meses que aparecem nos dados.

Exemplos de perguntas

“Analise o uso do plano da empresa X”
“Como está a utilização do plano nessa empresa em 2025?”