# OS 103974 - MELHORIA - GERENCIAL - MELHORIA NO MODULO GERENCIAL - JOAO PAULO

#### **Objetivo:**

A solicitação tem como objetivo ampliar as informações disponibilizadas no **módulo Gerencial &gt; Gerencial de Pedidos**, proporcionando ao usuário uma análise mais completa das vendas de mercadorias, dos custos envolvidos e das condições e formas de pagamento utilizadas nos pedidos.

A melhoria contempla a inclusão de novos indicadores na visão já existente e a criação de uma nova visão específica para análise dos pagamentos.

Na visão **PADRÃO**, foram acrescentados os seguintes indicadores:

- **Valor de custo:** apresenta o custo total relacionado aos pedidos encontrados conforme os filtros informados;
- **Markup médio:** apresenta a relação entre o valor total das vendas e o custo total dos pedidos considerados na consulta.

Também foi criada a nova visão **PAGAMENTOS**, permitindo acompanhar de forma consolidada:

- o desconto médio aplicado por combinação de **condição e forma de pagamento**;
- o valor bruto das vendas;
- o valor total concedido como desconto;
- o valor líquido das vendas;
- as retenções cadastradas para cada combinação de condição e forma de pagamento;
- a quantidade de pedidos realizada por condição de pagamento.

Com a implementação, o usuário passa a dispor de informações gerenciais que auxiliam na análise dos custos das vendas, do Markup praticado, dos descontos concedidos e da utilização das condições de pagamento.

> **Atenção:** o período informado nos filtros do **Gerencial de Pedidos** não interfere na retenção apresentada neste quadro.  
> Independentemente da data inicial e da data final selecionadas para análise dos pedidos, o sistema sempre apresentará a **retenção vigente atualmente** para a respectiva combinação de condição e forma de pagamento.

Essa regra permite que o usuário visualize, dentro do Gerencial, qual percentual de retenção está atualmente configurado para cada forma de recebimento, mesmo quando estiver analisando vendas realizadas em períodos anteriores.

Atualmente, o cadastro de retenção é utilizado principalmente nos processos relacionados a **metas e comissões**. A informação foi disponibilizada no Gerencial também como apoio à consulta e para possibilitar sua utilização em outros processos futuramente.

#### **Premissas:**

- Necessário o ambiente estar atualizado com a versão: 
    - **Gerencial** de número **146317** ou superior.

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

#### **Cenário 01: Validar os indicadores de Valor de custo e Markup médio**

**Objetivo:**  
Validar a apresentação dos novos indicadores **Valor de custo** e **Markup médio** na visão PADRÃO do Gerencial de Pedidos.

**Pré-condição:**  
Existirem pedidos de venda no período utilizado para o teste e o usuário possuir acesso ao módulo Gerencial.

**Passo a passo:**

1. Acessar **Gerencial &gt; Gerencial - Pedidos**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/LPSQBai9l7sA6Fet-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/LPSQBai9l7sA6Fet-image.png)
2. Selecionar a visão.
3. Informar a loja.
4. Informar o período, exemplo: de **01/01/2026 a 05/01/2026**.
5. Manter a situação do pedido como **<span class="text-token-text-primary cursor-text rounded-sm" data-placeholder-token="true">\[TODOS\]</span>**.
6. Clicar em **Atualizar**.
7. Verificar o indicador **Valor de custo**.
8. Verificar o indicador **Markup médio**.
9. Confirmar os pedidos considerados na consulta.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/IsrG4ISxCElVu1dG-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/IsrG4ISxCElVu1dG-image.png)
10. Validar os custos correspondentes: 
    - R$ 10.832,12;
    - R$ 4.676,04;
11. Confirmar o custo total:

**R$ 10.832,12 + R$ 4.676,04 = R$ 15.508,16.**

12. Confirmar os valores das vendas:

**R$ 32.350,00 + R$ 15.000,00 = R$ 47.350,00.**

13. **Markup médio** apresentado em tela**: TOTAL DE VENDA / TOTAL DO CUSTO.** Validar o cálculo:

**R$ 47.350,00 ÷ R$ 15.508,16 = 3,053...**

14. Confirmar o arredondamento para **3,05**.

<p class="callout info">**Resultado Esperado:**</p>

O sistema deve apresentar:

- **Valor de custo: R$ 15.508,16**;
- **Markup médio: 3,05**.

