Regras adicionais
As regras adicionais (entityRules) incluem ou excluem itens do carrinho da promoção com base em uma entidade (marca, seller, coleção…). Cada regra tem quatro campos:
| Campo | Valores |
|---|---|
entityId | Entidade (tabela abaixo). |
validationId | 1 incluir todos · 2 excluir todos · 3 apenas os informados · 4 todos exceto os informados. |
restrictionId | Onde a regra vale: 2 apenas no desconto (o item não recebe benefício) · 3 apenas nas condições (o item não conta para atingir as condições) · 1 nos dois. |
arguments | IDs da entidade, como strings. Obrigatório com validationId 3 ou 4; vazio com 1 ou 2. |
entityId | Entidade | Valores de arguments |
|---|---|---|
1 | Kit | IDs de kit. |
2 | Produtos remarcados (preço “por” menor que o preço “de”) | Sem argumentos. |
3 | Marca | IDs de marca. |
4 | Seller | IDs de seller. |
5 | Atributos | "{attributeId}:{valor}", ex.: ["4:Azul","9:P"]. |
6 | Recorrência de assinatura | IDs de recorrência de assinatura. |
7 | Centro de distribuição | IDs de centro de distribuição. |
8 | Coleção | IDs de coleção. |
9 | Grupo de produtos | IDs de grupo de produtos. |
10 | Pré-venda (produtos com lançamento futuro) | Sem argumentos. |
As entidades e as combinações recomendadas para a loja estão em Estrutura de regras adicionais. Ao salvar, só é conferido que a entidade existe e que arguments está preenchido com as validações 3 e 4; use apenas as validações e restrições listadas na estrutura. Para Atributos (entidade 5), envie "{attributeId}:{valor}", mesmo que a estrutura indique ListInt.
Regra no desconto e nas condições
- Para aplicar a mesma regra no desconto e nas condições, envie duas regras com a mesma entidade, validação e argumentos: uma com restrição
2e outra com3. A API as grava como uma regra só. - A leitura (Obter promoção) sempre devolve essas regras separadas, como
2e3. - Também é aceito enviar uma única regra com restrição
1, com o mesmo efeito. - Os argumentos são comparados sem considerar ordem, espaços e repetições. Qualquer outra diferença mantém duas regras independentes.
- Regras repetidas (duas
2ou duas3iguais, ou uma1junto de uma2ou3iguais) são recusadas com400(ENTITY_RULE_DUPLICATED).
// Não dar desconto em produtos remarcados nem em produtos da marca 12
"entityRules": [
{ "entityId": 2, "validationId": 2, "restrictionId": 2, "arguments": [] },
{ "entityId": 3, "validationId": 4, "restrictionId": 2, "arguments": ["12"] }
]Updated about 2 hours ago

