Skip to main content
PATCH
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.
​
string
obrigatório
O ID da sua loja no Jelou Shop.
​
string
Código da moeda no formato ISO 4217 (exatamente 3 caracteres). Exemplo: USD, EUR, COP, MXN.
​
number
Taxa de imposto como valor decimal entre 0 e 1. Exemplo: 0.15 para 15%, 0.19 para 19%.
​
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.
​
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.
​
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.
​
string
Ordenação padrão da listagem e da busca de produtos. Formato: campo direção (ex.: price ASC, discount DESC). Campos permitidos: price, discount, discount_value, created_at, name, score, category_order. Direções: ASC ou DESC (padrão DESC). Se não for configurado, ordena por score DESC. Envie null ou string vazia para redefinir.
​
boolean
Ativa o motor de busca V2 para a loja.
​
object
Dicionário de sinônimos para a busca. Cada chave é um termo e seu valor é uma lista de sinônimos (cada um máx. 100 caracteres). Exemplo: { "celular": ["móvel", "smartphone"] }. Envie null para removê-lo.
​
string[]
Lista de palavras que a busca ignora (stop words). Cada uma máx. 100 caracteres. Envie null para removê-la.
​
string[]
Lista de marcas reconhecidas pela busca. Cada uma máx. 100 caracteres. Envie null para removê-la.
​
boolean
Controla se a loja exibe um conjunto inicial de categorias (por exemplo, ao abrir a busca sem um termo).

​
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

​
Imposto

Os preços armazenados no Jelou Shop incluem imposto. A taxa configurada é usada para extrair o imposto do preço bruto:
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:

​
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. 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 YOUR_API_KEY pela sua chave de API.