Loading
Aprenda mais sobre o Gerenciamento de oferta em tempo real
APIs de uso de cupom

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. Gerenciamento de oferta em tempo real

APIs de uso de cupom

Use as APIs de uso de cupom para rastrear com precisão o uso de cupons pelos clientes. Quando os clientes selecionam um cupom para o carrinho, use a API de aumento de uso do cupom para aumentar a contagem de uso do cupom. Se um cliente remover um cupom selecionado do carrinho, use a API de redução de uso do cupom para reverter a contagem de uso do cupom.

Edições obrigatórias

Disponível em: Lightning Experience
Disponível em: Edições Enterprise, Unlimited e Developer com Gerenciamento de ofertas em tempo real

API de aumento de uso de cupom

A API gerencia resgates de cupom rastreando o uso geral e por usuário de cada cupom.

Quando um cliente seleciona um cupom que deseja aplicar ao carrinho para uma promoção, execute a API de aumento de uso do cupom para resgatar o cupom selecionado para o cliente. A API aumenta a contagem de uso geral do cupom e a contagem de uso do cupom do cliente.

A resposta da API fornece informações detalhadas sobre o cupom, incluindo a contagem de uso atualizada, o limite de resgate do cupom e o número restante de resgates disponíveis para o cupom e o cliente.

API de redução de uso de cupom

Use a API de redução de uso de cupom para reduzir a contagem de uso de cupons quando os clientes desmarcarem um cupom no carrinho. A API de redução de uso de cupom também pode ser usada para diminuir a contagem de uso de cupom quando uma transação falha ou é cancelada.

A resposta da API fornece informações detalhadas sobre o cupom para o qual a contagem de uso foi reduzida. As informações também incluem o limite de resgate atualizado do cupom e o número restante de resgates disponíveis para o cupom e o cliente.

Exemplo
Exemplo Os gerentes de marketing da Cloud Kicks criaram uma promoção para Sneakerheads, oferecendo um desconto de US$ 50 em tênis com uma compra mínima de US$ 100 na loja. O cupom para essa promoção pode ser resgatado até 15 mil vezes no total, com um limite de cinco resgates por cliente. Quando um cliente faz uma compra com sucesso usando o cupom, use a API de aumento de uso do cupom para atualizar a contagem de resgate para o cupom. 

[
  {
    "couponCode": "SNEAKER50",
    "isSuccess": true,
    "redemptionLimit": 15000,
    "redemptionLimitPerCustomer": 5,
    "remainingRedemptionCount": 13447,
    "remainingRedemptionCountForCustomer": 2
  }
]
O cupom SNEAKER50 foi selecionado inicialmente, mas o cliente o removeu do carrinho mais tarde. Use a API de redução de uso de cupom para reverter a contagem. O resultado mostra que ainda restam 13.448 resgates no geral e 3 restantes para esse cliente em particular.
{
    "couponCode": "SNEAKER50",
    "isSuccess": false
   "redemptionLimit": 15000,
    "redemptionLimitPerCustomer": 5,
    "remainingRedemptionCount": 13448,
    "remainingRedemptionCountForCustomer": 3
}
]
 
Carregando
Salesforce Help | Article