API Yampi
Search
K
Comment on page

Promoções

Cupons de desconto

Includes disponíveis: customer, categories, collections, brand, products, payments

Listar cupons

GET https://api.dooki.com.br/v2/{alias}/pricing/promocodes
Request
{
"code": "TEST",
"customer_id": null,
"active": true,
"discount_type": "p",
"newsletter": false,
"ignore_promotion_products": false,
"free_shipment": false,
"abandoned_cart": false,
"once_per_customer": false,
"for_the_price_of": false,
"accumulate": false,
"min_value": 99.99,
"value": 10,
"price_products": 0,
"quantity": 100000,
"start_at": "2017-09-09 00:00:00",
"end_at": "2017-09-13 00:00:00",
"payments_ids": [1, 2, 3, 4],
"restrictions": {
"include": {
"products_ids": [1,2,3,4,5,6],
"brands_ids": [],
"collections_ids": [],
"categories_ids": []
},
"exclude": {
"products_ids": [10,12],
"brands_ids": [],
"collections_ids": [],
"categories_ids": []
},
}
}
Response
{
"data": [
{
"id": 1,
"code": "TEST",
"customer_id": null,
"active": true,
"discount_type": "p",
"newsletter": false,
"ignore_promotion_products": false,
"free_shipment": false,
"abandoned_cart": false,
"once_per_customer": false,
"for_the_price_of": false,
"accumulate": false,
"min_value": 99.99,
"value": 10,
"price_products": 0,
"quantity": 100000,
"used": 22,
"use_percent": 0.02,
"expired": true,
"total_customers_used": 22,
"start_at": {
"date": "2016-05-09 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"end_at": {
"date": "2016-12-31 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"customer": {
"data": []
},
"payments": {
"data": []
},
"restrictions": {
"include": {
"products_ids": [1,2,3,4,5,6],
"brands_ids": [],
"collections_ids": [],
"categories_ids": []
},
"exclude": {
"products_ids": [10,12],
"brands_ids": [],
"collections_ids": [],
"categories_ids": []
},
"include_ids": [1,2,3,4,5],
"exclude_ids": [1,2,3,4,5],
}
},
]
}

Criar cupom

POST https://api.dooki.com.br/v2/{alias}/pricing/promocodes
Parâmetro
Tipo
Obrigatório
Descrição
active
boolean
Sim
Status do cupom.
customer_id
int
Não
ID do cliente. Utilizado caso o cupom seja de uso exclusivo.
for_the_price_of
boolean
Sim
Define se o cupom modificará preços de produtos.
accumulate
boolean
Sim
Define se o desconto será acumulado com outros.
once_per_customer
boolean
Sim
Define se o cupom é de uso único por cliente.
abandoned_cart
boolean
Sim
Define se o cupom será enviado em e-mails de carrinhos abandonados.
newsletter
boolean
Sim
Define se o cupom será enviado aos leads cadastrados no campo de newsletter.
free_shipment
boolean
Sim
Define se o cupom aplicará frete grátis na compra.
ignore_promotion_products
boolean
Sim
Define se o cupom ignorará produtos em promoção na regra do desconto.
discount_type
string
Sim
Tipo de desconto do cupom p para porcentagem e v para valor.
value
float
Sim
Valor de desconto do cupom.
code
string
Sim
Código do cupom.
quantity
int
Sim
Quantidade disponível do cupom.
price_products
float
Não
Novo preço dos produtos cupom. Se for_the_price_of for true.
product_quantity
int
Não
Quantidade mínima para os preços dos produtos serem modificados. Se for_the_price_of for true.
min_value
float
Sim
Valor mínimo da compra para que o desconto seja aplicado.
shipment_percent
float
Não
Porcentagem de desconto no frete.
start_at
datetime
Sim
Início da validade do cupom. Formato: yyyy-mm-dd H:i:s.
end_at
datetime
Sim
Fim da validade do cupom. Formato: yyyy-mm-dd H:i:s.
payments_ids
array
Não
Lista de pagamentos que o desconto será aplicado.
banners_ids
array
Não
Lista de banners da promoção.
restrictions
array
Não
Regras de restrições.

Visualizar cupom

GET https://api.dooki.com.br/v2/{alias}/pricing/promocodes/{id}

Atualizar cupom

PUT https://api.dooki.com.br/v2/{alias}/pricing/promocodes/{id}

Excluir cupom

DELETE https://api.dooki.com.br/v2/{alias}/pricing/promocodes/{id}

Lista de clientes que usaram o cupom

GET https://api.dooki.com.br/v2/{alias}/pricing/promocodes/{id}/customers

Frete grátis

Listar regras de frete grátis

GET https://api.dooki.com.br/v2/{alias}/pricing/free-shipment
Request
{
"rules": [
{
"uf": "SP",
"min": 199,
"shipment_service_id": 6,
"service_name": "pac"
},
{
"uf": "MG",
"min": 199,
"shipment_service_id": 6,
"service_name": "sedex"
}
]
}
Response
{
"data": [
{
"id": 2,
"shipment_service_id": 6,
"service_name": "sedex",
"min": 199,
"uf": "MG"
},
{
"id": 1,
"shipment_service_id": 6,
"service_name": "pac",
"min": 199,
"uf": "SP"
}
],
"excluded_brands_ids": [],
"excluded_categories_ids": [],
"excluded_products_ids": [
31055
],
// Este objeto retorna todos os IDS dos produtos reunidos.
"excluded_products_ids_merged": [
31055
],
}

Criar ou atualizar regras de frete grátis

