# Preços e Promoções: promoção, atacado, campanhas e atualização em massa

Esta página fica no menu do painel do lojista em **Preço promocional**. Nela você controla quatro coisas do seu produto: promoção com data de início/fim, preço por quantidade (atacado), participação em campanhas sazonais do marketplace, e atualização em massa via planilha.

## Como escolher o produto

No topo da tela, digite o **nome ou o SKU** do produto na caixa de busca. A lista mostra até 20 resultados que batem com o que você digitou (por nome do produto ou por SKU de qualquer variação). Clique no produto desejado na lista para abrir as seções abaixo. Se o produto já tiver uma promoção cadastrada, aparece "· Promoção cadastrada" ao lado do nome dele na lista.

Para trocar de produto depois de já ter selecionado um, use o botão **Trocar produto**.

## 1. Preço promocional

Essa seção define um período em que o produto (ou suas variações) fica com um preço reduzido. Enquanto a promoção estiver dentro do período, o preço promocional **substitui** o preço cheio em todo o site — no card, na página do produto e no carrinho.

<table id="bkmrk-campopara-que-serve-"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>Início da promoção / Fim da promoção</td><td>Data e hora exatas em que a promoção começa e termina. Fora desse período, o preço cheio volta a valer sozinho.</td></tr><tr><td>Aplicar o mesmo preço promocional a todas as variações</td><td>Só aparece quando o produto tem mais de uma variação (cor, tamanho, etc). Marcado: você digita um único valor e ele vale para todas as variações. Desmarcado: você digita um preço promocional diferente para cada variação.</td></tr><tr><td>Preço promocional</td><td>O novo preço em reais. Abaixo do campo aparece o preço cheio atual daquela variação, só como referência.</td></tr></table>

Clique em **Salvar promoção** para aplicar. Se quiser encerrar a promoção antes da data, use **Remover promoção** — o produto volta a vender pelo preço cheio na hora.

## 2. Preço por quantidade (atacado)

Essa seção cria faixas de desconto por quantidade — "compre X unidades, pague Y% mais barato por unidade". O desconto é sempre calculado **em cima do preço que estiver valendo naquele momento**: se houver uma promoção ativa, o atacado desconta a partir do preço promocional; se não houver promoção, desconta a partir do preço cheio. Isso evita que o preço de atacado fique, por engano, mais caro que uma promoção em andamento.

<table id="bkmrk-campopara-que-serve--1"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>A partir de ... unidades</td><td>Quantidade mínima da compra para o desconto daquela faixa valer (ex.: 10).</td></tr><tr><td>% (percentual)</td><td>Desconto percentual sobre o preço vigente naquela faixa (ex.: 15 = 15% de desconto).</td></tr></table>

Use **Adicionar faixa** para criar mais de um degrau de desconto (por exemplo: 5+ unidades = 5% off, 10+ unidades = 12% off). Depois de configurar, clique em **Salvar faixas de preço**.

**Importante:** se você mudar o preço promocional depois de já ter salvo faixas de atacado, volte nesta seção e clique em Salvar faixas de preço de novo — isso recalcula o valor do atacado em cima do novo preço promocional. Sem isso, a faixa de atacado guardada fica com o valor antigo.

## 3. Campanha sazonal

Campanhas sazonais (ex.: "Black Friday", "Dia das Mães") são criadas pelo administrador do marketplace, que define nome, período e as cores especiais do card (fundo e faixa diagonal). Nesta seção você escolhe em quais campanhas ativas o seu produto vai participar e define o preço dele para cada uma.

<table id="bkmrk-campopara-que-serve--2"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>Caixa de seleção da campanha</td><td>Marque para o produto participar daquela campanha.</td></tr><tr><td>Preço</td><td>O preço do produto durante essa campanha específica.</td></tr><tr><td>Ícone de pontinhos (arrastar)</td><td>Se o produto participar de mais de uma campanha ativa **ao mesmo tempo**, a que estiver no topo da lista é a que vence — aparece no card com a cor/faixa especial e é o preço realmente cobrado. Arraste pelo ícone para reordenar a prioridade.</td></tr></table>

