Entrar
.md

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.