Pular para o conteúdo 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": "pt"
  }'

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

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 a moeda, a taxa de imposto, o idioma e outros ajustes globais da sua loja. Você pode enviar um ou vários campos na mesma solicitação.
​
app_id
string
obrigatório
O ID da sua loja no Jelou Shop.
​
currency
string
Código da moeda no formato ISO 4217 (exatamente 3 caracteres). Exemplo: USD, EUR, COP, MXN.
​
tax_value
number
Taxa de imposto como valor decimal entre 0 e 1. Exemplo: 0.15 para 15%, 0.19 para 19%.
​
enable_per_product_tax
boolean
Habilita a configuração de taxa de imposto individual por produto. Quando está ativo, cada produto pode ter sua própria taxa no campo tax. Se o produto não tiver taxa configurada, tax_value é usado como fallback.
​
exclude_out_of_stock
boolean
padrão:"true"
Quando está ativo, os produtos sem estoque são excluídos por padrão dos resultados de busca. Se desativar, esses produtos continuarão aparecendo nas buscas.
​
language
string
padrão:"es"
Idioma padrão da loja. Afeta as mensagens localizadas devolvidas pela API (por exemplo, friendly_message nos endpoints de busca). 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": "pt"
  }'

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

​
Moeda

A moeda padrão de toda loja é USD. Se você não configurou uma moeda, os preços serão exibidos em dólares americanos.

​
Moedas comuns

CódigoMoeda
USDDólar americano
EUREuro
COPPeso colombiano
MXNPeso mexicano
PENSol peruano
CLPPeso chileno
BRLReal brasileiro
ARSPeso argentino

​
Imposto

Os preços armazenados no Jelou Shop incluem imposto. A taxa configurada é usada para extrair o imposto do preço bruto: 
preço_líquido = preço / (1 + tax_value)
imposto       = preço - preço_líquido
Exemplo: Um produto com preço $11.50 e taxa 0.15 (15%):
  • Preço líquido: $11.50 / 1.15 = $10.00
  • Imposto: $11.50 - $10.00 = $1.50

​
Taxas padrão por moeda

Se você não configurar tax_value, um valor padrão será atribuído com base na moeda da loja:
MoedaTaxa padrão
COP19% (0.19)
PEN18% (0.18)
MXN16% (0.16)
Outras15% (0.15)

​
IVA por produto

Quando enable_per_product_tax está ativo, você pode atribuir uma taxa de imposto individual a cada produto usando o campo tax no endpoint de produtos.
  • Se o produto tem tax > 0, essa taxa é usada.
  • Se o produto tem tax = 0 ou não foi configurado, tax_value da loja é usado como fallback.
  • Para produtos isentos de imposto, use has_tax: false.
A resposta do carrinho incluirá um detalhamento de impostos (tax_breakdown) agrupado por taxa quando esta opção está ativa.

​
Disponibilidade de produtos

exclude_out_of_stock controla se os produtos sem estoque aparecem nos resultados de busca da loja:
  • true (valor padrão): os produtos sem estoque são ocultados nos endpoints de busca.
  • false: os produtos sem estoque continuam aparecendo. Útil quando você quer que os clientes vejam todo o catálogo mesmo que não haja inventário disponível.
Esta configuração só afeta o comportamento padrão das buscas. Os produtos com stock_type = "unlimited" são sempre considerados disponíveis.

​
Idioma

language define o idioma padrão da loja e é usado para localizar as respostas da API.
ValorIdioma
esEspanhol (valor padrão)
enInglês
ptPortuguês
Atualmente afeta campos como friendly_message devolvidos pelos endpoints de busca (multi_search, v2_search). O valor enviado é normalizado para minúsculas.
Substitua {app_id} pelo ID da sua loja e <API_KEY> pelo token fornecido pela Jelou.