Files
clientflow_backend/docs/CLIENTFLOW_V495_RECONCILIATION_OPERATION_SUGGESTIONS.md
2026-06-09 22:55:58 +01:00

43 lines
1.6 KiB
Markdown

# ClientFlow v4.9.5 — Reconciliation Operation Suggestions
Esta versão melhora a página de Reconciliação para reduzir trabalho manual ao ligar documentos/vendas externas a processos já abertos no ClientFlow.
## Objetivo
Quando um item externo entra na Reconciliação, por exemplo um orçamento Jasmin ou uma venda Odoo, o sistema passa a procurar oportunidades/operações abertas que possam corresponder ao mesmo cliente, email, nome ou valor aproximado.
O sistema **não liga automaticamente**. Apenas sugere uma ligação pré-preenchida para o operador confirmar.
## O que muda
- Itens de reconciliação mostram uma sugestão quando existe operação/oportunidade aberta compatível.
- A sugestão aparece com o botão `Ligar a esta operação`.
- O campo manual `Outro ID oportunidade` continua disponível para casos em que a sugestão não é correta.
- `Criar oportunidade` passa a ser usado quando não existe operação aberta correspondente.
## Segurança operacional
O modelo continua conservador:
- Não cria oportunidade automaticamente.
- Não confirma pagamentos.
- Não emite documentos.
- Não liga documentos sem confirmação do operador.
## Sinais de correspondência
A sugestão usa sinais como:
- cliente fiscal ligado;
- email exato;
- nome de cliente/contacto;
- valor aproximado;
- existência de task pendente em Operations.
## Fluxo esperado
1. Sync externo cria item de reconciliação.
2. Reconciliação procura operações abertas compatíveis.
3. UI mostra sugestão pré-preenchida.
4. Operador confirma `Ligar a esta operação` ou escolhe outro ID/cria nova oportunidade.