> For the complete documentation index, see [llms.txt](https://docs.wave.pt/wave-trade-x/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wave.pt/wave-trade-x/avancadas/releases.md).

# Releases

Histórico de versões do WaveTradeX com as principais alterações, novas funcionalidades e correções.

## Versão 3.13.05 — 19/06/2026

### Novas Funcionalidades

**Controlo de Taxa de Devolução**

Implementado mecanismo de controlo da taxa de devolução de artigos por cliente. Ao selecionar um artigo num documento, o sistema calcula a percentagem de devoluções no período configurado e, conforme o tipo de documento, pode:

* Avisar o utilizador com um popup informativo
* Bloquear a inserção do artigo.

Para mais detalhes, consultar a página  [Taxa de devolução](https://docs.wave.pt/wave-trade-x/app/estrutura/clientes/documentos.md#taxa-de-devolucao).

**Análise de Taxa de Devolução**

Adicionada nova análise no menu de Análises que permite consultar a taxa de devolução de forma global, sem ter de entrar num cliente específico. A análise apresenta a taxa por cliente no período escolhido e, ao tocar num cliente, abre o detalhe por artigo. O cálculo é feito em valor (€) através da fórmula:

`Taxa (%) = (devoluções € / vendas € ) * 100`&#x20;

Clientes sem qualquer venda no período não aparecem na listagem.

**Agrupamento de Artigos em Documentos**

Os artigos adicionados ao documento passam a ser agrupados automaticamente, quer sejam inseridos pela via normal quer através da galeria. Evita linhas duplicadas, quando o mesmo artigo é adicionado mais do que uma vez, a quantidade é somada à linha existente [Agrupamento de Artigos](https://docs.wave.pt/wave-trade-x/app/estrutura/clientes/documentos.md#agrupamento-de-linhas).

#### Correções

**Recibos — Seleção de Notas de Crédito**

Corrigido o comportamento da seleção de notas de crédito no ecrã de recibos:

* Cálculo do valor por regularizar para notas de crédito corrigido (vinha a zero por erro no cálculo dos valores em crédito).
* Possibilidade de selecionar uma nota de crédito isoladamente, sem ser obrigatório selecionar uma fatura primeiro.
* Permite usar parcialmente o valor de uma nota de crédito (ex: NC de 40 € usada apenas para abater 20 €), através do botão `1/€`.
* Validação do valor total a regularizar movida para o momento de avançar para o pagamento.

**Duplicação das linhas**

Corrigido comportamento de duplicação de linhas ao não permitir o duplo toque ao terminar o documento.

## Versão 3.13.09 — 09/07/2026

#### Novas Funcionalidades

**Linhas de Taxa Automáticas (SDR)**

Implementado mecanismo genérico de linhas de taxa automáticas, inicialmente para o SDDR (Sistema de Depósito e Devolução de Embalagens / Volta), mas que funciona para qualquer tipo de taxa. Para mais detalhes consultar a página de [SDR](https://docs.wave.pt/wave-trade-x/app/estrutura/clientes/documentos.md#sddr-sistema-de-deposito-e-devolucao-de-embalagens).

Quando um artigo com taxas configuradas é inserido num documento, a aplicação gera automaticamente linhas de taxa adicionais com o valor, quantidade e IVA corretos.

**Modos de funcionamento:**

Modos de funcionamento:

* Modo individual (`GroupTaxLines = false`): cada linha-pai gera a sua própria linha de taxa filha.
* Modo agrupado (`GroupTaxLines = true`): todas as linhas de taxa do mesmo tipo são fundidas numa única linha totalizadora.
* `AllowDeleteTaxLines` controla se o utilizador pode apagar linhas de taxa manualmente.

**Comportamento automático:**

* Inserção de artigo → linhas de taxa criadas automaticamente.
* Edição de quantidade → linhas de taxa recalculadas automaticamente.
* Remoção do artigo-pai → linhas de taxa filhas apagadas em cascata (ou recalculadas no modo agrupado).

{% hint style="warning" %}
O SDDR ainda não está totalmente testado. Não deve ser configurado em clientes até os testes estarem concluídos. Sem o SDDR configurado, a aplicação mantém o comportamento habitual sem qualquer impacto.
{% endhint %}

**Assunto e Corpo do Email Configuráveis**

O assunto e corpo do email enviado com o documento passam agora a suportar variáveis dinâmicas. No backoffice, nos campos `EmailSubject` e `EmailMessage` do tipo de documento (TD), é possível usar placeholders com a sintaxe `{{doccab.campo}}` que são substituídos automaticamente pelos valores do documento.

**Exemplos:**

* `{{doccab.DocNumber}}` → número do documento
* `{{doccab.CuName}}` → nome do cliente
* `{{doccab.CuNumber}}` → número do cliente

Se os campos `EmailSubject` / `EmailMessage` estiverem vazios, mantém-se o comportamento anterior.

#### Correções

**Correção da Fórmula de Plafond**

A fórmula de validação do plafond (limite de crédito) na finalização do documento foi corrigida. Anteriormente comparava apenas o saldo da conta corrente com o plafond. Agora inclui também o valor do documento atual:

<mark style="color:orange;">CC + Valor do Documento (c/ IVA) <= Plafond</mark>

**Correções iOS**

* Os gráficos da conta corrente por antiguidade e top 5 zonas não apareciam nos dispositivos iOS mais recentes. Corrigido.
* As linhas de separação dos catálogos desapareciam nas versões mais recentes de iOS. Corrigido.

**Correções Gerais**

* Nos catálogos, na adição rápida, a unidade secundária não aparecia no contador quando o artigo tinha unidade alternativa configurada. Corrigido.
* No dashboard, ao selecionar "Este mês" nas vendas, a barra do gráfico ficava invisível. Corrigido.
* O pop-up de pré-visualização do template ao enviar encomenda por email ficava em branco. Corrigido.
* A app desligava-se ao introduzir linhas numa encomenda. Corrigido.

## Versão 3.13.10 — 16/07/2026

#### Novas Funcionalidades

**Conversão de Lead para Potencial — Validação de NIF**

Ao converter uma lead para potencial, a aplicação passa agora a validar se o NIF está preenchido. Caso não esteja, é apresentado o aviso "NIF não preenchido" e é aberta a página para inserção do NIF antes de prosseguir com a conversão.

**Código de Barras no PDF da Encomenda**

O PDF gerado ao enviar a encomenda por e-mail passa a suportar a apresentação do código de barras de cada artigo em formato legível (human readable code). O template HTML do PDF é configurado no Portal, bastando utilizar `{{st.codigo}}` para inserir o código.

**Ordenação por Família no Catálogo**

Os artigos no catálogo passam agora a suportar ordenação por família. Quando ativa, os artigos são apresentados agrupados por família e, dentro de cada família, ordenados pela referência do artigo. A opção está disponível nos filtros do catálogo e funciona com ou sem famílias selecionadas.

**SDR (Sistema de Depósito e Reembolso) — Concluído**

O SDR, que na versão anterior se encontrava em fase de testes, foi aprovado e encontra-se agora em produção.

#### Correções

O QR Code utilizado para a configuração inicial do tablet não estava a funcionar corretamente. Corrigido.

Ao adicionar um artigo com grelha de cores e tamanhos pelo catalogo na barra de cima não abria o popup de cores e tamanhos. Corrigido.

A aplicação fechava ao carregar no botão Avançar na cópia de linhas. Corrigido.

## Versão 3.14.15 — 13/10/2026

#### Novas Funcionalidades

**ARTIGOS COMPOSTOS**

Foi implementado o mecanismo de artigos compostos, em que um artigo-pai é constituído por vários componentes.

**ARTIGOS EM ENCOMENDAS PENDENTES**

Foi implementada a consulta dos artigos que já constam em encomendas de cliente pendentes (encomendas sincronizadas mas ainda não satisfeitas/faturadas), acessível a partir do ecrã de encomenda de cliente. É uma funcionalidade apenas online.

**MIGRAÇÃO DA VERSÃO ANTERIOR**

Foi implementado o mecanismo de migração a partir da versão anterior da aplicação, permitindo transferir a base de dados e manter o terminal associado ao dispositivo.

**CIFRAGEM DA BASE DE DADOS**

Foi implementada a cifragem da base de dados na exportação e importação, para proteger os dados durante a transferência entre dispositivos.

**TAREFAS ONLINE**

O écran de Tarefas passa a funcionar apenas quando temos acesso ao servidor e a informar tarefas lidas e tarefas que estão por ler.

**NOTIFICAÇÕES**

Quando é criada uma nova tarefa no portal, é gerada uma notificação no tablet a informar dessa nova tarefa. A área de notificações (sininho no dashboard) passa a ter uma vertente online devido às notificações criadas pelas tarefas. Estas notificações são obtidas sempre que se carrega no botão de Refresh do Dashboard, ou em último caso, de 30 em 30 minutos, valor default para o Refresh automático do Dashboard.

**NOVA PESSOA**

Ao associar uma Pessoa ao registo de uma nova visita, existe agora um botão para criar uma Nova Pessoa. A pessoa criada, é automaticamente associada à visita a ser criada.

**ASSINATURA NOS DOCUMENTOS**

Foi implementada a recolha da assinatura do cliente no tablet, no momento de finalização do documento.

**ESCOLHA DE TEMPLATE DO DOCUMENTO**

Foi implementada a possibilidade de o utilizador escolher o template de PDF a utilizar no envio do documento por email.

**ANÁLISE ENTIDADES NÃO VISITADAS**

Entidades que não foram visitadas desde a data X / há pelo menos X dias, com a indicação da data da última visita e quantos dias se passaram.

**PESQUISA PELO CÓDIGO POSTAL NO ECRÃ DE CLIENTES**

Foi adicionado o filtro *Código Postal na pesquisa no* ecrã de Clientes.

#### Correções

**CORREÇÕES iOS**

* Fonte das vendas por artigos e últimas visitas
* No mesmo local a quebra na palavra referencia
* Linhas introduzidas no ecrã de pesquisa, uma posição acima
* Designação no histórico maior
* Ecrã de finalização após resumo de linhas, mais largo e reduzir ao scrool, p.ex. Local entrega e data entrega na mesma linha - Feito Observações um pouco mais estreito, já que fica mais largo
* Na opção produtos, não estou a ver o icon para abrir PDF - Feito

**Correções gerais**

* Análise agenda de Dívida provoca o crash da aplicação - Feito
* A exportação para PDF da agenda de dívidas provoca o crash da aplicação - Feito
* Aplicação crashou na análise: Artigos Vendidos no último ano. Quando não crasha, é muito lenta a entrada nesta análise - Feito
* Aplicação crashou na análise: Artigos Vendidos no último ano. Quando não crasha, é muito lenta a entrada nesta análise - Feito.
* Validar funcionamento de todos os filtros de pesquisa. Identifiquei que o de código postal não está a funcionar, mais alguns outros - Feito
* Tanto na vista de 9 como de 4 o código de barras está sobreposto à imagem do artigo - Feito.
* Desenvolver novo filtro de pesquisa Vendedor + Zona semelhante ao que já existe no Trade 5. Depois posso mostrar como funciona - Feito&#x20;
* Ao selecionar o filtro de produtos nos últimos x dias, os valores de faturação aparecem a 0 - Feito
* Limite de crédito: clientes que têm apenas notas de crédito fora do limite de crédito estão a ficar bloqueados. Corrigido.
* Em certas referências os detalhes do artigo não aparecem PAT 8725. Corrigido.
* App crasha ao gravar fotografia numa visita. Corrigido.
* Foram criados dois filtros para filtrar por vendedor com multiseleção em clientes e em consulta de faturas.
* Consulta de Documentos Online não devolvia dados.
* No momento de finalização de documentos, caso exista no máximo 3 documentos por sincronizar, a app tenta sincronizar esses documentos antes de enviar o atual para o servidor. Caso os documentos tenham ***pedidos de email associados***, por sincronizar, também são enviados para o servidor antes de enviar o documento atual.&#x20;
