SCPVendas — Novidades

Uma base de IA que reutiliza a configuração existente (OpenAI / Google Gemini) para apoiar o vendedor no dia-a-dia:

• Briefing de Cliente — reúne saldo, última compra, último relatório e artigos habituais; a IA resume de forma acionável antes da visita.
• Sugestão de Reposição — analisa compras habituais; botão Gerar Documento preenche a pré-encomenda automaticamente.
• Perguntar aos Dados — linguagem natural («quanto vendi este mês?», «top 5 produtos», «clientes com dívida»); microfone voz→texto.
• Relatório de Visita por Voz — dite a nota; a IA estrutura o texto e pré-preenche o relatório.
• IA na ficha do cliente — Briefing IA e Sugestão de Reposição no menu (⋮) e botão (+), sem ir ao Plano de Visitas.

A chave de IA pode ser configurada localmente em Definições → Assistente IA, ou centralmente no BackOffice por vendedor (chega na sincronização). Sem chave, a app avisa e mantém-se totalmente funcional.

Microfone na ficha do cliente — comandos no contexto daquele cliente, sem dizer o nome:

• «saldo» → lê o saldo em voz alta (Text-to-Speech)
• «manda os saldos em aberto por email» → envia a conta corrente
• «partilha a conta corrente» / «por whatsapp» → menu de partilha com PDF do extrato
• «vê as vendas dos últimos produtos» → histórico de compras

Briefing IA e Sugestão de Reposição também no menu (⋮) da ficha.

Base

• Confirmação por voz antes de acções críticas («Sim» / «Não»)
• Fallback por palavras-chave sem internet nem API
• Histórico dos últimos 5 comandos (✓ / ✗)
• Aprendizagem de nomes de clientes no dispositivo

Novas capacidades

• Normalização de acentos — «sao joao» reconhece «São João»
• Abrir ficha por código — «abre o cliente 1500» ou «mil e quinhentos»
• Desambiguação por voz — lista opções numeradas quando há vários resultados
• Aprendizagem automática — grava mapeamento quando resolve 1 cliente/produto
• Reconhecimento flexível — pontua frases parecidas («mostra-me o cliente 1500»)

• Atalhos vocais directos — «Dez Coca-Cola» ou «5 águas» adicionam ao carrinho num passo
• Sugestão inteligente (Smart Copy) — botão «Sugestão» com últimos artigos comprados e quantidades habituais

Ao abrir a ficha do cliente, briefing vocal automático (se assistente activo): saldo em dívida, produto mais comprado e dias desde a última visita — sem leitura manual.

O botão de resumo por voz da ficha passou a mostrar um altifalante (o microfone anterior sugeria gravação) e funciona como interruptor: o mesmo toque que inicia a leitura interrompe-a — útil quando já está à frente do cliente. O ícone repõe-se sozinho quando o resumo termina.

Interruptor no Assistente de Voz para usar a app enquanto conduz, sem tirar os olhos da estrada:

• Perguntas respondidas só por voz (saldo, preço, stock)
• «Abre a ficha do X» passa a ler um resumo falado em vez de abrir o ecrã
• Acções que precisam de ecrã (encomenda, relatório, conta corrente) ficam numa fila proposta quando desligar o modo
• Ligar ao cliente mantém-se — mãos-livres por natureza

O provider (OpenAI / Gemini), o ligar/desligar da IA e a chave de API podem ser definidos centralmente no BackOffice, por vendedor, e chegam ao dispositivo na sincronização (ParametrosVendedor, BD v64).

• A empresa controla qual IA cada vendedor usa e distribui a chave
• Provider e chave só são escritos se o backoffice enviar valor — não apagam configuração local existente
• O ligar/desligar é sempre aplicado (controlo central)
• A chave é encriptada no dispositivo antes de ser guardada

Novo ecrã (Clientes → Rota do Dia) — responde a «por quem vale a pena passar hoje?». Cruza Clientes em Risco, Clientes Perto e Plano de Visitas num só sítio:

• Ordena por urgência (dívida vencida, dias sem comprar/encomendar, saldo negativo) + distância
• Cada linha explica o porquê («dívida vencida há X dias», «nunca comprou», etc.)
• Botões Navegar e Juntar ao plano de hoje — um a um ou todos de uma vez
• Clientes com coordenadas conhecidas aparecem primeiro

