---
title: 'Valores monetários'
description: 'Todos os valores monetários são enviados como inteiros na menor unidade da moeda (centavos).'
---

# 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` |

```json
{
  "itemPrice": 5220,
  "tax":        375,
  "total":     5595
}
```

## Convertendo para exibição

Para mostrar os valores ao usuário, divida o inteiro por 100:

```js
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.
