PUT /discountCoupons
PUT
/v2/discountCoupons/{id}
Atualiza um cupom de desconto
/v2/discountCoupons/:idPath Parameters
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | integer | Obrigatório | ID do cupom de desconto |
Body Parameters
R$ = desconto fixo em reais
% = desconto percentual
delivery = apenas delivery
balcao = apenas balcão
todos = todos os tipos de entrega
categoria = categoria do cardápio
promoção = promoção
pizza = pizza
produto = produto individual
Array de 7 valores booleanos representando os dias da semana (Domingo a Sábado)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| code | string | Obrigatório | Código do cupom |
| description | string | Obrigatório | Descrição do cupom |
| discount_type | string | Obrigatório | Tipo de desconto (R$ ou %) |
| discount_value | number | Obrigatório | Valor do desconto |
| filial_id | integer | Obrigatório | ID da filial |
| valid_above | number | Opcional | Válido para pedidos acima deste valor |
| first_order_only | boolean | Opcional | Apenas no primeiro pedido do usuário |
| uses_per_customer | integer | Opcional | Limite de usos por cliente |
| start_date | string | Opcional | Data de início (YYYY-MM-DD) |
| end_date | string | Opcional | Data de fim (YYYY-MM-DD) |
| delivery_discount | boolean | Opcional | Aplicar desconto na taxa de entrega |
| free_delivery | boolean | Opcional | Entrega grátis (desconto 100% na entrega) |
| block_promotion | boolean | Opcional | Não aplicar nas promoções |
| visible | boolean | Opcional | Cupom visível |
| auto_apply | boolean | Opcional | Aplicar automaticamente |
| restrictions | object | Opcional | Restrições do cupom |
| restrictions.delivery_type | string | Opcional | Tipo de entrega permitido |
| restrictions.week_days | array | Opcional | Array de 7 booleanos (dias da semana) |
| restrictions.menu | array | Opcional | Array de itens do cardápio |
| restrictions.menu[].id | string | Obrigatório | ID do item |
| restrictions.menu[].name | string | Obrigatório | Nome do item |
| restrictions.menu[].type | string | Obrigatório | Tipo do item (categoria, promoção, pizza, produto) |
| restrictions.neighborhoods | array | Opcional | Array de bairros |
| restrictions.neighborhoods[].id | integer | Obrigatório | ID do bairro |
| restrictions.neighborhoods[].name | string | Obrigatório | Nome do bairro |
| restrictions.customers | array | Opcional | Array de clientes |
| restrictions.customers[].id | integer | Obrigatório | ID do cliente |
| restrictions.customers[].name | string | Obrigatório | Nome do cliente |
Exemplo de Request Body
{
"code": "TESTE_API_V2_UPDATED",
"description": "Cupom atualizado via API v2",
"discount_type": "%",
"discount_value": 15.0,
"valid_above": 20.00,
"first_order_only": false,
"uses_per_customer": 5,
"start_date": "2024-02-01",
"end_date": "2024-11-30",
"delivery_discount": true,
"free_delivery": false,
"filial_id": 1,
"block_promotion": false,
"visible": true,
"auto_apply": false,
"restrictions": {
"delivery_type": "todos",
"week_days": [
true,
true,
true,
true,
true,
false,
false
],
"menu": [
{
"id": "50",
"name": "Categoria Pizzas",
"type": "categoria"
}
],
"neighborhoods": [
{
"id": 1,
"name": "Bombas"
}
],
"customers": null
}
}###ExemplodeResposta(200){
"id": 2110,
"code": "TESTE_API_V2_UPDATED",
"active": false,
"description": "Cupom atualizado via API v2",
"discount_type": "%",
"discount_value": 15.0,
"valid_above": 20.00,
"first_order_only": false,
"uses_per_customer": 5,
"start_date": "2024-02-01",
"end_date": "2024-11-30",
"delivery_discount": true,
"free_delivery": false,
"filial_id": 1,
"block_promotion": false,
"visible": true,
"auto_apply": false,
"restrictions": {
"delivery_type": "todos",
"week_days": [
true,
true,
true,
true,
true,
false,
false
],
"menu": [
{
"id": "50",
"name": "Categoria Pizzas",
"type": "categoria"
}
],
"neighborhoods": [
{
"id": 1,
"name": "Bombas"
}
],
"customers": null
}
}
Requisição
Parâmetros de Caminho
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.alfalabs.com.br/v2/v2/discountCoupons/' \
--header 'Authorization: Bearer <token>'Response Response Example
{}Modificado em 2026-04-27 19:39:30