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

{
  "currency": "COP",
  "tax_value": 0.19
}
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%.
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
}

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