# Importação de Plano de Saúde (Utilitários)

> Ver `CLAUDE.md` nesta mesma pasta para o detalhamento técnico completo (pacote `planos_saude/`, cada operadora parametrizada). Ver `CLAUDE.md` na raiz para arquitetura geral/transversal do Portal. Ver também as skills de contexto de negócio (`.claude/skills/`): `importacao-plano-saude` (leitura/extração dos arquivos de operadora e regras de negócio, independente do sistema contábil de destino — quais operadoras/empresas já estão validadas, o que falta) e `importacao-questor-plano-saude` (a etapa específica do Questor — Cadastro de Regras, planilha padrão, leiaute final).

Única aplicação dentro de "Utilitários" — importa o relatório de faturamento de uma operadora de plano de saúde/odontológico e gera o arquivo de lançamento no leiaute do Questor, com auditoria do que não pôde ser casado automaticamente contra a planilha padrão. Hoje suporta 11 parsers de operadora (Amil, Itamed, Unimed em 4 variantes, Dental Uni, Bradesco em 2 variantes, SulAmérica em 2 variantes, Humana) e um banco de regras de custeio por empresa+operadora, com histórico completo de cada importação e reversão de qualquer alteração feita na revisão.

## Onde mexer

- `portal_api/planos_saude/` — `modelos.py` (dataclasses), `matcher.py` (casamento por CPF ou nome), `leiaute_sistema.py` (planilha padrão do Questor), `pipeline.py` (`OPERADORAS`, `processa_importacao`), `regras_empresa.py` (regras especiais fixas no código), `questor_planilha.py` (busca a planilha padrão direto do Questor via SQL), `operadoras/<nome>/` (um parser por operadora).
- `ImportacaoPlanoSaude`, `ImportacaoPlanoSaudeLinha`, `ImportacaoPlanoSaudeAuditoria`, `ImportacaoPlanoSaudeAlteracao`, `RegraCusteioPlanoSaude`, `VinculoNomeOperadora` (`portal_api/models.py`).
- `importacao-plano-saude.html`/`static/js/importacao-plano-saude.js`/`static/css/importacao-plano-saude.css`.
- Pra adicionar uma operadora nova: ver o `CLAUDE.md` desta pasta antes de escrever o parser — documenta decisões de negócio já validadas com o cliente que não devem ser reinterpretadas sem confirmar de novo.