clientflow_backend/docs/CLIENTFLOW_V497_RECONCILIATION_PAGE_HOTFIX.md

ClientFlow v4.9.7 — Reconciliation Page Hotfix

Corrige falhas internas em /reconciliation quando a base de dados ainda não tem todas as colunas auxiliares usadas pelas sugestões automáticas.

Alterações

• A página de Reconciliação passa a continuar a abrir mesmo que a pesquisa de sugestões falhe.
• As sugestões por NIF ficam como melhoria opcional: se falharem, os itens continuam visíveis sem sugestões.
• ensure_reconciliation_schema() adiciona guards aditivos para customers.tax_id, customers.email e opportunities.local_customer_id quando necessário.
• Não há alteração destrutiva de dados.

Validação

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q

Depois de instalar

Reiniciar a API e abrir:

/reconciliation

Se a página abrir sem erro, reexecutar a sincronização recente:

PYTHONPATH=. python scripts/sync_external_reconciliation.py --all --days 3 --limit 50