clientflow_backend/docs/CLIENTFLOW_V494_RECONCILIATION_RECENT_WINDOW.md

ClientFlow v4.9.4 — Reconciliation Recent Window Cleanup

Objetivo

A reconciliação deve ser uma fila curta de trabalho operacional, não uma importação histórica de anos anteriores.

Esta versão muda o comportamento por defeito para trabalhar apenas com os últimos 3 dias e adiciona uma ação de limpeza para retirar da fila aberta candidatos antigos já sincronizados.

Alterações

• sync_external_reconciliation.py passa a usar --days 3 por defeito.
• O botão "Sincronizar APIs externas" usa os últimos 3 dias.
• Jasmin, Odoo e Packlink passam a respeitar a janela recente de 3 dias por defeito.
• A página /reconciliation mostra uma ação "Limpar fora dos 3 dias".
• O script cleanup_stale_reconciliation_items.py passa a usar 3 dias por defeito e pode limpar todas as fontes, ou apenas uma fonte.

Comandos úteis

Dry-run:

PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --days 3

Aplicar:

PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --days 3 --apply

Limpar só Odoo:

PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --source odoo --days 3 --apply

Sincronizar apenas últimos 3 dias:

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

Segurança

A limpeza não apaga documentos no Jasmin, vendas no Odoo, envios Packlink ou oportunidades ClientFlow. Apenas marca candidatos antigos de reconciliação como ignored para não aparecerem na fila aberta.