Release v4928.1.4.2 stable

docs/CLIENTFLOW_V461_CUSTOMER_MISMATCH_WARNING.md

@@ -0,0 +1,22 @@
+# 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`:
+
+```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.