# Lotes de códigos de cupom

> Crie e gerencie lotes de códigos de cupom que compartilham descontos e configurações, mantendo cada código rastreável separadamente.

Um lote permite atribuir os mesmos descontos e configurações a vários códigos de cupom – por exemplo, códigos de uso único para um parceiro. Os clientes recebem e usam os códigos individuais; o **Nome do lote** fica visível apenas para a sua equipe.

Na lista de cupons, um lote mostra o nome e o número de códigos. O botão de lista ao lado do nome abre os códigos. O menu botão Mais ações contém **Editar**, **Códigos**, **Baixar códigos (CSV)** e **Excluir**. Não é possível duplicar lotes.

## Criar um lote de códigos

1. Na página Cupons, selecione **Novo cupom**.
2. No topo da Etapa 1, **Desconto**, selecione **Lote de códigos** ao lado de **Um código**. Essa opção está disponível apenas para novos cupons. O título do painel é **Novo lote de códigos**.
3. Insira um **Nome do lote**, como `Parceiros bancários`. Esse nome é apenas para sua equipe.
4. Adicione os códigos iniciais usando um dos seguintes métodos:
   - **Gerar**: insira o **Número de códigos** e, opcionalmente, um **Prefixo**, como `BANK-`. Os códigos gerados contêm o prefixo seguido de 8 letras e números aleatórios – por exemplo, `BANK-7KQ2M9XA`. Os caracteres gerados não incluem caracteres parecidos entre si.
   - **Inserir os meus próprios**: insira um código por linha ou separe os códigos por vírgulas. Um código pode conter letras, números, `-` e `_` e ter até 50 caracteres.
5. Conclua as etapas restantes e selecione **Criar lote**.

Um lote usa as mesmas quatro etapas de um [cupom](/organizers/discounts/creating-a-coupon.md). Seus descontos, condições, datas, termos e configuração de combinação de política de preços são compartilhados por todos os códigos do lote.

## Adicionar códigos com segurança

Você pode adicionar até 1.000 códigos por vez. Um lote pode conter qualquer quantidade total de códigos, portanto, adicione mais depois quando necessário.

Quando você salva códigos inseridos, a Entase verifica se cada código ainda não é usado por outro cupom ou lote, nem já está neste lote. Se algum código já estiver em uso, nada será salvo. Você verá: “Outros cupons já usam estes códigos: …”, que lista até 20 códigos. Remova esses códigos e salve novamente.

Os códigos gerados nunca entram em conflito: se um código gerado já estiver em uso, a Entase o substitui automaticamente.

## Definir limites para cada código

Na Etapa 3, os limites se aplicam a **cada código**, não ao lote como um todo:

- **Usos de cada código** tem como padrão 1. Um lote com essa configuração aparece como **Códigos de uso único**.
- **Assentos de cada código** limita quantos assentos esse código individual pode descontar.
- **Uma vez por cliente** significa que um cliente pode usar uma vez um código do lote. O mesmo endereço de e-mail ou número de telefone não pode usar outro código desse lote.

Para saber como esses limites funcionam, incluindo como os usos e assentos são contados, consulte [Limites de cupons: usos, assentos e uma vez por cliente](/organizers/discounts/coupon-limits-uses-seats-and-once-per-customer.md).

## Pausar um lote

Pausar um lote interrompe todos os códigos nele. Os códigos não são aceitos até que você ative o lote novamente.

Você não pode pausar nem alterar códigos individuais. Para interromper um código sem parar o lote, exclua esse código.

## Adicionar e gerenciar códigos depois

Para editar um lote, abra-o e use a área Códigos. Ela mostra `N códigos · X usados` e oferece:

- **Ver códigos** para abrir a lista de códigos do lote.
- **Baixar CSV** para baixar os códigos.
- **Adicionar códigos** para adicionar outro conjunto de códigos gerados ou inseridos.
- **Não adicionar códigos** para cancelar uma adição em andamento.

Depois de salvar os códigos adicionados, você verá: “Alterações em … salvas: N adicionados”. Ao criar um lote, você verá: “Lote … criado com N códigos”.

## Excluir um lote

Selecione **Excluir** no menu botão Mais ações do lote ou **Excluir lote** no painel dele. Isso exclui todos os códigos do lote, incluindo os códigos usados.

Você pode selecionar **Desfazer** por alguns segundos após a exclusão; a confirmação informa “Lote … e seus códigos excluídos”. Os pedidos mantêm seus códigos de desconto.

## Ver e excluir códigos individuais

Selecione **Ver códigos** para abrir a lista de códigos. Você pode:

- Usar **Pesquisar códigos** para encontrar um código.
- Filtrar por **Todos**, **Não usados** ou **Usados**.
- Verificar o uso de cada código: **Não usado**, **Usado uma vez**, **Usado N vezes** ou **Esgotado**.
- Ver quantos assentos cada código descontou.
- Excluir um código individual com botão Excluir. Você pode selecionar **Desfazer** por alguns segundos após a exclusão; a confirmação informa “Código … excluído”.

## Baixar a lista de códigos

Selecione **Baixar CSV** para baixar um arquivo que você pode entregar a um parceiro. O CSV inclui estas colunas:

- Código
- Usos
- Assentos
- Criado
