---
title: Promoções
description: Crie descontos automáticos ou códigos de promoção e controle quem pode usá-los.
---

Use Promoções para definir um desconto, sua experiência do cliente, suas regras de elegibilidade e se está ativo ou ainda é um rascunho.

## Por que e quando usar Promoções

Crie uma promoção para uma campanha planejada, incentivo ao cliente, oferta de frete grátis ou oferta de compre e ganhe. Comece em Rascunho enquanto verifica os detalhes; use Ativo apenas quando o desconto deve ser elegível no checkout.

## Disponibilidade e pré-requisitos

- Abra um projeto Runner com um backend de loja pronto.
- Crie os produtos referenciados por uma regra Compre X Ganhe Y antes de construir essa promoção.
- Confirme a moeda de mercado relevante e a configuração de envio antes de oferecer descontos baseados em valor ou frete grátis.
- Teste o comportamento do checkout com um pedido de teste apropriado antes de compartilhar um código publicamente.

## Abrir Promoções

**Caminho de entrada:** **Workspace → escolha uma loja → Store Operations → Promoções**

## Controles principais

| Controle | Por que você o usa | O que acontece quando selecionado |
| --- | --- | --- |
| **Criar** / **Adicionar Primeira Promoção** | Escolha um novo tipo de desconto | Abre um menu para Desconto de valor no pedido, Desconto percentual no pedido, Compre X Ganhe Y ou Frete grátis. A lista vazia usa **Adicionar Primeira Promoção**. |
| **Desconto de valor no pedido** | Desconte o total do pedido por um valor fixo | Abre um formulário com valor, método, status e configurações de elegibilidade. |
| **Desconto percentual no pedido** | Desconte o total do pedido por uma porcentagem | Abre um formulário com um valor percentual e as configurações compartilhadas. |
| **Compre X Ganhe Y** | Dê produtos selecionados após uma compra qualificada | Abre seletores de quantidade e produto para o que o cliente compra e ganha. |
| **Frete grátis** | Remova taxas de envio elegíveis | Abre uma promoção cujo desconto se aplica ao envio. |
| **Desconto automático** | Aplique a promoção sem pedir um código ao cliente | O checkout avalia as regras automaticamente, mas o formulário ainda exige um valor de código para identificar a promoção. |
| **Código de promoção** | Exija um código inserido pelo cliente | Os clientes devem inserir o código obrigatório no checkout. |
| **Ativo** / **Rascunho** | Controle se a promoção é utilizável | Salva o estado operacional escolhido com a promoção. |
| **Adicionar condição** | Limite quem pode usar a promoção | Adiciona campos de atributo do cliente, operador e valor. |
| **Salvar** | Aplique um formulário de criação ou edição válido | Cria ou atualiza a promoção e retorna à lista de promoções após o sucesso. |
| Linha de promoção | Inspecione uma promoção | Abre tipo, método, status, código, uso e ações disponíveis. |
| **Editar** | Altere a promoção selecionada | Abre o formulário de edição para esse tipo de promoção existente. |
| **Excluir** | Remova permanentemente a promoção | Da lista de desktop, abre uma confirmação irreversível nomeando o código de promoção. A visualização móvel atual não mostra essa ação. |

## Crie uma promoção

1. Selecione **Criar** ou **Adicionar Primeira Promoção** quando a lista estiver vazia.
2. Escolha o tipo que corresponde à oferta.
3. Escolha **Desconto automático** ou **Código de promoção**.
4. Insira o valor de código obrigatório. Para **Código de promoção**, insira o código exato que os clientes devem usar; para **Desconto automático**, os clientes não o inserem.
5. Escolha **Rascunho** enquanto prepara ou **Ativo** quando deve ser elegível.
6. Insira o valor do Desconto ou selecione os produtos Compre e Ganhe e quantidades.
7. Deixe a elegibilidade como todos os clientes ou selecione **Adicionar condição** e complete cada campo de condição.
8. Revise o resumo, depois selecione **Salvar**.
9. Retorne à lista e confirme o Tipo, Método, Status, Código e valores Usados.

## Edite ou remova uma promoção

1. Selecione uma linha de promoção.
2. Escolha **Editar**, altere os campos pretendidos e selecione **Salvar**.
3. Teste a regra atualizada antes de compartilhá-la com clientes.
4. Para removê-la, retorne à lista de desktop, selecione **Excluir** e leia o código na confirmação.
5. Continue apenas se a remoção permanente for pretendida.

## Estados e limites

- **Rascunho** é armazenado mas não se destina a ser utilizável no checkout.
- **Ativo** é elegível para aplicar quando seu método e condições correspondem.
- **Inativo** pode aparecer na lista quando uma promoção existente não está atualmente ativa.
- Um valor percentual deve estar entre 1 e 100.
- O formulário exige um valor de código para ambos os métodos. Os clientes o inserem apenas quando **Código de promoção** é selecionado.
- Compre X Ganhe Y exige tanto o produto qualificado quanto o produto gratuito.
- Cada condição adicionada precisa de um atributo, operador e valor.
- Com um desconto automático, o checkout decide se suas regras correspondem; o cliente não insere o valor de código do formulário.

## Solução de problemas

- **Salvar está desativado ou mostra um erro:** Complete o valor, código, produto, quantidade ou campos de condição nomeados pelo formulário.
- **Um código não funciona no checkout:** Confirme a ortografia exata, status Ativo, elegibilidade do cliente, requisitos de produto, mercado e checkout atual.
- **Um desconto automático não se aplica:** Verifique se o pedido atende a cada condição e se outra promoção não está alterando o resultado esperado.
- **Uma promoção de frete grátis não tem efeito visível:** Confirme se o pedido tem uma opção de envio salva elegível e se a promoção está Ativa.
- **A lista de promoções falha ao carregar:** Atualize a página e confirme o projeto correto antes de tentar criar uma duplicata.

## Guias relacionados

- [Produtos](./products)
- [Clientes](./customers)
- [Envio](./shipping)
- [Pedidos](./orders)