# OS 74436 - MELHORIA - SIS/WEB - COMPRAS - SOLICITAÇÃO DE ADIANTAMENTO (RETENÇÃO INSS E ISS)

#### Objetivo

Solicitação tem por objetivo validar a implementação das funcionalidades relacionadas à retenção de INSS e ISS na tela de **Adiantamento de Fornecedor** do sistema:

- - Cálculo automático das retenções com base nas alíquotas parametrizadas no módulo Fiscal;
    - Atualização do campo "Valor Máximo para Adiantamento", considerando o total de retenções previstas;
    - Bloqueio de gravação caso o valor do adiantamento ultrapasse o permitido;
    - Aplicação automática das mesmas retenções para adiantamentos subsequentes;
    - Exibição adequada das retenções nas telas de consulta e aprovação.

<div id="bkmrk-">---

</div>#### Premissas

- Necessário que o ambiente esteja atualizado com as versões: 
    - Módulo **Compras**: 113043 Genexus 16 ou superior / 113105 Genexus 17 ou superior
    - Script: 113044 Sql / 113045 PostGree
- Só é aplicável para pedidos que possuam itens de serviço.
- Esse menu só é visível para clientes que possuam a **funcionalidade "ADIANTAMENTO\_FORNECEDOR"** ativa.

<div id="bkmrk--2">---

</div>#### Cenário 1: Geração de adiantamento com cálculo de INSS e ISS

**Pré-condição:** Pedido de compras com itens de serviço; alíquotas parametrizadas no cadastro fiscal: INSS 11%, ISS 5%.

**Passos:**

1. Acesse *Compras &gt; Adiantamento de Fornecedor &gt; Adiantamento*.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/qEgZrTgfdYmSdzZy-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/qEgZrTgfdYmSdzZy-image.png)
    
      
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/BVCtSNrvNs5GItqN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/BVCtSNrvNs5GItqN-image.png)
2. Selecione um pedido com itens de serviço.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/a6rPOeiwbc1NKI7L-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/a6rPOeiwbc1NKI7L-image.png)
3. Nesta tela alterou-se a mensagem para pedidos que possuam itens de serviço conforme abaixo. 
    - Mensagem antes da alteração: *Pedido contém itens de Serviço*
    - As regras desta tela permanecem como na versão atual do sistema.  
        [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/Visi8A5L69aRCNBW-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/Visi8A5L69aRCNBW-image.png)
4. Informe valor do adiantamento.
5. Clique em **Gerar**.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/lxiNfPfD5qEek3pN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/lxiNfPfD5qEek3pN-image.png)
6. Regras dos campos novos:  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/ODVXZv0HYrgN3jsl-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/ODVXZv0HYrgN3jsl-image.png)
    
    
    1. **Valor do adiantamento:** Valor informado na tela anterior. Este campo já existe na versão atual do sistema, porém sua edição foi habilitada.
    2. **Valor total do pedido (R$):** Corresponde à soma de todos os itens do pedido que estejam com o status de "em aberto" ou "pendente".
    3. **Total Adiantamentos (R$):** Corresponde à soma de todos os adiantamentos gerados para o pedido (exceto cancelados e transferidos).
    4. **Valor Total Retenções Previstas - Pedido (R$):** Corresponde à soma de todas as retenções previstas com base no valor total do pedido.
    5. **Valor Máximo para Adiantamento (R$):** Corresponde ao valor resultante da seguinte fórmula:
    6. **Retenções Previstas (R$):** Corresponde ao Valor do Adiantamento \* o percentual de cada imposto.
    7. **Total Retenções (%):** Corresponde à soma dos percentuais de retenção de todos os impostos.
7. Marque "Sim" para retenção dos impostos desejados.
    
    
    - Ao informar que determinado imposto será retido, o sistema retornará como sugestão as alíquotas definidas na parametrização do parceiro, no módulo fiscal, para esse imposto, conforme o serviço federal 116.  
        Caminho:
        
        [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/fK015CyuCitjbLel-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/fK015CyuCitjbLel-image.png)
8. Confira os percentuais carregados automaticamente. Exemplo INSS e ISS.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/dZjALmcyzV7lxPoB-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/dZjALmcyzV7lxPoB-image.png)
9. Clique em **Confirmar**.

**Resultado esperado:**

- INSS = Adiantamento × 11%
- ISS = Adiantamento × 5%
- Valor máximo para adiantamento = Valor do pedido – Retenções – Adiantamentos anteriores.
- Gravação ocorre com sucesso.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/xh0qaQanxw9mxQji-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/xh0qaQanxw9mxQji-image.png)

---

#### Cenário 2: Bloqueio por ultrapassar valor do pedido

**Passos:**

1. Selecione um pedido com valor adiantado próximo ao valor total.
2. Tente gerar um novo adiantamento acima do saldo disponível.

**Resultado esperado:**

- Mensagem de erro:  
    **“Valor do Adiantamento não pode ser maior que o Valor do Pedido menos o Valor já adiantado!”**
- Adiantamento é bloqueado.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/S0epn13TGpzkcxlY-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/S0epn13TGpzkcxlY-image.png)

---

#### Cenário 3: Bloqueio por ultrapassar valor máximo considerando retenções

**Passos:**

1. Gere um novo adiantamento com valor maior do que o “Valor Máximo para Adiantamento”.
2. Clique em **Confirmar**.

**Resultado esperado:**

- Mensagem de erro:  
    **“Valor do adiantamento ultrapassa o Valor Máximo para Adiantamento.”**
- Gravação é impedida.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/74mCTAtwqeW3fi5u-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/74mCTAtwqeW3fi5u-image.png)

---

#### Cenário 4: Geração de adiantamento subsequente com retenções herdadas

**Passos:**

1. Gere um primeiro adiantamento com retenções ativas.
2. Gere novo adiantamento para o mesmo pedido.
3. Verifique os campos de retenção.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/4QaU3MyWJadBFjCr-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/4QaU3MyWJadBFjCr-image.png)

**Resultado esperado:**

- Retenções mantêm os mesmos valores e marcações do primeiro adiantamento.
- Campos estão bloqueados para edição.

---

#### Cenário 5: Retenção marcada como “Sim” com percentual zerado

**Passos:**

1. Gere adiantamento marcando "Sim" para INSS ou ISS.
2. Informe percentual igual a zero.
3. Clique em **Confirmar**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/zp0EfTDNifJWRQvW-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/zp0EfTDNifJWRQvW-image.png)

**Resultado esperado:**

- Mensagem de erro impede a gravação:  
    **“Para retenções marcadas como SIM, os percentuais não podem ser 0.”**

---

#### Cenário 6: Visualização no módulo de aprovação

**Passos:**

1. Acesse *Compras &gt; Adiantamento de Fornecedor &gt; Aprovação/Cancelamento*.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/0Mzc6Lb98I3VQDVU-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/0Mzc6Lb98I3VQDVU-image.png)
2. Consulte o pedido testado.
3. Visualize os detalhes de cada adiantamento.
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/wna6aFwYXntkylqM-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/wna6aFwYXntkylqM-image.png)
    
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/scaled-1680-/vVUWUSMoZGZsJPRK-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-06/vVUWUSMoZGZsJPRK-image.png)

**Resultado esperado:**

- Detalhamento mostra percentuais, valores de retenção e campos preenchidos conforme cadastro.


<div id="bkmrk--7">---

</div>![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>