Receitas de descontos
Envie em discounts[] o grupo, o tipo e os argumentos indicados. Valores em R$ usam ponto decimal ("15.90").
Percentuais entre 0 (exclusivo) e 100Nos descontos percentuais (tipo
2dos grupos1a4), o argumento1precisa ser um número maior que0e no máximo100("10"= 10%). Fora disso, ou se não for um número, a resposta é400(DISCOUNT_PERCENTAGE_OUT_OF_RANGE). Descontos em R$ não têm limite superior.
Um alvo por descontoNo grupo
1, o desconto é identificado pelo alvo enviado (produtos, variantes, categorias, recorrências ou marcas). Envie apenas um alvo por desconto; para atingir alvos diferentes, crie descontos separados. Combinações fora destas tabelas (ex.: R$ por unidade em categorias) são descartadas sem erro.Um argumento enviado com
"values": []é descartado, mas a presença dele ainda conta para escolher o tipo de desconto ou condição (ex.:5na condição de produtos,15no desconto em marcas). Só envie argumentos vazios quando a receita pedir.
1 · Desconto em produtos
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| % em categorias | 1 / 2 | 1 percentual; 3 IDs de categoria; 13 "true"/"false" ignorar produtos remarcados (obrigatório). |
| % em produtos | 1 / 2 | 1 percentual; 4 IDs de produto. |
| % em X unidades de produtos | 1 / 2 | 1 percentual; 4 IDs de produto; 5 quantidade de unidades com desconto. |
| % em variantes | 1 / 2 | 1 percentual; 6 IDs de variante. |
| % no item de menor ou maior valor | 1 / 2 | 1 percentual; 5 quantidade; 6 IDs de variante elegíveis (envie "values": [] para todas); 998 aplicação (tabela abaixo); 12 (obrigatório) "true" distribui o desconto entre vários SKUs, "false" aplica em um único SKU. |
| % por recorrência de assinatura | 1 / 2 | 1 percentual; 8 IDs de recorrência. |
| % em marcas | 1 / 2 | 1 percentual; 14 IDs de marca; 15 "false" = só essas marcas, "true" = todas exceto essas (obrigatório; sem ele o desconto é descartado); 13 ignorar remarcados (obrigatório). |
| R$ por unidade de produtos | 1 / 1 | 1 valor; 4 IDs de produto. |
| R$ por unidade de variantes | 1 / 1 | 1 valor; 6 IDs de variante. |
| R$ no subtotal de marcas | 1 / 1 | 1 valor (rateado entre os itens); 14 IDs de marca; 15 modo da lista (obrigatório); 13 ignorar remarcados (obrigatório). |
998 | Aplicar no item… |
|---|---|
"1" | de menor valor, considerando o preço unitário |
"2" | de maior valor, considerando o preço unitário |
"3" | de menor valor, considerando a soma das unidades do produto |
"4" | de maior valor, considerando a soma das unidades do produto |
2 · Desconto no frete
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| R$ no frete | 2 / 1 | 1 valor ou percentual; 2 (opcional) IDs de contratos de frete; 19 (opcional) IDs de grupos de frete. Sem contrato nem grupo, vale para a cotação mais barata. |
| % no frete | 2 / 2 |
Frete grátisUse o grupo
2, tipo2, com1="100".
3 · Desconto no valor total (com frete)
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| R$ no total | 3 / 1 | 1 valor. |
| % no total | 3 / 2 | 1 percentual. |
4 · Desconto no subtotal (produtos)
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| R$ no subtotal | 4 / 1 | 1 valor ou percentual; 999 obrigatório: "true" = desconto rateado e exibido em cada produto; "false" = desconto aplicado uma vez sobre o total dos produtos. Escreva "true" em minúsculas: qualquer outro valor vale como "false". 13 ignorar remarcados — somente no percentual com 999 = "false", e nele é obrigatório. |
| % no subtotal | 4 / 2 |
Sem o argumento 999 o desconto é descartadoDescontos do grupo
4sem o argumento999são ignorados ao salvar. Envie sempre"true"ou"false".
5 · Brinde
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| Brinde de produto | 5 / 1 | 5 quantidade; 4 IDs de produto (uma variante disponível é escolhida automaticamente). |
| Brinde de variante | 5 / 1 | 5 quantidade; 6 um ID de variante. |
| Brinde selecionável pelo cliente | 5 / 3 | 5 quantos brindes o cliente escolhe; 4 IDs de produto ou 6 IDs de variante (nunca os dois). |
- Produtos de sellers (marketplace) não podem ser brinde.
- Brinde selecionável: os IDs devem ser inteiros positivos e sem repetição, e a quantidade deve ser um inteiro entre 1 e o número de opções. Fora dessas regras a resposta é
400(validação de formato).
6 a 10 · Outros descontos
Nos grupos 6 a 10, o valor de discountSubGroup é ignorado; envie o indicado na tabela.
| Desconto | Grupo / tipo | Argumentos |
|---|---|---|
| Valor máximo de frete | 6 / 1 | 9 valor máximo do frete em R$ ("0" = frete grátis); 2 e 19 opcionais, como no grupo 2. |
| Tabela de preço | 7 / 1 | 7 um ID de tabela de preço. Os itens passam a usar o preço da tabela. |
| Preço fixo por quantidade (“leve N por R$ X”) | 8 / 1 | 17 faixas "quantidade:preço", ex.: ["2:100.00","3:140.00"] (sem repetir quantidades); e um alvo: 4 IDs de produto, 3 IDs de categoria ou 14 IDs de marca. |
| Desconto progressivo | 9 / 2 | 20 critério: "1" quantidade, "2" valor em R$; 21 agrupamento: "1" carrinho inteiro, "2" por produto, "3" por variante (SKU); 22 faixas "limite:percentual", ex.: ["2:10","5:20"]. |
| Desconto no N-ésimo item do mesmo SKU | 10 / 2 | 23 regras "N:percentual", ex.: ["2:20","3:50"] (N inteiro > 0 e único); 24 máximo de repetições, "0" = sem limite. |
- Progressivo: ao menos 2 faixas, limites maiores que zero e estritamente crescentes, percentuais entre 0 (exclusivo) e 100. Vale a maior faixa atingida.
- N-ésimo item: percentuais entre 0 (exclusivo) e 100; as regras de maior N são aplicadas primeiro.
Updated about 2 hours ago