---
title: "Atualizar cupom"
method: PUT
path: "/{alias}/pricing/promocodes/{id}"
tags: ["Promoções - Cupons de desconto"]
---

# Atualizar cupom

`PUT /{alias}/pricing/promocodes/{id}`

Atualiza os detalhes de um cupom de desconto específico

## Path parameters

- `alias` string, required
- `id` integer, required

## Request body

- PromocodeRequest
  - `active` boolean — Ativação do cupom
  - `for_the_price_of` boolean — Cupom para o preço de
  - `accumulate` boolean — Acumulação do cupom
  - `once_per_customer` boolean — Válido apenas uma vez por cliente
  - `abandoned_cart` boolean — Cupom para carrinho abandonado
  - `newsletter` boolean — Cupom para assinatura de newsletter
  - `free_shipment` boolean — Cupom para frete grátis
  - `ignore_promotion_products` boolean — Ignorar produtos promocionais
  - `discount_type` 'p' | 'v' — Tipo de desconto
  - `value` number, float — Valor do desconto
  - `code` string — Código do cupom
  - `quantity` integer — Quantidade disponível do cupom
  - `min_value` number, float — Valor mínimo para aplicação do cupom
  - `start_at` string, date-time — Data e hora de início
  - `end_at` string, date-time — Data e hora de término

## Response `200`

Cupom atualizado com sucesso

- Promocode — Representa um código promocional
  - `id` integer
  - `code` string
  - `description` string
  - `customer_id` integer
  - `active` boolean
  - `expired` boolean
  - `discount_type` 'p' | 'v'
  - `for_the_price_of` boolean
  - `cart_default` boolean
  - `type_increment_value` string
  - `value` number, float
  - `price_products` number, float
  - `percent_products` number, float
  - `quantity` integer
  - `total_customers_used` integer
  - `product_quantity` integer
  - `product_max_quantity` integer
  - `used` integer
  - `items_count` integer
  - `min_value` number, float
  - `use_percent` number, float
  - `shipment_percent` number, float
  - `accumulate` boolean
  - `once_per_customer` boolean
  - `abandoned_cart` boolean
  - `newsletter` boolean
  - `payments_ids` string
  - `free_shipment` boolean
  - `ignore_promotion_products` boolean

## Other responses

- `400` — Dados inválidos fornecidos
- `404` — Cupom não encontrado

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)