{"section":"tutorials","requestedLocale":"pt","requestedSlug":"lista-de-cupons-beta","locale":"pt","slug":"lista-de-cupons-beta","path":"docs/pt/tutorials/promoções-e-taxas/cupons/lista-de-cupons-beta.md","branch":"main","content":"A página **Cupons** possibilita que você visualize todos os [cupons](/pt/docs/tutorials/cupons-beta) cadastrados na sua loja, gerencie seus respectivos dados e analise quantas vezes e em quais pedidos eles foram utilizados.\n\nA partir desta página, você pode:\n\n* Buscar cupons.\n* Exportar cupons.\n* Visualizar dados de uso dos cupons.\n* Filtrar cupons.\n* Visualizar a lista de cupons ativos.\n* Acessar a lista de cupons arquivados.\n* Criar cupons.\n* Editar cupons.\n* Arquivar cupons.\n\nPara acessá-la no Admin VTEX, clique em **Promoções > Cupons**.\n\n\n\nA seguir, confira a descrição dos componentes e ações incluídos na página.\n\n## Barra superior\n\nA barra superior da página de **Cupons** apresenta uma barra de busca, filtros e botões para exportar cupons, ver dados de uso de cupons e acessar a lista de cupons arquivados. Veja mais detalhes sobre cada uma dessas possibilidades nas seções a seguir.\n\n### Buscar cupons\n\nÉ possível encontrar cupons específicos utilizando a barra de busca. Ela permite buscar pelo código do cupom, pela [UTM source](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) ou pela [UTM campaign](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium).\n\n### Filtrar cupons\n\nVocê pode utilizar os filtros para visualizar apenas os cupons que atendem a critérios específicos. Para aplicar filtros, siga os passos abaixo.\n\n1. No Admin VTEX, acesse *Promoções > Cupons*, ou digite *Cupons* na barra de busca no topo da página.\n2. Clique no filtro que você deseja utilizar:\n * **Última edição:** indica a data da última vez em que o cupom foi alterado.\n * **Tipo de cupom:** indica se o cupom é único ou um grupo de cupons. Para entender os diferentes tipos de cupons, leia [Cupons](/pt/docs/tutorials/cupons-beta).\n3. Marque a opção desejada.\n4. Clique em `Aplicar`.\n5. Repita o processo caso queira aplicar outro filtro.\n\nPara limpar os filtros, ou seja, desativar os filtros aplicados, existem duas opções:\n\n* Clique no ao lado de um filtro para desativar um filtro específico.\n* Clique em `Limpar filtros` para desativar todos os filtros.\n\n### Exportar cupons\n\nVocê pode fazer download de um arquivo CSV com os seus cupons e suas respectivas informações.\n\nPara exportar os cupons, clique no botão `Exportar`, ao lado da barra de busca. A exportação leva em consideração os [filtros](#filtrar-cupons) aplicados na lista.\n\nO arquivo gerado contém as informações descritas a seguir.\n\n| Coluna | Descrição |\n|---|---|\n| `code` | Código do cupom. No caso de grupos de cupons, indica o prefixo dos códigos gerados. |\n| `type` | Indica se o cupom é único (`single`) ou um grupo de cupons (`multiple`). Para mais detalhes sobre cada tipo de cupom, leia [Cupons](/pt/docs/tutorials/cupons-beta). Para saber como exportar os códigos gerados por um grupo de cupons, leia [Exportar códigos de um grupo de cupons](#exportar-codigos-de-um-grupo-de-cupons). |\n| `quantity` | Quantidade de códigos do cupom. Para cupons únicos, o valor é sempre `1`. Para grupos de cupons, indica a quantidade de códigos para aquele cupom grupo. |\n| `archived` | Indica se o cupom está arquivado (`true`) ou ativo (`false`). |\n| `utmSource` | Indica a UTM source associada ao cupom, se houver. |\n| `utmCampaign` | Indica a UTM campaign associada ao cupom, se houver. |\n| `maxUsage` | Quantidade máxima de vezes que o cupom poderá ser utilizado. |\n| `maxItemsPerClient` | Determina a quantidade máxima de produtos em que o cupom poderá ser aplicado. A quantidade definida vale para uma ou mais compras pelo mesmo cliente. Essa opção é preenchida apenas em cupons já existentes configurados com essa limitação em versões anteriores do módulo de Cupons. |\n| `expirationIntervalPerUse` | Intervalo de tempo mínimo para reutilização do cupom. |\n| `lastModified` | Data em que o cupom foi alterado pela última vez. |\n\nVeja um exemplo de arquivo CSV exportado a seguir:\n\n\n\n#### Exportar códigos de um grupo de cupons\n\nO arquivo CSV exportado exibe apenas uma linha para um um grupo de cupons, ou seja, não apresenta todos os códigos do grupo, apenas o prefixo.\n\nPara visualizar ou exportar todos os códigos de um grupo, é necessário seguir os passos abaixo:\n\n1. Encontre o grupo de cupons na [lista de cupons](#lista-de-cupons).\n2. Clique em na linha do grupo de cupons para exibir um menu com mais opções.\n3. Clique em **Exportar**.\n\n Você verá uma tela com duas opções:\n\n * **Copiar tudo:** permite copiar os códigos gerados para a sua área de transferência. Também é possível copiar cada código clicando sobre ele.\n * **Exportar:** permite exportar os códigos gerados para um arquivo CSV. O arquivo exportado contém uma coluna, com um código por linha.\n\n\n\n### Ver uso dos cupons\n\nPara visualizar o total de cupons ativos e a cota de espaço restante para novos cupons, clique em `Uso dos cupons`.\n\n\n\nO número máximo de cupons ativos que você pode ter é 5 mil. Para liberar espaço, você pode arquivar cupons a partir da [Lista de cupons](#lista-de-cupons). Caso precise aumentar o limite de cupons ativos, entre em contato com [nosso Suporte](https://support.vtex.com/hc/pt-br/requests).\n\n### Acessar cupons arquivados\n\nPara acessar a lista de cupons arquivados, siga os passos abaixo.\n\n1. No canto superior direito da página **Cupons**, clique em `Mais`.\n2. Clique em `Cupons arquivados`.\n\nA lista de cupons arquivados apresenta as mesmas informações descritas na seção [Lista de cupons](#lista-de-cupons), com exceção das opções disponíveis no menu na linha de cada cupom. As opções disponíveis para cupons arquivados são:\n\n* **Visualizar:** permite ver os detalhes do cupom arquivado em uma versão não editável do [formulário de criação e edição do cupom](/pt/docs/tutorials/criar-cupom-beta).\n* **Desarquivar:** permite disponibilizar o cupom para uso e edição.\n\n## Criar cupom\n\nO botão `Criar cupom`, no canto superior direito da página, permite acessar o formulário de criação de um novo cupom. Para mais informações sobre esse processo, leia [Criar cupom](/pt/docs/tutorials/criar-cupom-beta).\n\n## Lista de cupons\n\nA lista de cupons apresenta todos os cupons ativos na sua loja, listados a partir do mais recente. Ao clicar em um cupom da lista, você será redirecionado para a página de [edição do cupom](/pt/docs/tutorials/criar-cupom-beta).\n\nConfira a seguir mais detalhes sobre cada coluna da lista:\n\n* **Código:** apresenta o código do cupom.\n* **Tipo de cupom:** indica se o cupom é [único ou um grupo de cupons](/pt/docs/tutorials/cupons-beta).\n* **UTM source:** indica a [UTM source](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) associada ao cupom, se houver.\n* **UTM campaign:** indica a [UTM campaign](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) associada ao cupom, se houver.\n* **Última edição:** apresenta a data em que o cupom foi alterado pela última vez.\n* **Botão** : exibe um menu com mais opções, descritas a seguir.\n * **Editar:** permite acessar o formulário de edição do cupom para visualizar ou alterar as informações cadastradas. Leia [Criar cupom](/pt/docs/tutorials/criar-cupom-beta) para mais detalhes sobre o formulário. Opção disponível apenas para cupons ativos.\n * **Arquivar:** permite arquivar o cupom, ou seja, desativar o seu uso na loja. Opção disponível apenas para cupons ativos.\n * **Exportar:** abre um modal com os códigos do grupo de cupons, onde é possível copiar os códigos ou exportá-los para um arquivo CSV. Opção disponível apenas para grupos de cupons.\n * **Ver detalhes de uso:** abre um modal com informações de uso do cupom. Para mais detalhes, leia a seção [Ver detalhes de uso](#ver-detalhes-de-uso). Opção disponível apenas para cupons ativos.\n\n### Ver detalhes de uso\n\nO modal **Ver detalhes de uso** apresenta os dados de utilização de cada cupom, descritos a seguir:\n\n* **Promoções vinculadas:** exibe o nome das promoções vinculadas ao cupom, se houver alguma. Ao clicar no nome de uma promoção, você será direcionado para a página de edição da promoção.\n\n O cupom só se torna disponível para uso quando está vinculado a pelo menos uma promoção. Para estabelecer esse vínculo, é necessário usar a mesma [utm_source ou utm_campaign](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) no cadastro do cupom e no cadastro da promoção. Leia [Vincular o cupom a uma promoção](/pt/docs/tutorials/criar-cupom-beta#vincular-o-cupom-a-uma-promocao) para saber mais sobre essa configuração.\n\n* **Uso** (cupons únicos): exibe a quantidade de usos do cupom e a quantidade de usos restantes, caso você tenha limitado a quantidade de usos.\n\n Esta seção também apresenta a lista de pedidos em que o código foi utilizado e permite buscar pelo número de um pedido. Ao clicar no número de um pedido, você será conduzido para a página de detalhes do pedido no **Gerenciamento de pedidos**.\n\n\n\n* **Uso geral dos códigos de cupom** (grupos de cupons): exibe a quantidade total de usos dos códigos de um grupo de cupons e a quantidade de usos restantes, caso você tenha limitado a quantidade de usos.\n\n Esta seção também apresenta a lista de códigos do grupo de cupons e permite buscar por um código específico. Ao clicar em um código, você tem acesso à lista de pedidos em que o código foi utilizado e pode buscar pelo número de um pedido. Ao clicar no número de um pedido, você será conduzido para a página de detalhes do pedido no **Gerenciamento de pedidos**.\n\n\n\n## Saiba mais\n\n* [Cupons](/pt/docs/tutorials/cupons-beta)\n* [Criar cupom](/pt/docs/tutorials/criar-cupom-beta)"}