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,
    "enable_per_product_tax": true,
    "exclude_out_of_stock": true,
    "language": "en"
  }'

{
  "currency": "COP",
  "tax_value": 0.19,
  "exclude_out_of_stock": true,
  "enable_per_product_tax": true,
  "language": "en"
}

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

Lets you configure the currency, tax rate, language, and other global settings for your store. You can send one or more 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%.
​
enable_per_product_tax
boolean
Enables individual tax rate configuration per product. When active, each product can have its own rate in the tax field. If the product does not have a rate configured, tax_value is used as a fallback.
​
exclude_out_of_stock
boolean
default:"true"
When enabled, out-of-stock products are excluded from search results by default. If you disable it, those products will keep appearing in searches.
​
language
string
default:"es"
Default store language. Affects localized messages returned by the API (for example, friendly_message in the search endpoints). Allowed values: es, en, pt.
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,
    "enable_per_product_tax": true,
    "exclude_out_of_stock": true,
    "language": "en"
  }'

{
  "currency": "COP",
  "tax_value": 0.19,
  "exclude_out_of_stock": true,
  "enable_per_product_tax": true,
  "language": "en"
}

​
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)

​
Per-product tax

When enable_per_product_tax is active, you can assign an individual tax rate to each product using the tax field in the products endpoint.
  • If the product has tax > 0, that rate is used.
  • If the product has tax = 0 or it has not been configured, the store’s tax_value is used as a fallback.
  • For tax-exempt products, use has_tax: false.
The cart response will include a tax breakdown (tax_breakdown) grouped by rate when this option is active.

​
Product availability

exclude_out_of_stock controls whether out-of-stock products appear in your store’s search results:
  • true (default): out-of-stock products are hidden from search endpoints.
  • false: out-of-stock products keep appearing. Useful when you want shoppers to see the entire catalog even if there is no inventory available.
This setting only affects the default behavior of search endpoints. Products with stock_type = "unlimited" are always considered available.

​
Language

language sets the store’s default language and is used to localize API responses.
ValueLanguage
esSpanish (default)
enEnglish
ptPortuguese
It currently affects fields such as friendly_message returned by the search endpoints (multi_search, v2_search). The submitted value is normalized to lowercase.
Replace {app_id} with your store ID and <API_KEY> with the token provided by Jelou.