Depende de coordenadas nos clientes — ver «Gravar coordenadas» abaixo.

Ficha do cliente → menu ⋮ → Gravar coordenadas aqui — guarda a posição GPS actual como morada do cliente:

• GPS de alta precisão; recusa leituras imprecisas (> 100 m)
• Pede confirmação (alteração ao cadastro)
• Coordenadas sobrevivem às sincronizações — o servidor não as apaga
• Alimenta a Rota do Dia e Clientes Perto sem depender do ERP

Cliente com dívida vencida — aviso destacado no topo da ficha com total vencido, número de documentos e dias do mais antigo. Botão Cobrar abre a Conta Corrente para emitir recibo. Fecha o ciclo cliente em risco → visita → cobrança.

Desactivável em Definições → Outras → Aviso de dívida vencida (ligado por omissão).

Cartão no topo do Dashboard com progresso face às metas mensais, separado por tipo — Encomendas, Vendas e Recibos. Cada tipo mostra realizado, meta e percentagem com barra de progresso. Metas em Definições → Outras → Metas Mensais.

Resumo diário proativo por tipo de documento: notificação automática de manhã (hoje e mês vs meta, visitas do dia) e botão de voz no Dashboard que lê o resumo em voz alta.

• Gerar Rota — rotas nomeadas com ordem optimizada (nearest-neighbor) e persistência (BD v61)
• Selecção múltipla — mover datas, alterar rota, criar relatórios em fila
• Estado por cliente: ✓ visitado · 🔴 sem relatório · 🟢 relatório feito
• Dois mapas: interno (CARTO/OSM) + Google Maps para navegação
• Menu rápido por cliente: criar relatório, marcar visitado, mover data, remover

• Mapa de Carga Consolidado — seleccionar faturas/guias/encomendas da rota; totais por artigo para conferir carga na viatura
• Aviso de Chegada via WhatsApp — mensagem personalizada com tempo estimado («chego em 15 minutos»)

Clientes ordenados por distância, filtro por dias sem visita (7+/30+/90+) e botão Navegar. Requer coordenadas — grave-as na ficha do cliente ou use a Rota do Dia.

Lembretes e tarefas por cliente com filtro Todos/Pendentes, prioridade por cores e integração com notas de voz (Calendário / Alerta / Ambos).

Novo: clique no nome do cliente na lista de alertas para abrir a ficha directamente — útil para ouvir notas de voz associadas.

Serviço diário em segundo plano com notificação push dos artigos abaixo do stock mínimo.

Botão de partilha nativo do Android — WhatsApp, Gmail, Drive, etc.:

• Dashboard — resumo do dia (vendas, visitas, metas) formatado para supervisor
• Detalhe de Produto — ficha simplificada (nome, ref., preço, unidade)
• Conta Corrente, Recibo, Mapa de Stock, Histórico — PDF ou texto

Carregamento de estatísticas, gráficos, resumos de IA e dados históricos em segundo plano. A navegação mantém-se instantânea; eliminação de bloqueios de interface (ANRs) em Ficha de Cliente, Catálogo e Pesquisa.

Pesquisa simultânea em Clientes, Artigos e Documentos, com navegação directa para o registo.

Histórico de compras com imagens dos artigos — perceber comportamento de compra e sugerir novos produtos.

Novo filtro no menu de funil da lista de clientes:

• «Sem encomendar há…» — clientes sem encomendas (ENC/NE) há mais de X dias
• «Sem comprar há…» — clientes sem vendas (FT/FS/FR) há mais de X dias
• Limites rápidos de 30 / 60 / 90 dias ou valor personalizado
• Inclui automaticamente quem nunca comprou/encomendou
• Funil destacado a cor de acento enquanto activo; escolha guardada por base de dados

Além de «Todos», «Atraso» e «Saldo −», o ecrã Clientes em Risco passou a ter:

• Dívida — valores vencidos há mais de X dias (item por liquidar mais antigo da conta corrente)
• S/Enc — sem encomendar há mais de X dias
• S/Compra — sem comprar há mais de X dias

