Saltar al contenido principal
PATCH
/
api
/
v1
/
apps
/
{app_id}
/
settings
curl -X PATCH "https://ecommerce.jelou.ai/api/v1/apps/{app_id}/settings" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "COP",
    "tax_value": 0.19
  }'
{
  "currency": "COP",
  "tax_value": 0.19
}
Permite configurar la moneda y la tasa de impuesto de tu tienda. Puedes enviar uno o ambos campos en la misma solicitud.
app_id
string
requerido
ID de tu tienda en Jelou Shop.
currency
string
Código de moneda en formato ISO 4217 (exactamente 3 caracteres). Ejemplo: USD, EUR, COP, MXN.
tax_value
number
Tasa de impuesto como valor decimal entre 0 y 1. Ejemplo: 0.15 para 15%, 0.19 para 19%.
curl -X PATCH "https://ecommerce.jelou.ai/api/v1/apps/{app_id}/settings" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "COP",
    "tax_value": 0.19
  }'
{
  "currency": "COP",
  "tax_value": 0.19
}

Moneda

La moneda predeterminada de toda tienda es USD. Si no has configurado una moneda, los precios se mostrarán en dólares americanos.

Monedas comunes

CódigoMoneda
USDDólar estadounidense
EUREuro
COPPeso colombiano
MXNPeso mexicano
PENSol peruano
CLPPeso chileno
BRLReal brasileño
ARSPeso argentino

Impuesto

Los precios almacenados en Jelou Shop incluyen impuesto. La tasa configurada se utiliza para extraer el impuesto del precio bruto:
precio_neto = precio / (1 + tax_value)
impuesto    = precio - precio_neto
Ejemplo: Un producto con precio $11.50 y tasa 0.15 (15%):
  • Precio neto: $11.50 / 1.15 = $10.00
  • Impuesto: $11.50 - $10.00 = $1.50

Tasas predeterminadas por moneda

Si no configuras tax_value, se asigna un valor predeterminado según la moneda de la tienda:
MonedaTasa predeterminada
COP19% (0.19)
PEN18% (0.18)
MXN16% (0.16)
Otras15% (0.15)
Reemplaza {app_id} con el ID de tu tienda y <API_KEY> con el token proporcionado por Jelou.