Valores monetários
Ao enviar pedidos para uma API Guper, todos os valores monetários — preços de item, impostos, descontos, totais, frete — devem ser expressos como inteiros na menor unidade da moeda (centavos para BRL, USD e similares). Casas decimais nunca trafegam.
Formato
| Valor exibido | Enviado como |
|---|---|
| R$ 52,20 | 5220 |
| R$ 3,75 | 375 |
| R$ 1.000,00 | 100000 |
{
"itemPrice": 5220,
"tax": 375,
"total": 5595
}
Convertendo para exibição
Para mostrar os valores ao usuário, divida o inteiro por 100:
const cents = 5220;
const display = (cents / 100).toFixed(2); // "52.20"
Por que inteiros?
Aritmética de ponto flutuante introduz erros de arredondamento que se acumulam em totais e descontos. Enviar como inteiros elimina esses erros e mantém todos os sistemas da cadeia concordando no mesmo número.