clientflow_backend/docs/CLIENTFLOW_V461_CUSTOMER_MISMATCH_WARNING.md

ClientFlow v4.6.1 — Customer mismatch warning tuning

Esta correção reduz falsos positivos no aviso “contacto e cliente fiscal não coincidem”.

O caso típico era uma oportunidade com contacto curto/truncado, por exemplo:

• Contacto/origem: Riotec elec
• Cliente fiscal: Riotec - Electricidade, Aquecimento e Controle, Lda

A heurística anterior comparava strings completas e gerava alerta. A nova heurística compara tokens significativos e aceita abreviações/prefixos como o mesmo cliente provável.

Desativar completamente o aviso

Se o aviso continuar a criar ruído operacional, adiciona no .env:

CLIENTFLOW_CUSTOMER_MISMATCH_WARNING_ENABLED=false

Depois reinicia o serviço.

A validação real antes de criar documentos continua a depender dos dados fiscais do cliente associado e das validações Jasmin/Packlink.