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
  }'

{
  "currency": "COP",
  "tax_value": 0.19,
  "enable_per_product_tax": true
}
Permite configurar a moeda e a taxa de imposto da sua loja. Você pode enviar um ou ambos os 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.
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
  }'

{
  "currency": "COP",
  "tax_value": 0.19,
  "enable_per_product_tax": true
}

​
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.
Substitua {app_id} pelo ID da sua loja e <API_KEY> pelo token fornecido pela Jelou.