Os valores devem corresponder aos pedidos encontrados conforme os filtros informados.

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

</div>#### **Cenário 02: Validar a origem do custo de um pedido**

**Objetivo:**  
Confirmar que o valor utilizado na composição do custo do Gerencial corresponde aos custos relacionados ao pedido de venda.

**Pré-condição:**  
O pedido utilizado no teste deve estar disponível para consulta.

**Passo a passo:**

1. Acessar **Frente de Loja &gt; Pedido &gt; Pedido de Venda**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/OGheSo7hmybL4OzN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/OGheSo7hmybL4OzN-image.png)
2. Selecionar a loja **IBIRAPUERA**.
3. Informar o período de **01/01/2026 a 05/01/2026**.
4. Selecionar o tipo de pedido **Venda de Mercadorias (PV)**.
5. Realizar a consulta.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/2ZfsCZpoxlu5YgZ7-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/2ZfsCZpoxlu5YgZ7-image.png)
6. Localizar o pedido **3005557**.
7. Confirmar o valor do pedido de **R$ 15.000,00**.
8. Acessar os detalhes do pedido.
9. Consultar os itens vinculados.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/t0YQ7DohtEldEzjU-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/t0YQ7DohtEldEzjU-image.png)
10. Identificar a aquisição relacionada aos produtos quando a venda não possuir estoque disponível.
11. Conferir os valores relacionados ao custo das mercadorias.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/kp4fV8rM993YgOhY-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/kp4fV8rM993YgOhY-image.png)
12. Confirmar o custo total de **R$ 4.820,66**.
13. Comparar esse valor com o custo considerado no Gerencial.

<p class="callout info">**Resultado Esperado:**</p>

O custo utilizado pelo Gerencial deve possuir correspondência com os valores relacionados ao pedido.

Para o pedido **3005557**, deve ser confirmado:

- Valor da venda: **R$ 15.000,00**;
- Custo considerado: **R$ 4.820,66**.

<div contenteditable="false" id="bkmrk--1">---

</div>#### **Cenário 03: Validar a nova visão PAGAMENTOS**

**Objetivo:**  
Validar a disponibilização e o carregamento da nova visão **PAGAMENTOS**.

**Pré-condição:**  
Existirem vendas com informações de pagamento no período selecionado.

**Passo a passo:**

1. Acessar **Gerencial &gt; Gerencial de Pedidos**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/y5pbB5Vfb6Ctma2I-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/y5pbB5Vfb6Ctma2I-image.png)
2. Selecionar a visão **PAGAMENTOS**.
3. Informar a loja desejada.
4. Informar o período para análise.
5. Manter ou selecionar a situação desejada.
6. Clicar em **Atualizar**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/iobqgitLRO5F28DK-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/iobqgitLRO5F28DK-image.png)
7. Verificar a apresentação do ranking de descontos.
8. Verificar o painel de retenção por pagamento.
9. Verificar o gráfico de quantidade de pedidos.

<p class="callout info">**Resultado Esperado:**</p>

O sistema deve disponibilizar a visão **PAGAMENTOS** e apresentar corretamente os painéis e o gráfico correspondentes aos pedidos encontrados.

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

</div>#### **Cenário 04: Validar o ranking de desconto por condição e forma de pagamento**

**Objetivo:**  
Validar se o ranking apresenta corretamente o desconto médio por combinação de condição e forma de pagamento.

**Pré-condição:**  
Existirem pedidos com condições e formas de pagamento no período selecionado.

**Passo a passo:**

1. Acessar a visão **PAGAMENTOS**.
2. Informar a loja **IBIRAPUERA**.
3. Informar o período de **01/01/2026 a 05/01/2026**.
4. Clicar em **Atualizar**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/uiZoGKvgpS7DhxsU-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/uiZoGKvgpS7DhxsU-image.png)
5. Localizar o painel **Ranking de desconto aplicado por pagamento – Condição(Forma)**.
6. Confirmar a combinação **10X BOLETO (BOLETO)**.
7. Validar: 
    - Média de desconto: **37,77%**;
    - Valor bruto: **R$ 24.104,00**;
    - Desconto: **R$ 9.104,00**;
    - Valor líquido: **R$ 15.000,00**.
8. Confirmar a combinação **5X BOLETO (BOLETO)**.
9. Validar: 
    - Média de desconto: **24,71%**;
    - Valor bruto: **R$ 42.970,00**;
    - Desconto: **R$ 10.620,00**;
    - Valor líquido: **R$ 32.350,00**.