POST https://api.dooki.com.br/v2/{alias}/pricing/free-shipment
Parâmetro
Tipo
Obrigatório
Descrição
rules
array
Sim
Array com as regras de cada estado.
rules[shipment_service_id]
int
Sim
ID do serviço de entrega.
rules[service_name]
string
Não
Nome do serviço de entrega.
rules[min]
float
Sim
Valor mínimo da compra.
rules[uf]
string
Sim
Sigla do estado.
exclude_brands_ids
array
Não
IDS de marcas que não entram na regra de frete grátis.
exclude_categories_ids
array
Não
IDS de categorias que não entram na regra de frete grátis.
exclude_products_ids
array
Não
IDS de produtos que não entram na regra de frete grátis.

Desconto progressivo

Listar descontos progressivos

GET https://api.dooki.com.br/v2/{alias}/pricing/progressive-discounts
Request
{
"active": true,
"min_value": 0,
"max_value": 100,
"start_at": "2017-07-02 10:00",
"end_at": "2018-08-17 12:00",
"percent": 5
}
Response
{
"data": {
"id": 1,
"active": true,
"min_value": 0,
"max_value": 100,
"start_at": "2017-07-02 10:00",
"end_at": "2018-08-17 12:00",
"percent": 5
}
}

Criar desconto progressivo

POST https://api.dooki.com.br/v2/{alias}/pricing/progressive-discounts
Parâmetro
Tipo
Obrigatório
Descrição
active
bool
Não
Se o desconto estará ativo ou não
min_value
float
Sim
Valor mínimo do intervalo.
max_value
float
Sim
Valor máximo do intervalo.
percent
float
Sim
Porcentagem de desconto.
start_at
datetime
Sim
Data e horário de início.
end_at
datetime
Sim
Data e horário de término.
restrictions
array
Não
Regras de restrições

Promoções de produtos

Includes disponíveis: categories, collections, brands, products, banners

Listar promoções

GET https://api.dooki.com.br/v2/{alias}/pricing/promotions
Request
{
"active": true,
"all_products": false,
"utm_only": true,
"utm_source": "google",
"utm_campaign": "adwords",
"name": "Test",
"start_at": "2017-08-08 00:00:00",
"end_at": "2017-08-08 00:00:00",
"banners_ids": [1, 2, 3, 4],
}
Response
{
"data": [
{
"active": true,
"all_products": false,
"utm_only": true,
"utm_source": "google",
"utm_campaign": "adwords",
"name": "Test",
"start_at": "2017-08-08 00:00:00",
"end_at": "2017-08-08 00:00:00",
"expired": true,
"url": "https://www.domain.com/promocoes/test",
"start_at": {
"date": "2016-05-09 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"end_at": {
"date": "2016-12-31 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"banners": {
"data": []
}
},
]
}

Criar promoção

POST https://api.dooki.com.br/v2/{alias}/pricing/promotions
Parâmetro
Tipo
Obrigatório
Descrição
active
boolean
Sim
Status da promoção.
all_products
boolean
Sim
Marca se a promoção é para todos os produtos da loja.
utm_only
boolean
Sim
Marca se a promoção é válida apenas por tags UTM.
name
string
Sim
Nome da promoção.
slug
string
Não
Slug da promoção.
value
float
Sim
Porcentagem de desconto.
utm_source
string
Não
Origem de acesso do cliente
utm_campaign
string
Não
Campanha de origem de acesso
start_at
datetime
Sim
Início da validade do cupom. Formato: yyyy-mm-dd H:i:s.
end_at
datetime
Sim
Fim da validade do cupom. Formato: yyyy-mm-dd H:i:s.
restrictions
array
Não
Regras de restrições.
banners_ids
array
Não
Lista de banners que a página de promoção terá.

Visualizar promoção

GET https://api.dooki.com.br/v2/{alias}/pricing/promotions/{id}

Atualizar promoção

PUT https://api.dooki.com.br/v2/{alias}/pricing/promotions/{id}

Excluir promoção

DELETE https://api.dooki.com.br/v2/{alias}/pricing/promotions/{id}

Lista de produtos da promoção

GET https://api.dooki.com.br/v2/{alias}/pricing/promotions/{id}/products

Combos (compre junto)

Includes disponíveis: products

Listar combos

GET https://api.dooki.com.br/v2/{alias}/pricing/combos
Request
{
"active": true,
"discount_type": "p",
"name": "Combo test",
"start_at": "2017-08-08 00:00:00",
"end_at": "2017-08-08 00:00:00",
"discount_value": 10,
"products_ids": [1, 2, 3, 4],
}
Response
{
"data": [
{
"id": 1,
"active": true,
"type_increment_value": "p",
"discount_value": 10,
"name": "Combo test",
"description": null,
"expired": true,
"total_products": 4,
"start_at": {
"date": "2016-05-09 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"end_at": {
"date": "2016-12-31 09:51:00.000000",
"timezone_type": 3,
"timezone": "America/Sao_Paulo"
},
"products": {
"data": []
},
},
]
}

Criar combo

POST https://api.dooki.com.br/v2/{alias}/pricing/combos
Parâmetro
Tipo
Obrigatório
Descrição
active
boolean
Sim
Status do compre junto.
name
string
Sim
Nome do compre junto.
description
string
Não
Descrição do compre junto.
discount_type
string
Sim
Tipo de desconto. p para porcentagem e v para valor.
discount_value
float
Sim
Valor do desconto.
products_ids
array
Sim
Lista de produtos que o desconto será aplicado.

Visualizar combo

GET https://api.dooki.com.br/v2/{alias}/pricing/combos/{id}

Atualizar combo

PUT https://api.dooki.com.br/v2/{alias}/pricing/combos/{id}

Excluir combo

DELETE https://api.dooki.com.br/v2/{alias}/pricing/combos/{id}