> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# criar e gerenciar promoções

o cadastro da promoção começa na aba dados gerais, com o código, o período e a tag, e continua na aba produtos da promoção, onde entram os skus e o preço promocional de cada um. a mesma tela lista, edita e exclui as promoções já criadas.

## criar a promoção

1. **abra o cadastro**

   em configurações, abra [**promoções**](https://app.teceo.co/settings/promotions) e clique em **adicionar promoção**.

2. **identifique a promoção**

   em **dados gerais**, insira o código e o nome da promoção. o código é único por marca, e é por ele que a planilha reencontra a promoção.

3. **defina o período**

   preencha data inicial e data final. com a data final anterior à data inicial, a promoção não é salva, e a plataforma exibe datas de início e fim da promoção são inválidas.

4. **defina a tag**

   em **utiliza tag**, escolha a etiqueta que aparece no produto:

   * para não exibir etiqueta, escolha não utilizar. é a opção que já vem selecionada.
   * para exibir o percentual descontado, escolha percentual.
   * para exibir o valor em reais descontado, escolha desconto.

   a tag tem prioridade sobre as outras tags cadastradas. o desconto em si vem do preço promocional de cada sku, descrito em [o que é uma promoção](/docs/promocoes/o-que-e-uma-promocao).

5. **defina a ativação**

   promoção ativa já vem marcada.

6. **selecione os grupos de usuários**

   quando o campo **grupos de usuários** aparece, ele já vem com o grupo de quem está cadastrando, e aceita outros grupos na seleção.

7. **salve o cadastro**

   a promoção passa a aparecer na listagem, e a aba produtos da promoção fica disponível para receber os skus.

## adicionar produtos e definir o preço promocional

1. **abra a aba produtos da promoção**

   na promoção aberta, clique em **produtos da promoção**.

2. **preencha o bloco adicionar skus promocionais**

   insira o código do produto, selecione as cores e informe o desconto. a inclusão fica disponível depois de preencher os três.

3. **escolha onde o desconto vale**

   * para aplicar o desconto em uma tabela de preço específica, selecione a tabela de preço.
   * para aplicar em todas, deixe o campo vazio. tabela de preço em branco vale para todas as tabelas às quais você tem acesso.

4. **inclua os skus**

   entram todos os skus do produto nas cores escolhidas, uma linha por tabela de preço, com o preço promocional igual ao de atacado. o desconto informado é aplicado na sequência. quando a combinação de produto e cores não encontra nenhum sku, a plataforma avisa e nada é vinculado.

5. **ajuste os preços na tabela**

   nas colunas preço promocional e desconto, edite o valor de cada linha. alterar um recalcula o outro: num sku com preço original de R\$ 100,00, o preço promocional de R\$ 80,00 exibe 20,0% na coluna desconto.

## o que é obrigatório

na aba dados gerais: código, nome da promoção e utiliza tag. data inicial, data final, promoção ativa e grupos de usuários são opcionais.

no bloco adicionar skus promocionais: código do produto, cores e desconto. a tabela de preço é opcional.

## ajustar os preços já vinculados

a coluna preço original traz o preço de atacado do sku naquela tabela de preço. quando ele é zero ou negativo, a coluna desconto fica desabilitada e o ajuste é feito pelo preço promocional.

ao informar um preço promocional maior que o preço de atacado, a plataforma exibe o preço promocional não pode ser maior que o preço atacado, na célula e ao salvar.

para alterar vários skus ao mesmo tempo, marque as linhas e escolha entre **aplicar descontos**, que aceita percentual, e **remover skus**. as duas ações são processadas em segundo plano.

a lista de produtos da promoção tem busca por nome ou código do produto e filtros por código do sku, nome, cor, tamanho, coleção, classificação de produto e tabela de preço.

## outro caminho para vincular produtos

pela tela de skus, marque os skus e use a ação em massa **adicionar à promoção**, com o passo a passo em [skus](/docs/skus/skus). o sku entra na promoção sem desconto, e o preço promocional é acertado na aba produtos da promoção.

para criar promoções e vincular skus com preço em lote, use a planilha, descrita em [importar e exportar promoções por planilha](/docs/promocoes/importar-e-exportar-promocoes).

## encontrar promoções na listagem

a listagem traz as colunas código, nome, utiliza tag, quantidade de produtos, data inicial, data final e ativo. o código não pode ser ocultado. a promoção cadastrada sem etiqueta aparece na coluna utiliza tag como não utiliza.

para encontrar uma promoção, use o campo buscar por nome ou código da promoção. os filtros são código da promoção, status da promoção, tag da promoção, período da promoção e produto.

a coluna ativo é clicável: o clique liga ou desliga a promoção sem abrir o registro.

## editar uma promoção

1. **abra a promoção**

   na listagem, clique sobre a promoção. o formulário é o mesmo do cadastro.

2. **altere e salve**

   ajuste os campos da aba dados gerais e salve.

a lista de grupos de usuários enviada substitui a anterior: o grupo que sai da seleção deixa de constar na promoção.

alterar a data final para uma data já passada encerra a vigência, e é a saída para destravar a exclusão de uma promoção que ainda está no período.

## excluir uma promoção

<Warning>
  a exclusão não tem volta. a confirmação avisa que, ao confirmar, esta ação não poderá ser desfeita.
</Warning>

a exclusão exige duas condições ao mesmo tempo, e não uma delas:

* a promoção não pode estar ativa nem dentro do período vigente. dentro do período vigente significa data inicial preenchida e igual ou anterior a hoje, com data final vazia ou igual ou posterior a hoje. sem isso, a plataforma responde não foi possível remover, a promoção está ativa ou dentro do período vigente.
* a promoção não pode ter sku vinculado. com skus na aba produtos da promoção, a resposta é não foi possível remover, existem skus vinculados à promoção, remova os vínculos para continuar.

para destravar, desmarque promoção ativa, encerre o período pela data final e remova os skus da aba produtos da promoção.

na listagem, marque as promoções e escolha **excluir promoções**, a única ação em massa da tela. a plataforma exibe exclusão em processamento… as promoções que não atendem às duas condições são ignoradas, e a plataforma não informa quais ficaram de fora.

para consultar campos, colunas, valores e limites sem percorrer o passo a passo, acesse [referência de campos da promoção](/docs/promocoes/referencia-de-campos-da-promocao).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.