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

1.6 KiB

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.