10. Acessar o pedido **3005557**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/OGheSo7hmybL4OzN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/OGheSo7hmybL4OzN-image.png)
11. Consultar a aba **Follow-up Pagamentos**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/6UkSIvLbzZnFL6KX-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/6UkSIvLbzZnFL6KX-image.png)
    
      
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/WGyYFgGMFyF3yJVW-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/WGyYFgGMFyF3yJVW-image.png)
12. Confirmar: 
    - Condição de pagamento: **10X BOLETO**;
    - Forma de pagamento: **BOLETO**.
13. Consultar as informações de desconto do pedido.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/y8lwqQhztr2WFsFC-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/y8lwqQhztr2WFsFC-image.png)
14. Confirmar o desconto médio aplicado de **37,77%**.

<p class="callout info">**Resultado Esperado:**</p>

O ranking deve considerar conjuntamente a **condição e a forma de pagamento**, apresentando os valores correspondentes aos pedidos encontrados.

Para o pedido exemplificado, a combinação **10X BOLETO (BOLETO)** deve apresentar média de desconto de **37,77%**.

<div contenteditable="false" id="bkmrk--3">---

</div>#### **Cenário 05: Validar o cadastro e a consulta da retenção por pagamento**

**Objetivo:**  
Validar o cadastro de retenção por condição e forma de pagamento e sua posterior apresentação no Gerencial.

**Pré-condição:**  
O usuário deve possuir acesso ao cadastro de retenções.

**Passo a passo:**

1. Acessar **Frente de Loja &gt; Metas e Comissões &gt; Cadastro de Retenções &gt; Pagamento**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7JeDmQBtmVSWvVWK-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7JeDmQBtmVSWvVWK-image.png)
2. Clicar em **Inserir**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Y6Ct7h3VJaToHQ45-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Y6Ct7h3VJaToHQ45-image.png)
3. Informar uma descrição para a retenção.
4. Selecionar a condição de pagamento **10X BOLETO**.
5. Selecionar a forma de pagamento **BOLETO**.
6. Informar o percentual de retenção de **3,00%**.
7. Confirmar o cadastro.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/TgXPnuKc13hEPUTm-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/TgXPnuKc13hEPUTm-image.png)
8. Consultar a listagem de retenções.
9. Confirmar a inclusão do registro.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/vR7eseCMMt4FeTv4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/vR7eseCMMt4FeTv4-image.png)
10. Realizar um novo cadastro para a mesma condição e forma de pagamento.
11. Informar uma nova descrição.
12. Informar o percentual de retenção de **2,50%**.
13. Confirmar o novo cadastro.
14. Verificar que os dois registros permanecem disponíveis para consulta.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/9XreQ1t0tdHbJOVc-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/9XreQ1t0tdHbJOVc-image.png)
15. Acessar **Gerencial &gt; Gerencial de Pedidos**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Uak0EuErj63y49eo-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Uak0EuErj63y49eo-image.png)
16. Selecionar a visão **PAGAMENTOS**.
17. Atualizar a consulta.
18. No painel **Retenção por pagamento**, filtrar a condição **10X BOLETO**.
19. Localizar a forma **BOLETO**.
20. Conferir o percentual apresentado.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/CgISXZoU0WjwtLP5-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/CgISXZoU0WjwtLP5-image.png)

<p class="callout info">**Resultado Esperado:**</p>

O sistema deve considerar como vigente o cadastro mais recente da combinação de condição e forma de pagamento.

Para **10X BOLETO + BOLETO ABN - SANTANDER**, deve ser apresentada a retenção de **2,50%**.

A retenção apresentada deve permanecer a mesma, mesmo quando o usuário alterar o período de consulta dos pedidos, pois o quadro **Retenção por pagamento não é filtrado pelo período informado no Gerencial**.

O período selecionado na tela deve ser utilizado para a análise dos pedidos, rankings, indicadores e gráficos relacionados às vendas, enquanto o quadro de retenção deve sempre apresentar a **configuração vigente no momento da consulta**.

<div contenteditable="false" id="bkmrk--4">---

</div>#### **Cenário 06: Validar o gráfico de quantidade de pedidos por condição de pagamento**

**Objetivo:**  
Validar se o gráfico apresenta corretamente a quantidade de pedidos agrupada somente pela condição de pagamento.

