Elegibilidade e contexto

O contexto representa as informações comerciais disponíveis no momento da decisão. A API usa esses dados para avaliar regras sem acoplar o Cupom ao modelo interno do seu checkout.

Dados de contexto

O contexto pode incluir consumidor, atributos personalizados, localização, forma de pagamento, carrinho, frete, unidade e marca. Envie apenas os campos necessários às regras que sua operação utiliza.

Campos ausentes não satisfazem restrições que dependam deles. Se um cupom exige um estado específico e a localização não for enviada, ele não deve ser considerado elegível.

Carrinho

Cada item informa identificador externo, quantidade e preço unitário. O identificador precisa ser consistente com o catálogo e com os produtos usados na configuração das regras.

Cupons públicos e privados

Consultas de elegibilidade retornam ofertas conforme a visibilidade configurada. O campo context.public permite distinguir descoberta pública de cupons privados conhecidos pelo consumidor.

Elegibilidade e cálculo

Elegibilidade responde quais ofertas podem ser consideradas. A cotação calcula o efeito financeiro de um ou mais códigos sobre um carrinho específico. Use a operação correspondente à decisão que seu produto precisa tomar.