Cada filtro pergunta o limite (30/60/90 ou personalizado). Quem nunca comprou ou encomendou conta como inactividade total.

Separadores Faturação, Encomendas, Resumo e Atividade; tabela de Vendas por Mês com totais e número de documentos.

Artigos complementares, alternativos ou associados — útil para venda sugestiva e substituição.

Menu (⋮) em Ficha de Cliente, Conta Corrente, Artigo, Documento, Encomenda e Recibo — ações configuradas na base de dados: HTTP, páginas externas, APIs ou diálogos.

Consultas sobre a BD e integração com ERP ARTSOFT, reporting, dashboards, logística, APIs REST e BI. Variáveis: {numDoc}, {codCliente}, {nomeCliente}, {codArtigo}, {vendedor}, {emp}, {serie}, {baseDados}. Novas funcionalidades só por configuração.

Nova opção no menu de cada documento, ao lado das existentes — copia o conteúdo sem controlo de material das guias:

Disponível nas mesmas condições da «Duplicar» (fatura/guia, licença válida), no menu ou selecção múltipla. Atenção: o material copiado pode voltar a ser faturado — usar conscientemente.

Assinatura táctil ao gravar ou na lista de faturas; incluída automaticamente no PDF certificado e sincronizada com o BackOffice (tabela DOCSIGN). Activar em Definições → Documentos → Pedir Assinatura Digital.

Menu reorganizado

Menu lateral (9 itens principais) e overflow (⋮) reorganizados por frequência de uso. Assistente de Voz com microfone na barra de título.

• Menu lateral em accordion — grupos expansíveis, sub-itens e badge de pendentes
• Tema Claro / Escuro — transversal a todas as actividades
• Certificações AT (Guias) dinâmicas — geridas remotamente; revalidação 15 dias antes
• Gestão de Bases de Dados — renomear BD e importar por URL; sem licença válida, só demo
• Configuração de IA centralizada — provider, ligar/desligar e chave por vendedor via BackOffice
• Sincronização PHP 5 e PHP 8 — o mesmo getalldata.php (v40) corre nos dois servidores
• Comandos FCM — ForceLogout e SyncNow
• Ordenação — Conta Corrente, Templates, Carrinho, Produtos, Encomendas e Recibos

• Cabeçalhos no tema escuro — Relatório do Dia e Análise Comercial (Actividade) usavam texto escuro sobre fundo escuro; passam a cor de acento (legível em ambos os temas)
• Dois microfones iguais (tablet) — comando de voz do cliente passou a cor distinta (teal) vs pesquisa por voz
• Cêntimos truncados no aviso de cobrança — valor de dívida vencida exacto ao cêntimo

• IVA a 0% em silêncio — quando o código de IVA não existia na tabela, a linha era gravada com taxa zero; corrigido: a app recusa a linha e avisa (documentos, POS, carrinho, templates, inventário)
• Assinatura digital no BackOffice — era capturada e impressa no PDF, mas nunca gravada na tabela DOCSIGN; corrigido nos dois pontos de assinatura

• Clientes em Risco — toque na linha não abria a ficha (código vs id interno); corrigido
• Instalação nova sem 5 tabelas (MobileActions, STInterv, etc.) — corrigido na criação inicial
• Módulo Serviços oculto do menu até sincronização backoffice estar pronta
• Crash ao rodar Dashboard em landscape (NullPointerException) — corrigido
• Eliminação de ANRs em Ficha de Cliente, Catálogo e Pesquisa

• Saldo/dívida não aparecia na lista de clientes em BDs reais — corrigido
• Importar BD sem licença bloqueado (só criar demo)
• Comando «saldos» (plural) abria artigos por engano — tolerância a plurais

• Primeiras linhas em falta nos PDFs — corrigido no motor PDF
• Congelamento ao Sincronizar (NTP na thread principal → segundo plano)
• Diálogo nota de voz só mostrava «Cancelar»
• Imagens de artigos na adição a documentos; quantidade no modo directo
• Bónus (qtdbonus) não propagado; importação ftp:// Android 6+
• Mapa interno bloqueado — tiles CARTO/OSM
• Localização: «Guia Diária» e Analytics em inglês no emulador