# Changelog of Brazil Health Insurance Data — Operadoras ANS (`matheus_dev_natal/brazil-health-insurance-ans`) Actor

- **URL**: https://apify.com/matheus_dev_natal/brazil-health-insurance-ans/changelog.md
- **Full Actor documentation**: https://apify.com/matheus_dev_natal/brazil-health-insurance-ans.md

## Changelog

### 0.1 (2026-08-21)

Primeira versão.

- **Modo `complaints`:** ranking de operadoras pelo Índice Geral de Reclamações (IGR, metodologia 2023 — reclamações por 100 mil beneficiários), por cobertura (médica/odontológica), porte, modalidade e competência (série desde 2015-01). Por padrão compara só operadoras de grande porte, para o ranking não misturar escalas incomparáveis.
- **Modo `operators`:** busca no cadastro das operadoras ativas por nome (ignorando acento e maiúscula), registro ANS, CNPJ, modalidade e UF.
- **Modo `history`:** série mensal de IGR, reclamações e beneficiários de uma operadora, com janela configurável.
- **Dossiê por operadora** nos modos `complaints` e `operators`: IDSS (nota oficial de qualidade da ANS, com o ano da avaliação e as 4 dimensões — `idss`, `idssAno`, `idqs`, `idga`, `idsm`, `idgr`) e classificação prudencial vigente (`classificacaoPrudencial`, `classificacaoPrudencialReferencia`), unidos ao cadastro por registro ANS. O modo `history` não recebe esses campos de propósito: são o estado atual da operadora e repeti-los em cada mês da série faria dado de hoje parecer histórico.
- Contatos institucionais atrás do toggle `includeContacts` (desligado por padrão); dado pessoal de representante legal nunca é retornado.
- Cobrança exclusivamente pelo evento nativo por item entregue; `maxItems` estrito; deduplicação e ordenação determinística antes da gravação.
- **Fora de escopo, por decisão:** taxa de resolutividade (série da ANS parada em 2019-10) e acreditação de operadoras (arquivo sem atualização desde 2020). Ambas seriam dado obsoleto apresentado como atual.