Receitas de condições

Cada linha mostra o que enviar em conditionGroup, conditionSubGroup, logicOperator.id e logicOperator.arguments para obter a condição desejada. Os operadores listados são os habituais; os aceitos na sua loja estão em Estrutura de condições.

📘

Lembretes

Todos os valores são strings. Listas de IDs vão como vários itens em values: ["15","22"]. Argumentos marcados como “um ID” aceitam um único valor.

Na maioria das condições, os operadores de comparação (1 a 6) e o 9 aceitam um único ID nos argumentos de lista de IDs (ListInt/ListLong); mais de um é recusado. Para listas, use 7 (está contido) ou 8 (não está contido). Aceitam vários IDs com qualquer operador: quantidade em categorias (3/21 e 3/22), quantidade de produtos (4/11), valor em marcas (4/13) e as marcas do subtotal (5/16). Listas de texto não têm esse limite.

1 · Consumidor

2 · Endereço de entrega

3 · Categorias

4 · Produtos

5 · Carrinho

6 · Tráfego / campanha

8 · Pagamento

🚧

Combinações não reconhecidas são descartadas

O grupo 7 (“Outros”) e pares grupo/subgrupo fora destas tabelas são ignorados ao salvar, sem erro. Nos grupos 6 e 8 o subgrupo não é conferido: qualquer subgrupo vira, respectivamente, parâmetro UTM e grupo de forma de pagamento. Confira a promoção com Obter promoção depois de salvar.

Condição de clientes específicos

A condição 1 / 4 recebe, no argumento 16, um único valor: o objeto de filtro de Buscar clientes serializado como string JSON. Ao salvar, o filtro é executado e os clientes encontrados ficam vinculados à condição. Todos os campos do filtro são opcionais.

{
  "conditionGroup": 1, "conditionSubGroup": 4,
  "logicOperator": {
    "id": 7,
    "arguments": [
      { "id": 16, "values": [ "{\"customersId\":[501,502,503]}" ] }
    ]
  }
}

Exemplo de filtro (conteúdo da string, antes de serializar): clientes de SP ou RJ que compraram nos últimos 6 meses.

{ "filtersGroup": [ { "states": ["SP", "RJ"], "lastPurchase": { "purchaseSituation": true, "dateFilter": 5 } } ] }

• A lista é calculada no momento em que a promoção é salva. Clientes cadastrados depois não entram automaticamente.
• Limite: 80 mil clientes por condição (LIMIT_OF_USERSLINKED_CONDITION_REACHED).
• Um valor que não é JSON (inclusive "" e a contagem lida no GET) retorna 400 (MISSING_ARGUMENTS, “Filtro de clientes inválido”).
• Um filtro que não encontra nenhum cliente (inclusive {}) é recusado com 400 (PRIVATE_API_VALIDATION). Confira o filtro antes em Buscar clientes; lá, porém, linkedCustomers: false sem filtersGroup retorna todos os clientes da loja, enquanto na condição isso não vincula ninguém.
• Resultados da busca de clientes ficam em cache por até 5 minutos, também ao salvar: clientes que acabaram de se cadastrar podem não entrar.
• Não envie page, limit, orderBy nem orderDirection no filtro da condição: page maior que 1 faz a gravação pular clientes.
• Use o operador 7 (a promoção vale para esses clientes) ou 8 (vale para todos, exceto esses). O operador 1 só aceita um filtro que resulte em exatamente um cliente. Carrinhos sem cliente identificado não atendem a esta condição com nenhum operador.
• Para conferir os vinculados depois de salvar, use Clientes de uma condição.

Ao editar

Na leitura, values[0] traz apenas a quantidade de clientes vinculados (ex.: "842"). Reenviar esse número retorna 400. Para manter a lista atual e, se quiser, incluir ou remover clientes, envie:

"{\"promotionId\":1234,\"conditionId\":5521,\"linkedCustomers\":true,\"customersId\":[777],\"customersId_Neq\":[502]}"

onde conditionId é o conditionPromotionId da condição lido no GET imediatamente antes do PUT (ele muda a cada atualização); customersId adiciona e customersId_Neq remove clientes. Sem linkedCustomers: true, ou com um conditionId desatualizado, os clientes atuais não são mantidos e não há erro: a condição fica só com o que customersId e os filtros trouxerem.