Entrar
.md

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.