YAyampi
Promoções - Cupons de desconto

Visualizar cupom

Changed on

Obtém detalhes de um cupom de desconto específico

get/{alias}/pricing/promocodes/{id}

Request

  • Base URL
    https://api.dooki.com.br/v2
  • URL
    https://api.dooki.com.br/v2/{alias}/pricing/promocodes/{id}
  • Auth
    API key in header User-Token and API key in header User-Secret-Key

Path parameters

aliasstring required

Alias da loja

idinteger required

ID do cupom

Query parameters

includestring[]

Incluir relacionamentos adicionais

[
  "?include=customer,products"
]

Response

Detalhes do cupom

idinteger

ID do cupom.

codestring

Código digitado pelo cliente no carrinho para aplicar o cupom. Único na loja, com no mínimo 3 e no máximo 40 caracteres.

descriptionstring

Descrição interna do cupom, com até 60 caracteres. Emojis são removidos ao salvar.

customer_idinteger

ID do cliente para quem o cupom é exclusivo. Quando nulo, o cupom vale para qualquer cliente.

activeboolean

Indica se o cupom está ativo.

expiredboolean

Indica se a data de término do cupom já passou.

discount_type'p' | 'v'

Tipo do desconto do cupom: p para percentual e v para valor fixo em reais.

for_the_price_ofboolean

Indica se o cupom é do tipo 'pelo preço de', em que cada produto elegível passa a custar o valor de price_products.

cart_defaultboolean

Indica se o cupom é aplicado automaticamente no carrinho. Um cupom percentual de 100% ou mais nunca é tratado como padrão.

type_increment_valuestring

Tipo do desconto como está gravado no cupom, com os mesmos valores de discount_type (p ou v).

valuenumber float

Valor do desconto: percentual quando discount_type for p, ou valor em reais quando for v.

price_productsnumber float

Preço aplicado a cada produto elegível quando for_the_price_of for verdadeiro. Obrigatório nesse caso.

percent_productsnumber float

Percentual de desconto aplicado ao preço de cada produto elegível, usado em vez de price_products quando for maior que zero.

quantityinteger

Quantidade total de usos disponíveis do cupom. O cupom deixa de valer quando used alcança esse número.

total_customers_usedinteger

Quantidade de clientes distintos que já usaram o cupom.

product_quantityinteger

Quantidade de produtos elegíveis que o cupom 'pelo preço de' considera no cálculo do total.

product_max_quantityinteger

Quantidade máxima de produtos elegíveis a que o cupom se aplica.

usedinteger

Quantidade de vezes que o cupom já foi usado.

items_countinteger

Quantidade de itens do carrinho considerada na regra do cupom. Campo legado: é gravado e devolvido, mas nenhuma regra desta API o aplica.

min_valuenumber float

Valor mínimo do subtotal do carrinho, em reais, para o cupom poder ser aplicado.

use_percentnumber float

Proporção de uso do cupom, entre os usos já feitos e o total disponível.

shipment_percentnumber float

Percentual de desconto aplicado ao frete, usado quando o cupom desconta no frete em vez de descontar nos produtos.

accumulateboolean

Indica se o cupom pode ser acumulado com outras promoções da loja.

once_per_customerboolean

Indica se cada cliente pode usar o cupom uma única vez.

abandoned_cartboolean

Indica se o cupom está vinculado a alguma configuração de recuperação de carrinho abandonado.

newsletterboolean

Indica se o cupom é entregue ao cliente que se inscreve na newsletter da loja.

payments_idsstring

IDs dos meios de pagamento em que o cupom é aceito.

free_shipmentboolean

Indica se o cupom concede frete grátis em vez de desconto no valor do pedido.

ignore_promotion_productsboolean

Indica se o cupom deixa de valer para produtos que já estão em promoção.

freebie_idinteger nullable

Brinde concedido pelo cupom

advertiseboolean

Divulgar o cupom com brinde no checkout

include_idsinteger[]

IDs dos produtos alcançados pelas regras de inclusão, já expandindo marcas, coleções e categorias

exclude_idsinteger[]

IDs dos produtos alcançados pelas regras de exclusão, já expandindo marcas, coleções e categorias

Example response

{
  "code": "TEST",
  "value": 10,
  "used": 22,
  "min_value": 99.99,
  "use_percent": 0.02,
  "payments_ids": "[1, 2, 3, 4]",
  "start_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "end_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "created_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "updated_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  }
}

Changes

  • bbafb577e11cRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status