Valores monetarios
Al enviar pedidos a una API de Guper, todos los valores monetarios — precios de items, impuestos, descuentos, totales, envío — deben expresarse como enteros en la unidad mínima de la moneda (centavos para BRL, USD, MXN y similares). Los puntos decimales nunca se envían por la red.
Formato
| Valor mostrado | Enviado como |
|---|---|
| $52.20 | 5220 |
| $3.75 | 375 |
| $1,000.00 | 100000 |
{
"itemPrice": 5220,
"tax": 375,
"total": 5595
}
Convirtiendo para mostrar
Para renderizar los valores al usuario, divide el entero entre 100:
const cents = 5220;
const display = (cents / 100).toFixed(2); // "52.20"
¿Por qué enteros?
La aritmética de punto flotante introduce errores de redondeo que se acumulan en totales y descuentos. Enviar los valores como enteros elimina esos errores por completo y mantiene a todos los sistemas de la cadena de acuerdo con el mismo número.