**Pré-condição:**  
Existirem pedidos com diferentes condições e formas de pagamento.

**Passo a passo:**

1. Acessar a visão **PAGAMENTOS**.
2. Informar o período de **01/01/2026 a 05/01/2026**.
3. Informar a loja **IBIRAPUERA**.
4. Clicar em **Atualizar**.
5. Localizar o gráfico **Condição de pagamento X Quantidade de pedidos**.
6. Conferir a condição **10X BOLETO**.
7. Conferir a condição **5X BOLETO**.
8. Comparar a quantidade apresentada com os pedidos encontrados no período.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/yMsMwduJUq78Wnkd-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/yMsMwduJUq78Wnkd-image.png)

<p class="callout info">**Resultado Esperado:**</p>

O gráfico deve agrupar os pedidos exclusivamente pela **condição de pagamento**.

Para o período utilizado no exemplo, deve apresentar:

- **10X BOLETO: 1 pedido**;
- **5X BOLETO: 1 pedido**.

<div contenteditable="false" id="bkmrk--6">---

</div>#### **Cenário 07: Validar o cálculo da média de desconto em um período mensal**

**Objetivo:**  
Validar o cálculo da média de desconto quando existem diversos pedidos utilizando a mesma combinação de condição e forma de pagamento.

**Pré-condição:**  
Existirem diversos pedidos no período com a mesma condição e forma de pagamento.

**Passo a passo:**

1. Acessar **Gerencial &gt; Gerencial de Pedidos**.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Uak0EuErj63y49eo-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Uak0EuErj63y49eo-image.png)
2. Selecionar a visão **PAGAMENTOS**.
3. Informar a loja **IBIRAPUERA**.
4. Informar o período de **01/01/2026 a 31/01/2026**.
5. Clicar em **Atualizar**.
6. Localizar no ranking a combinação **10X BOLETO (BOLETO)**.
7. Conferir os pedidos pertencentes exatamente a essa combinação.
8. Validar os percentuais de desconto utilizados nesses pedidos:
9. Somar os percentuais:

**276,12%.**

10. Dividir o valor pela quantidade de pedidos da combinação:

**276,12 ÷ 7 = 39,445...%.**

11. Conferir o valor apresentado no ranking.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/f6smyG5iWRrRV7gI-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/f6smyG5iWRrRV7gI-image.png)

<p class="callout info">**Resultado Esperado:**</p>

O ranking deve calcular a média somente entre pedidos pertencentes à mesma combinação de **condição + forma de pagamento**.

Para **10X BOLETO (BOLETO)**, o sistema deve considerar **7 pedidos** e apresentar a média arredondada de:

**39,45%.**

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

</div>#### **Cenário 08: Validar a consulta utilizando um mês completo**

**Objetivo:**  
Validar o funcionamento da visão PAGAMENTOS utilizando um período maior de consulta.

**Pré-condição:**  
Existirem pedidos durante o mês selecionado.

**Passo a passo:**

1. Acessar **Gerencial &gt; Gerencial de Pedidos**.
2. Selecionar a visão **PAGAMENTOS**.
3. Informar a loja **IBIRAPUERA**.
4. Informar o período de **01/01/2026 a 31/01/2026**.
5. Clicar em **Atualizar**.
6. Verificar o carregamento do ranking.
7. Conferir as diferentes condições e formas de pagamento apresentadas.
8. Verificar o painel de retenções.
9. Verificar o gráfico de quantidade de pedidos.
10. Confirmar a apresentação das diferentes condições utilizadas no período.  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/DhUcy6bZq84aH3d6-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/DhUcy6bZq84aH3d6-image.png)

<p class="callout info">**Resultado Esperado:**</p>

O sistema deve concluir normalmente a consulta de um mês completo e apresentar:

- ranking das combinações de condição e forma de pagamento;
- médias de desconto correspondentes aos pedidos encontrados;
- valores bruto, desconto e líquido;
- quantidade de pedidos por condição de pagamento.

<p class="callout warning">**Observação:**</p>

A consulta mensal deve respeitar o período informado para os dados de vendas e pagamentos. O quadro **Retenção por pagamento**, entretanto, deve continuar apresentando a retenção vigente atualmente, independentemente do período selecionado.

####   


####  [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/scaled-1680-/0RWMPc69Kz8CuBd2-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/0RWMPc69Kz8CuBd2-image.png)

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