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;
• guarda o histórico e exporta o resultado em XLSX.

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).
• ConciliacaoFornecedor, ConciliacaoFornecedorConta, ConciliacaoFornecedorVinculo, ConciliacaoFornecedorLancamento (portal_api/models.py).
• conciliacao-fornecedores.html / static/js/conciliacao-fornecedores.js / static/css/conciliacao-fornecedores.css.