Skip to main content
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
}
Allows you to configure the currency and tax rate for your store. You can send one or both fields in the same request.
​
app_id
string
required
Your store ID in Jelou Shop.
​
currency
string
Currency code in ISO 4217 format (exactly 3 characters). Example: USD, EUR, COP, MXN.
​
tax_value
number
Tax rate as a decimal value between 0 and 1. Example: 0.15 for 15%, 0.19 for 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
}

​
Currency

The default currency for every store is USD. If you haven’t configured a currency, prices will be displayed in US dollars.

​
Common currencies

CodeCurrency
USDUS Dollar
EUREuro
COPColombian Peso
MXNMexican Peso
PENPeruvian Sol
CLPChilean Peso
BRLBrazilian Real
ARSArgentine Peso

​
Tax

Prices stored in Jelou Shop include tax. The configured rate is used to extract tax from the gross price: 
net_price = price / (1 + tax_value)
tax       = price - net_price
Example: A product priced at $11.50 with rate 0.15 (15%):
  • Net price: $11.50 / 1.15 = $10.00
  • Tax: $11.50 - $10.00 = $1.50

​
Default rates by currency

If you don’t configure tax_value, a default value is assigned based on the store’s currency:
CurrencyDefault rate
COP19% (0.19)
PEN18% (0.18)
MXN16% (0.16)
Others15% (0.15)
Replace {app_id} with your store ID and <API_KEY> with the token provided by Jelou.