# Regras de cálculo de descontos e acréscimos

## 📘 **Como funcionam os descontos e acréscimos no Uplaces**

O Uplaces calcula descontos e acréscimos automaticamente durante o pedido, sempre seguindo uma ordem que garante transparência e coerência nos valores apresentados ao cliente.

Essa página explica **como o sistema calcula o valor final** do pedido e **por que alguns descontos deixam de valer quando outros são aplicados**.

## 🧩 1. Tipos de descontos aplicados pelo sistema

O Uplaces trabalha com vários tipos de descontos/acréscimos:

#### **Descontos automáticos**

* Promoções de produtos
* Descontos por categoria, quantidade ou cliente
* Políticas comerciais

#### **Descontos informados pelo comprador**

* Cupom de desconto
* Resgate de pontos (cashback)

#### **Descontos informados pelo vendedor**

* Desconto ou acréscimo manual no pedido

#### **Descontos da forma de pagamento**

* Desconto PIX
* Desconto à vista
* Acréscimo para parcelamento / cartão
* Taxas de pagamento integradas (Yapay, Asaas etc.)

***

## 🧠 2. Ordem em que os descontos são aplicados

Os descontos não são aplicados todos de uma vez.\
O sistema segue uma **ordem definida**, garantindo que cada tipo seja calculado na base correta.

A ordem é:

***

### **A) Descontos nos itens**

Aplicados diretamente no preço dos produtos:

1. Preço cheio
2. Promoções
3. Regras automáticas (quantidade, categoria, cliente, políticas)

O resultado é o **subtotal dos itens**.

***

### **B) Descontos no carrinho**

Aplicados sobre o subtotal:

1. **Cupom de desconto**
2. **Cashback (pontos resgatados)**
3. **Descontos ou acréscimos do vendedor**
4. Taxas adicionais (quando existirem)
5. Frete
6. Impostos

***

### **C) Forma de pagamento (sempre por último)**

Depois que tudo acima foi calculado:

* Desconto PIX
* Desconto à vista
* Taxas de cartão ou gateways
* Acréscimos por parcelamento

📌 **Esses descontos sempre são os últimos**, pois dependem do valor total final.

***

## ⚠️ 3. Quando um desconto invalida outro?

Para garantir precisão:

👉 **Se o cliente inserir um cupom, resgatar pontos ou receber desconto do vendedor, o desconto da forma de pagamento é removido.**\
Isso acontece porque:

* o desconto do PIX
* ou o desconto à vista
* **deve ser sempre recalculado por último**

Após isso, o cliente pode escolher novamente a forma de pagamento.

Exemplo:\
Se o cliente colocar PIX → depois inserir cupom → o desconto PIX é removido e será recalculado quando PIX for selecionado novamente.

***

## 🧮 4. Exemplo prático

Imagine um pedido assim:

* Subtotal dos produtos: **R$ 1.437,35**
* Promoção automática: – **R$ 151,49**
* Cupom de 10%: – **R$ 128,59**
* Desconto PIX 5%: – **R$ 57,86**
* Frete: + **R$ 90,90**

**Total final:**\
👉 **R$ 1.190,31**

Todos os valores sempre ficam detalhados no modal de “Descontos / acréscimos aplicados”.

***

## 👀 5. Transparência total

O Uplaces mostra todos os descontos aplicados, com ordem e valores, por exemplo:

```
(1) Promoção: R$ 151,49
(2) Cupom: R$ 128,59
(3) PIX: R$ 57,86
```

Dessa forma, tanto o cliente quanto o vendedor sabem exatamente como o valor final foi calculado.

***

## 📌 6. Resumo rápido

| Etapa            | O que acontece                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------- |
| **1. Itens**     | Promoções e regras aplicadas no preço dos produtos                                          |
| **2. Carrinho**  | Cupom → Cashback → Vendedor → Taxas → Frete → Impostos                                      |
| **3. Pagamento** | Desconto PIX/à vista ou taxas de cartão                                                     |
| **Regras**       | Cupom/cashback/vendedor removem o desconto de pagamento, que deve ser selecionado novamente |
