# OS 92022 - MELHORIA - SPD - INSERIR FILTRO DE NOME FANTASIA E RECALCULAR PARCELAS NO SPD

#### **Objetivo:**

A correção implementada visa melhorar a **usabilidade e consistência do módulo SPD**, garantindo que:

1. **Fornecedor possa ser localizado pelo Nome Fantasia** (além de Código e Razão Social) durante a elaboração do SPD, resolvendo a dificuldade relatada quando o Fantasia não está contido na Razão Social.
2. Em **SPD parcelado**, o **valor total do SPD permaneça fixo** (não pode “somar” e ultrapassar o total) quando o usuário **alterar manualmente** uma ou mais parcelas, permitindo **recalcular automaticamente** as demais parcelas mediante confirmação do usuário.

#### **Premissas:**

- Necessário o ambiente estar atualizado com a versão **SPD** de número **131217 Genexus 17** ou superior;

#### **Teste realizado após a atualização** 

#### **Cenário 01 — Buscar fornecedor pelo Nome Fantasia no SPD (novo lançamento)**

<span style="text-decoration: underline;">Pré-requisitos</span>

- Usuário com permissão para **incluir SPD**.
- Existir fornecedor com:
    
    
    - **Razão Social** diferente do **Nome Fantasia** (para reproduzir o problema).
    - Nome Fantasia preenchido no cadastro.

<span style="text-decoration: underline;">Passo a passo</span>

1. Acessar o módulo **SPD**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/PjAKTrNXatcCOO2d-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/PjAKTrNXatcCOO2d-image.png)
2. Clicar em **Novo SPD**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/fJdWkqJJX1P8KoLI-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/fJdWkqJJX1P8KoLI-image.png)
3. Na seleção/busca de fornecedor, localizar os campos/colunas disponíveis na listagem.
4. Pesquisar o fornecedor **digitando o Nome Fantasia** no filtro de busca.
5. Aplicar o filtro e verificar o resultado na grade.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/XMC9tSINHg3XevCD-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/XMC9tSINHg3XevCD-image.png)

<span style="text-decoration: underline;">Resultado esperado</span>

- A listagem de fornecedores deve exibir a **coluna “Fantasia”** e permitir **filtrar por Fantasia**.
- O fornecedor deve ser retornado quando o usuário pesquisar pelo **Nome Fantasia**, mesmo que a Razão Social não contenha o Fantasia.
- Ao selecionar o fornecedor retornado, o SPD deve prosseguir normalmente para a próxima etapa, sem erro.

---

#### **Cenário 02 — Parcelamento padrão mantém o total do SPD (geração automática de parcelas)**

<span style="text-decoration: underline;">Pré-requisitos</span>

- Usuário com permissão para **incluir/editar SPD**.
- Fornecedor selecionado.
- Valor de SPD definido (ex.: **R$ 5.000,00**).
- Condição de pagamento permitindo parcelamento (ex.: **4 parcelas**).

<span style="text-decoration: underline;">Passo a passo</span>

1. Criar/editar **SPD** para um fornecedor.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/iADnffUzrZ2RTViH-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/iADnffUzrZ2RTViH-image.png)
2. Informar **Valor total do SPD = R$ 5.000,00**.
3. Definir parcelamento em **4x**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/TFqP14TsgzJjW9lr-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/TFqP14TsgzJjW9lr-image.png)
4. Avançar para a etapa de rateio e/ou parcelas (conforme fluxo do sistema).
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/5QEfatBFUzsZR19k-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/5QEfatBFUzsZR19k-image.png)
5. Verificar as parcelas geradas automaticamente.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/2VCUFxtlVFxenbEw-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/2VCUFxtlVFxenbEw-image.png)

<span style="text-decoration: underline;">Resultado esperado</span>

- O sistema deve gerar **4 parcelas**.
- Cada parcela deve vir com **R$ 1250,00** (se divisão igual padrão).
- O **somatório das parcelas** deve ser **exatamente R$ 5.000,00**.
- O “valor total do SPD” deve permanecer **R$ 5.000,00**.

---

#### **Cenário 04 — Alterar uma parcela e NÃO recalcular as demais (Não)**

<span style="text-decoration: underline;">Pré-requisitos</span>

- SPD parcelado em 4x gerado (como no cenário 03).
- Total do SPD: **R$ 5.000,00**.

<span style="text-decoration: underline;">Passo a passo</span>

1. Com as parcelas geradas (4x de R$ 1250,00), editar a **Parcela 2** e alterar o valor para **R$ 1150,00**.
2. Clicar em **Gravar/Salvar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/69Xc5SN0Gj0Hso1I-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/69Xc5SN0Gj0Hso1I-image.png)
3. Na confirmação “deseja ajustar as demais parcelas?”, clicar em **Não**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/2MtaAVzSySTGnUBM-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/2MtaAVzSySTGnUBM-image.png)
4. Conferir os valores das demais parcelas.
5. Conferir o total e/ou algum indicador do valor total do SPD (se o sistema exibe total do parcelamento/total SPD).
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/lZ5VG24LqORS2V9x-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/lZ5VG24LqORS2V9x-image.png)

<span style="text-decoration: underline;">Resultado esperado</span>

- - Ao confirmar **Não**, o sistema deve manter as **demais parcelas inalteradas**.
    - A parcela editada deve manter o valor informado.
    - O sistema deve deixar claro ao usuário (na tela/total) que houve alteração que impacta o somatório.

---

#### **Cenário 05 — Alterar uma parcela e confirmar recálculo automático (Sim)**

> **Este cenário valida diretamente a correção do problema reportado (“o sistema soma e ultrapassa o total”).**

<span style="text-decoration: underline;">Pré-requisitos</span>

- SPD parcelado em 4x gerado.
- Total do SPD: **R$ 5.000,00**.

<span style="text-decoration: underline;">Passo a passo</span>

1. Editar a **Parcela 1** e alterar o valor (ex.: **R$ 1500,00**).
2. Clicar em **Gravar/Salvar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/O0Ct7lYLCkoeDqU2-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/O0Ct7lYLCkoeDqU2-image.png)
3. Na confirmação “deseja ajustar as demais parcelas?”, clicar em **Sim**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/TPQFZcL5aE64E9bn-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/TPQFZcL5aE64E9bn-image.png)
4. Verificar os valores recalculados das demais parcelas.
5. Conferir o total e/ou algum indicador do valor total do SPD (se o sistema exibe total do parcelamento/total SPD).
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/scaled-1680-/8cc7lkRowPGXcegb-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-01/8cc7lkRowPGXcegb-image.png)

<span style="text-decoration: underline;">Resultado esperado</span>

- - Ao confirmar **Sim**, o sistema deve **recalcular automaticamente** as demais parcelas para manter o **total fixo = R$ 5.000,00**.
    - Exemplo esperado para o caso informado:
        
        
        - Parcela 1: **R$ 1500,00**
        - Parcelas 2, 3 e 4: devem ser ajustadas para dividir o **restante (R$ 3.500)** → **R$ 1.166,66** cada (ou conforme regra de arredondamento do sistema).
    - O **valor final (somatório das parcelas)** deve ser **R$ 5.000,00.**

---

![4.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-03/scaled-1680-/eO9m8fVMKPpticCz-4.png)

<p class="callout danger">**ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.**</p>