> 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).
# Upload em massa de códigos promocionais
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 dos seus códigos promocionais.
Consulte a *Referência de upload em massa de códigos promocionais* das tabelas abaixo para ajudar a estruturar este 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 é baseada estritamente no tamanho do arquivo, portanto não há 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 de colunas abaixo (sensível a maiúsculas/minúsculas e espaços), caso contrário o upload do 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,ALWAYS,LI,
```
{% endhint %}
#### Upload em massa de códigos promocionais de rastreamento
1. No menu de navegação à esquerda, selecione  **\[Engage]** → **Conteúdo** → **Códigos Promocionais**.
2. Na *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:
ALWAYS
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 | Permite agendar esta restrição. Esta é uma [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) Data. Exemplo de formato: `2013-06-30T00:00:00-07:00` |
| Data de fim de vigência | Data | Não | Esta é uma data ISO8601. Exemplo de formato: `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 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 rastreamento enviado pode ser atribuído a apenas 1 parceiro ou fonte de mídia por meio do `Id da mídia` campo. Se outro parceiro divulgar esse código, a impact.com marcará a conversão resultante como inválida e a reverterá.
4. Selecione **Próximo**.
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 rastreamento* são criados e listados na *Códigos Promocionais* tela.
#### Upload em massa de campos de códigos promocionais restritos
{% 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**
* Objetivo: 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 que sua lista não autorizada.
* **Lista negra**
* Objetivo: definir uma lista de códigos promocionais que, se usados, não creditarão uma venda a um parceiro.
* Isso é recomendado se sua lista não autorizada de códigos promocionais for menor 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. Na *Códigos Promocionais* na tela, selecione **Criar código promocional**  **\[Menu suspenso]** → **Restrito**.
3. Na *Restrições de códigos promocionais* página, selecione  **Configurar restrições de códigos promocionais**.
4. A página de Restrições de códigos promocionais é 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 | Permite agendar esta restrição. Esta é uma data ISO8601. Exemplo de formato: `2013-06-30T00:00:00-07:00`. |
| Data de fim de vigência | Data | Não | Esta é uma data ISO8601. Exemplo de formato: `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 quiser substituí-lo por um fuso horário específico, digite o nome completo aqui, por exemplo, `America/New_York`. |
2. Selecione **Próximo**.
3. Revise a lista de códigos restritos exibidos na *Upload em massa de códigos promocionais* página.
* Opcionalmente, para ver apenas as entradas que contenham erros, selecione **Mostrar apenas erros**.
4. Se os detalhes estiverem corretos, selecione **Aceitar e criar códigos promocionais**.
**Etapa 3: Adicionar exceções de parceiros de mídia**
1. Na *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 quiser que esta 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 a exceção, selecione **Pesquisa** e então selecione e **Adicionar** os parceiros específicos na 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 escolhido *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.