portal_publico/portal_api/conciliacao_fornecedores

Conciliação de Fornecedores (Utilitários)

Ver CLAUDE.md nesta mesma pasta para o detalhamento técnico (motor de conciliação, alertas, API). Ver CLAUDE.md na raiz para a arquitetura geral do Portal.

Ferramenta para o contador conciliar as contas de fornecedores de uma empresa. Ele exporta do Questor o razão contábil de fornecedores (.xlsx ou .csv), informa o código da empresa (o nome vem do Questor) e anexa o arquivo. A ferramenta:

• vincula, por valor e data, os pagamentos (débitos) aos títulos (créditos) de cada fornecedor, inclusive vários pagamentos somando um título e parcelas;
• mostra, por fornecedor, conta, saldo inicial, saldo residual e a situação (conciliada, pendente de pagamento, atenção, divergente, validada);
• separa numa tela própria os títulos em aberto há mais de 3 meses, com validação por fornecedor (não bloqueiam a conciliação); alerta pagamentos sem título (divergência), diferenças pequenas (possível juros/desconto) e conta transitória com saldo;
• deixa o contador desfazer e criar vínculos, registrar observação e validar a conta;
• mantém uma conciliação por empresa: no mês seguinte, o contador anexa o razão atualizado ("Atualizar"), que substitui o anterior e refaz a análise, mantendo os vínculos e decisões dos lançamentos que continuam no arquivo novo;
• exporta o resultado em XLSX;
• gera um relatório de análise para o contador, que reúne as decisões tomadas (validações, ajustes de vínculo, revisão dos títulos antigos) e aponta as situações de risco (conta transitória com saldo, saldo devedor, pagamento sem título, possível duplicidade, títulos antigos por faixa), com um risco geral.

Acesso restrito ao perfil "Inovação", liberado para outros perfis pela tela de Perfis de Acesso.

Onde mexer

• portal_api/conciliacao_fornecedores/: parser.py (leitura do razão), motor.py (vínculos automáticos), alertas.py (situação e alertas), exportacao.py (XLSX), atualizacao.py (comparação do razão novo com o anterior), relatorio.py (relatório de análise, template conciliacao-fornecedores-relatorio.html).
• ConciliacaoFornecedor, ConciliacaoFornecedorConta, ConciliacaoFornecedorVinculo, ConciliacaoFornecedorLancamento (portal_api/models.py).
• conciliacao-fornecedores.html / static/js/conciliacao-fornecedores.js / static/css/conciliacao-fornecedores.css.