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

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

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.

Permite configurar la moneda, la tasa de impuesto, el idioma y otros ajustes globales de tu tienda. Puedes enviar uno o varios 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%.
​
enable_per_product_tax
boolean
Habilita la configuración de tasa de impuesto individual por producto. Cuando está activo, cada producto puede tener su propia tasa en el campo tax. Si el producto no tiene tasa configurada, se usa tax_value como fallback.
​
exclude_out_of_stock
boolean
predeterminado:"true"
Cuando está activo, los productos sin stock se excluyen por defecto de los resultados de búsqueda. Si lo desactivas, esos productos seguirán apareciendo en las búsquedas.
​
language
string
predeterminado:"es"
Idioma predeterminado de la tienda. Afecta los mensajes localizados que devuelve la API (por ejemplo, friendly_message en los endpoints de búsqueda). Valores permitidos: 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": "es"
  }'

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

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

​
IVA por producto

Cuando enable_per_product_tax está activo, puedes asignar una tasa de impuesto individual a cada producto usando el campo tax en el endpoint de productos.
  • Si el producto tiene tax > 0, se usa esa tasa.
  • Si el producto tiene tax = 0 o no se ha configurado, se usa tax_value de la tienda como fallback.
  • Para productos exentos de impuesto, usa has_tax: false.
La respuesta del carrito incluirá un desglose de impuestos (tax_breakdown) agrupado por tasa cuando esta opción está activa.

​
Disponibilidad de productos

exclude_out_of_stock controla si los productos sin stock aparecen en los resultados de búsqueda de la tienda:
  • true (valor por defecto): los productos sin stock no se muestran en los endpoints de búsqueda.
  • false: los productos sin stock siguen apareciendo. Útil cuando quieres que los clientes vean todo el catálogo aunque no haya inventario disponible.
Esta configuración solo afecta el comportamiento por defecto de las búsquedas. Los productos con stock_type = "unlimited" se consideran siempre disponibles.

​
Idioma

language define el idioma predeterminado de la tienda y se utiliza para localizar las respuestas de la API.
ValorIdioma
esEspañol (valor por defecto)
enInglés
ptPortugués
Actualmente afecta a campos como friendly_message devueltos por los endpoints de búsqueda (multi_search, v2_search). El valor enviado se normaliza a minúsculas.
Reemplaza {app_id} con el ID de tu tienda y <API_KEY> con el token proporcionado por Jelou.