> ## 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.

# importar e exportar promoções por planilha

a planilha de promoções cria promoções, atualiza as que já existem e vincula skus com preço promocional, tudo no mesmo arquivo.

## importar promoções

<Warning>
  importar uma planilha com um código de promoção já cadastrado substitui o nome, a data inicial, a data final e a ativação da promoção pelo que estiver no arquivo. a coluna `ativa` em branco grava não, o que desliga uma promoção que estava ligada.
</Warning>

1. **baixe o modelo de importação**

   em configurações, abra [**promoções**](https://app.teceo.co/settings/promotions) e clique em **modelo de importação**. o arquivo baixa como `teceo_modelo_promocoes.xlsx`.

2. **preencha as colunas**

   cada linha vincula um sku a uma promoção com um preço promocional. as obrigatórias são `código da promoção`, `nome da promoção`, `código do sku`, `tipo de desconto` e `valor`.

   em `tipo de desconto`, escolha como o desconto é escrito:

   * para descontar uma porcentagem sobre o preço de sell-in, escreva percentual (%). em `valor`, escreva a porcentagem, e a plataforma calcula o preço promocional.
   * para gravar o preço final diretamente, escreva valor fixo (R\$). em `valor`, escreva o próprio preço promocional.

   nos dois casos o que fica gravado é o preço promocional do sku, descrito em [o que é uma promoção](/docs/promocoes/o-que-e-uma-promocao).

   `código da tabela de preço` em branco vale para todas as tabelas às quais você tem acesso.

3. **envie a planilha**

   clique em **importar promoção** e escolha o arquivo. o botão está na listagem de promoções e também dentro de uma promoção, na aba de produtos.

a promoção criada pela planilha entra com utiliza tag em não utilizar, porque o arquivo não tem coluna de tag. para definir a tag, abra a promoção pela listagem, como em [criar e gerenciar promoções](/docs/promocoes/criar-e-gerenciar-promocoes).

## as colunas da planilha

a coluna `código da promoção` decide o comportamento da linha: um código que ainda não existe cria uma promoção nova, e um código já cadastrado atualiza a promoção daquele código.

as colunas de produto são informativas: elas identificam o sku no arquivo, e o que for alterado nelas é ignorado.

| coluna | o que preencher | obrigatória |
| - | - | - |
| `código da promoção` | o código da promoção. novo cria a promoção, já cadastrado atualiza a existente | sim |
| `nome da promoção` | o nome da promoção | sim |
| `data inicial` | a data em que a promoção passa a valer | não |
| `data final` | a data em que a promoção deixa de valer | não |
| `ativa` | em branco grava não | não |
| `código do produto` | referência, não editar | não |
| `referência do produto` | referência, não editar | não |
| `código da cor` | referência, não editar | não |
| `tamanho` | referência, não editar | não |
| `nome do produto` | referência, não editar | não |
| `código do sku` | o sku que entra na promoção | sim |
| `código da tabela de preço` | a tabela em que o desconto vale. em branco vale para todas as tabelas às quais você tem acesso | não |
| `preço de sell-in sem desconto` | referência, o preço de sell-in atual do sku | não |
| `tipo de desconto` | percentual (%) ou valor fixo (R\$) | sim |
| `valor` | a porcentagem, com tipo de desconto percentual. o preço promocional, com valor fixo | sim |

## exportar promoções

na listagem, clique em **exportar promoções**. o arquivo `teceo_promocoes.xlsx` sai com os filtros da tela aplicados, e não com a base inteira.

dentro de uma promoção, a exportação traz os produtos daquela promoção.


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