clientflow_backend/docs/CLIENTFLOW_V4926_8_3_NOTES.md

ClientFlow v4926.8.3 — Jasmin current document consistency

Objetivo

Corrige inconsistências observadas em oportunidades que já têm orçamento Jasmin importado:

• não mostrar orçamentos antigos ainda abertos como candidatos principais quando já existe um orçamento Jasmin mais recente associado;
• não sugerir Criar orçamento Jasmin no cockpit quando a oportunidade já tem commercial_documents Jasmin;
• reduzir risco de duplicar orçamentos por engano.

Regras novas

Current document wins

Se a oportunidade já tem um documento Jasmin quotation ou proforma, candidatos encontrados em reconciliation_items com data/série menor ou igual ao documento atual são ocultados por defeito.

Candidatos mais recentes continuam a aparecer como substituição possível.

Workflow awareness

O plano de ação passa a considerar também commercial_documents, não apenas operation_links:

• commercial_documents.system='jasmin' AND document_kind='quotation' conta como orçamento existente;
• document_kind='proforma' conta como pró-forma;
• document_kind='invoice' conta como fatura.

Assim o cockpit deixa de mostrar Depois: Criar orçamento Jasmin quando já existe orçamento importado.

Botão criar orçamento

Quando já existe documento Jasmin, o botão principal deixa de ser Criar orçamento e passa para uma ação secundária:

Novo orçamento adicional

com confirmação explícita.

Validação recomendada

Na oportunidade SEMENTENERGIAS:

• ORC.ORC2026.158 deve continuar importado;
• ORC.ORC2026.137 não deve aparecer como candidato acionável por defeito;
• cockpit deve deixar de mostrar Depois: Criar orçamento Jasmin;
• botão de orçamento deve ser secundário e com confirmação se já existir documento.