> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/promo-codes/bulk-upload-promo-codes.md).
# Carregar códigos promocionais em massa
Se você quiser criar vários códigos promocionais, use o **Upload em massa** recurso para enviar um arquivo CSV, XLS ou XLSX com os dados do seu código promocional.
Consulte a *Referência de upload em massa de códigos promocionais* tabelas abaixo para ajudar na estruturação deste arquivo. Para garantir que o upload seja bem-sucedido, mantenha o tamanho do arquivo abaixo de 1 MB para XLS/XLSX ou 5 MB para CSV. A validação se baseia estritamente no tamanho do arquivo, portanto não há um limite específico para o número de linhas.
{% hint style="warning" %}
**Aviso:** Certifique-se de que os cabeçalhos das colunas no seu arquivo CSV/XLS correspondam exatamente aos nomes das colunas abaixo (sensíveis a maiúsculas/minúsculas e espaços), caso contrário, o upload do seu arquivo poderá ser rejeitado.
{% endhint %}
{% hint style="info" %}
**Exemplo:** O exemplo abaixo é para um código promocional de exemplo `10PEROFF`.
```programlisting
Código promocional,ID da campanha,ID da mídia,Tipo,Regra de crédito,Modo de correspondência,Oferta
Nome10PEROFF,4321,1299679,TRACKING,SEMPRE,LI,
```
{% endhint %}
#### Upload em massa de códigos promocionais de tracking
1. No menu de navegação à esquerda, selecione  **\[Engage]** → **Conteúdo** → **Códigos Promocionais**.
2. No *Códigos Promocionais* na tela, selecione **Upload em massa**.
3. Selecione **Escolher arquivo** e então localize e selecione o arquivo Excel/CSV com os códigos promocionais que você deseja enviar.
Observação: Certifique-se de que seu arquivo use o formato de colunas exigido mostrado na tabela abaixo.
O tipo de código promocional. Valores permitidos:
TRACKING
|
| Regra de crédito | String | Sim | A regra de crédito do código promocional. Valores permitidos:
SEMPRE
ENVOLVIDO
VENCEDOR
|
| Modo de correspondência | String | Sim | O modo de correspondência do código promocional. Valores permitidos:
LI (Exato/Literal)
RE (Regex/Expressão regular)
|
| ID da oferta | Inteiro | Não | O ID exclusivo da oferta à qual este código promocional deve ser associado. A oferta já deve existir no seu programa. |
| Data de início de vigência | Data | Não | Isso oferece a capacidade de agendar essa restrição. Esta é uma [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) data. Formato de exemplo: `2013-06-30T00:00:00-07:00` |
| Data de fim de vigência | Data | Não | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00` |
| Fuso horário | String | Não | O fuso horário é derivado da data de início, mas, se você quiser substituí-lo por um fuso horário específico, digite o nome completo aqui, por exemplo, `America/New_York`. |
Cada código promocional de tracking enviado só pode ser atribuído a 1 parceiro ou origem de mídia por meio do `ID da mídia` campo. Se outro parceiro promover esse código, o impact.com marcará a conversão resultante como uma conversão inválida e a reverterá.
4. Selecione **Avançar**.
5. Revise a lista de códigos promocionais que serão enviados. Se os detalhes estiverem corretos, selecione **Aceitar e criar códigos promocionais**.
6. Se o upload for bem-sucedido, os novos *códigos promocionais de tracking* são criados e listados na *Códigos Promocionais* .
#### Campos restritos para upload em massa de códigos promocionais
{% hint style="info" %}
**Observação:** Como parte das melhorias contínuas da plataforma, estamos descontinuando o *Códigos promocionais restritos* recurso no final de fevereiro. Revise suas configurações atuais e planeje-se adequadamente.
{% endhint %}
Antes de começar, entenda a diferença entre os dois tipos de restrição:
* **Lista branca**
* Finalidade: definir uma lista de códigos promocionais que devem ser usados para que um parceiro receba crédito por uma venda.
* Isso é recomendado se sua lista autorizada de códigos promocionais for menor do que sua lista não autorizada.
* **Lista negra**
* Finalidade: definir uma lista de códigos promocionais que, se usados, não atribuirão crédito por uma venda a um parceiro.
* Isso é recomendado se sua lista não autorizada de códigos promocionais for menor do que sua lista autorizada.
**Etapa 1: escolha o tipo de restrição**
1. No menu de navegação à esquerda, selecione  **\[Engage]** → **Conteúdo** → **Códigos Promocionais**.
2. No *Códigos Promocionais* na tela, selecione **Criar código promocional**  **\[Menu suspenso]** → **Restrito**.
3. No *Restrições de códigos promocionais* na página, selecione  **Configurar restrições de código promocional**.
4. A página de Restrições de Código Promocional é exibida, mostrando duas colunas para configuração:
* Opcionalmente, selecione  **Configurar lista branca**, para enviar códigos promocionais da lista branca.
* Opcionalmente, selecione  **Configurar lista negra**, para enviar códigos promocionais da lista negra.
**Etapa 2: envie seu arquivo**
1. Selecione **Escolher arquivo**, depois localize e selecione o arquivo Excel/CSV com os códigos promocionais restritos que você deseja enviar.
Observação: Certifique-se de que seu arquivo use o formato de colunas exigido mostrado na tabela abaixo.
O tipo de código promocional. Valor permitido:
RESTRITO
|
| Modo de correspondência | String | Sim | O código de correspondência do código promocional. Valores permitidos:
LI (Exato/Literal)
RE (Regex/Expressão regular)
|
| Data de início de vigência | Data | Não | Isso oferece a capacidade de agendar essa restrição. Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`. |
| Data de fim de vigência | Data | Não | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00` |
| Fuso horário | String | Não | O fuso horário é derivado da data de início, mas, se você quiser substituí-lo por um fuso horário específico, digite o nome completo aqui, por exemplo, `America/New_York`. |
2. Selecione **Avançar**.
3. Revise a lista de códigos restritos que são exibidos na *Upload em massa de códigos promocionais* página.
* Opcionalmente, para ver apenas entradas que contenham erros, selecione **Mostrar apenas erros**.
4. Se os detalhes estiverem corretos, selecione **Aceitar e criar códigos promocionais**.
**Etapa 3: adicione exceções de parceiros de mídia**
1. No *Controles de parceiros de mídia* página, escolha como as regras de restrição serão aplicadas:
1. Opcionalmente, selecione **Aplicar a todos os parceiros**, se você quiser que essa regra se aplique a todos.
2. Opcionalmente, selecione **Permitir que determinados parceiros ignorem esta regra e recebam crédito por códigos promocionais restritos**.
Se você escolher permitir uma exceção, selecione **Pesquisa** e então selecione e **Adicionar** os parceiros específicos da lista.
2. Selecione **Salvar e ativar**.
3. A nova regra de código promocional restrito é ativada e os códigos enviados são aplicados ao *Lista branca* ou *Lista negra*.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/promo-codes/bulk-upload-promo-codes.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.