> 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

## 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](/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](/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](/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.
