portal_publico/portal_api/planos_saude/README.md

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 a skill importacao-questor-plano-saude (.claude/skills/) para contexto de negócio (quais operadoras/empresas já estão validadas, o que falta).

Ú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 9 parsers de operadora (Amil, Itamed, Unimed em 3 variantes, Dental Uni, Bradesco em 2 variantes, SulAmérica em 2 variantes) 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.