Release v4928.1.4.2 stable

docs/CLIENTFLOW_V4921_RESET_RECONCILIATION.md

@@ -0,0 +1,52 @@
+# ClientFlow v4.9.21 — Reset seguro da reconciliação gerada
+
+## Objetivo
+
+Permitir limpar candidatos de reconciliação gerados por sincronização externa e correr novamente o processo com o método multi-compra.
+
+A limpeza é limitada por defeito a:
+
+- `source_system IN ('jasmin', 'odoo', 'packlink')`
+- `status IN ('open', 'needs_review', 'ignored')`
+- `opportunity_id IS NULL`
+
+Não apaga oportunidades, documentos comerciais, comprovativos de pagamento, vendas Odoo, documentos Jasmin, envios Packlink, operation links ou eventos de oportunidade.
+
+## Comandos
+
+Pré-visualizar:
+
+```bash
+PYTHONPATH=. python scripts/reset_reconciliation_generated.py
+```
+
+Aplicar:
+
+```bash
+PYTHONPATH=. python scripts/reset_reconciliation_generated.py --apply
+```
+
+Sincronizar novamente:
+
+```bash
+PYTHONPATH=. python scripts/sync_external_reconciliation.py --all --days 30 --limit 200
+PYTHONPATH=. python scripts/sync_reconciliation_candidates.py
+```
+
+Para voltar à janela operacional curta:
+
+```bash
+PYTHONPATH=. python scripts/sync_external_reconciliation.py --all --days 3 --limit 100
+```
+
+## Backup
+
+Ao aplicar, o script cria antes uma tabela de backup:
+
+```text
+reconciliation_items_reset_backup_YYYYMMDD_HHMMSS
+```
+
+## Nota
+
+Se já existirem oportunidades ou ligações erradas criadas pela reconciliação antiga, elas não são removidas por este script. Devem ser revistas em separado, porque já podem ter eventos, tarefas e operação associada.