> 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).
# Fazer upload em massa de códigos promocionais
Você pode criar vários códigos promocionais de rastreamento de uma só vez a partir de um arquivo CSV, XLS ou XLSX. Depois de enviar seu arquivo, o impact.com valida cada linha para que você possa revisar e corrigir quaisquer erros antes de criar os códigos promocionais.
Os arquivos podem ter até 5 MB para CSV ou 1 MB para XLS e XLSX. A validação se baseia apenas no tamanho do arquivo, então não há limite para o número de linhas.
## Envie seus códigos promocionais
1. No menu de navegação à esquerda, selecione  **\[Engage]** → **Conteúdo** → [**Códigos promocionais**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. Na *Códigos promocionais* tela, selecione **Upload em massa**.
3. Opcionalmente, selecione **Baixar** para obter um arquivo modelo de exemplo, ou selecione **Ver detalhes do formato** para ver as colunas obrigatórias.
4. Selecione **Escolher arquivo**, depois localize e selecione seu arquivo. Você também pode arrastar e soltar o arquivo na página.
5. Selecione **Continuar**.
6. Revise a *Visualização dos dados* tabela. A *Validação* coluna mostra *Aprovado* para linhas que estão prontas, ou uma mensagem de erro para linhas que precisam de alterações.
* Opcionalmente, para classificar as linhas, selecione um cabeçalho de coluna ou selecione **Ordem de classificação**.
* Para ver todos os erros de uma linha, selecione  **\[Expandir]** ao lado do código promocional. A *Visualização dos erros* lista cada coluna, seu valor e o problema.
* Para corrigir os erros, atualize seu arquivo, selecione **Cancelar** ao lado do nome do arquivo e, em seguida, envie o arquivo corrigido.
7. Selecione **Aceitar e criar códigos promocionais**. A mensagem ao lado do botão mostra o número de códigos promocionais aprovados que o impact.com cria. Se nenhuma linha for aprovada, o botão é desativado.
O impact.com cria os códigos promocionais aprovados e retorna você para a *Códigos promocionais* tela. Somente as linhas aprovadas são criadas. Se ocorrer um erro enquanto o impact.com cria seus códigos promocionais, uma mensagem de erro com um código de erro será exibida. Entre em contato com o suporte e informe esse código.
Para cancelar um upload em massa, selecione  **\[Fechar]** no canto superior direito da tela e, em seguida, selecione **Confirmar**.
{% hint style="success" %}
**Observação:** Códigos promocionais com data de início futura têm um *Pendente* status. A *Códigos promocionais* tela mostra *Códigos promocionais ativos* por padrão, então altere o [*Agendamento de código* filtro](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md) para encontrá-los.
{% endhint %}
## Formate seu arquivo de código promocional
Seu arquivo deve usar exatamente os nomes de coluna abaixo como mostrado, incluindo maiúsculas e pontos, ou o envio será rejeitado.
| Coluna | Tipo | Obrigatório | Descrição |
| ---------------------- | ---------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Operação` | String | Sim | A operação de envio em massa. Valor permitido: `CREATE`. |
| `media.id` | Inteiro | Sim | O ID de mídia do impact.com ao qual o código promocional é atribuído. Pode ser um ID de conta de parceiro ou um ID de origem de mídia.
Cada código promocional de rastreamento pode ser atribuído a apenas 1 parceiro ou origem de mídia. Se outro parceiro promover esse código, o impact.com sinaliza a conversão resultante como inválida e a reverte.
|
| `code` | String | Sim | O código promocional exclusivo. Ele não pode conter colchetes angulares (`<`, `>`) ou aspas duplas. |
| `creditRule` | String | Sim | A regra de crédito do código promocional. Valores permitidos:
ALWAYS (Sempre creditar)
INVOLVED (Creditar se envolvido)
WINNER (Creditar se vencedor)
|
| `matchMode` | String | Sim | O modo de correspondência do código promocional. Valores permitidos:
LI (Exato/Literal)
RE (Regex/Expressão regular)
|
| `deal.id` | Inteiro | Não | O ID do [acordo](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/deals.md) a associar ao código promocional. O acordo já deve existir no seu programa. |
| `scheduling.startDate` | Data | Sim | Quando o código promocional ficar disponível. Insira uma data e hora locais sem deslocamento de fuso horário, no formato `YYYY-MM-DDTHH:mm:ss` (por exemplo, `2026-10-01T00:00:00`). |
| `scheduling.endDate` | Data | Sim | Quando o código promocional expira. Use o mesmo formato que `scheduling.startDate` (por exemplo, `2026-12-31T23:59:59`). |
| `scheduling.timezone` | String | Sim | O fuso horário IANA (Internet Assigned Numbers Authority) para as datas agendadas (por exemplo, `America/New_York`). |
| `emailAddresses` | String CSV | Não | Uma lista de endereços de e-mail separados por vírgulas para notificar sobre este código promocional. |
| `comments` | String | Não | Comentários em texto livre para esta linha. |
Exemplo: esta linha cria o código promocional `10PEROFF` para 1 parceiro, disponível de 1º de outubro a 31 de dezembro de 2026, no horário de Nova York.
```csv
Operation,media.id,code,creditRule,matchMode,deal.id,scheduling.startDate,scheduling.endDate,scheduling.timezone,emailAddresses,comments
CREATE,1299679,10PEROFF,ALWAYS,LI,,2026-10-01T00:00:00,2026-12-31T23:59:59,America/New_York,carrie.oakey@acmecorporation.io,Promoção de fim de ano
```
Referência do erro de validação
| Mensagem de validação | Como corrigi-lo |
| ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| *Valor não reconhecido* | O valor não é um dos valores permitidos, ou uma data usa o formato errado. Verifique a tabela acima. |
| *O valor não pode conter sinais de menor/maior (<, >) ou aspas duplas.* | Remova esses caracteres do código promocional. |
| *O código promocional já existe para este programa.* | Use um código promocional que ainda não esteja no seu programa. |
| *O Parceiro de Mídia \[ID] não está associado à campanha \[ID]* | Use o ID de uma parceria ou fonte de mídia que esteja associada ao seu programa. |
| *Negócio não encontrado* | Use o ID de um negócio existente, ou deixe `deal.id` em branco. |
| *Apenas CREATE é compatível com procedimentos agendados de código promocional.* | Definir `Operação` para `CREATE`. |
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.