Depois de marcar as campanhas e definir os preços, clique em **Salvar campanhas**. Uma campanha só aparece disponível aqui se o administrador já tiver ativado ela.

## 4. Atualização em massa (planilha)

Para quem tem muitos produtos, ajustar um por um fica inviável. O botão **Atualização em massa**, no canto superior direito da tela, abre um painel para editar promoção, atacado e campanhas de vários produtos de uma vez, por planilha (CSV).

### Passo a passo

1. **Baixar modelo**: baixa uma planilha de exemplo em branco, mostrando o formato esperado.
2. **Baixar meu catálogo atual**: baixa uma planilha já preenchida com todos os seus produtos e o que já está configurado hoje (promoção, atacado, campanhas). É a forma mais fácil de editar em massa: baixe essa, ajuste só o que precisa mudar, apague as linhas dos produtos que não vão participar de nada, e envie de volta.
3. Abra o arquivo baixado no Excel, LibreOffice ou Google Sheets normalmente.
4. Edite as colunas que quiser (veja a tabela abaixo).
5. **Apague as linhas** dos produtos/variações que você não quer alterar — só as linhas que sobrarem no arquivo são processadas.
6. Salve como **.csv**.
7. Volte na tela, clique em **Escolher planilha (.csv)**, selecione o arquivo salvo.
8. Clique em **Importar e processar**. O sistema mostra quantas linhas foram processadas e, se alguma linha der erro, lista o SKU e o motivo.

### Colunas da planilha

<table id="bkmrk-colunao-que-%C3%A9-skuide"><tr><th>Coluna</th><th>O que é</th></tr><tr><td>`sku`</td><td>Identifica o produto/variação. É a única coluna realmente usada para achar o produto — as demais (`produto`, `variacao`, `preco_atual`) são só para você reconhecer a linha, e são ignoradas na hora de processar.</td></tr><tr><td>`preco_promocional`</td><td>Novo preço promocional. Precisa vir preenchido junto com `promo_inicio` e `promo_fim` — os três juntos, ou os três vazios (vazio = sem promoção nessa linha).</td></tr><tr><td>`promo_inicio` / `promo_fim`</td><td>Data e hora no formato `AAAA-MM-DD HH:MM` (ex.: `2026-09-10 00:00`).</td></tr><tr><td>`atacado`</td><td>`sim` ou `não`. Se `sim`, precisa preencher `atacado_qtd` e `atacado_percentual` também.</td></tr><tr><td>`atacado_qtd`</td><td>Quantidade mínima para o desconto de atacado valer.</td></tr><tr><td>`atacado_percentual`</td><td>Percentual de desconto do atacado sobre o preço vigente daquela linha (promocional, se houver; senão o preço cheio).</td></tr><tr><td>`campanhas`</td><td>Nome exato de uma ou mais campanhas sazonais que o produto participa. Para mais de uma, separe com **ponto e vírgula** ( `;` ), na ordem de prioridade — a primeira da lista é a que vence se houver mais de uma ativa ao mesmo tempo. Os nomes exatos das campanhas disponíveis no momento aparecem numa área no **final da própria planilha baixada** — copie de lá para não errar a digitação.</td></tr><tr><td>`campanhas_precos`</td><td>Preço do produto em cada campanha listada em `campanhas`, na mesma ordem, também separado por ponto e vírgula. Exemplo: `campanhas = Black Friday;Dia das Mães` e `campanhas_precos = 69.90;74.90` significa R$69,90 na Black Friday e R$74,90 no Dia das Mães.</td></tr></table>

**Atenção com os separadores:** os valores em reais sempre usam **ponto** como separador decimal (ex.: `69.90`, nunca `69,90`) — a vírgula é reservada para separar as colunas da planilha. Ao abrir/salvar no Excel ou LibreOffice, se aparecer uma tela perguntando o "conjunto de caracteres" e o "separador", escolha **Unicode (UTF-8)** e marque só a opção **Vírgula** como separador de colunas (não marque ponto e vírgula).