{"section":"tutorials","requestedLocale":"pt","requestedSlug":"criar-cupom-beta","locale":"pt","slug":"criar-cupom-beta","path":"docs/pt/tutorials/promoções-e-taxas/cupons/criar-cupom-beta.md","branch":"main","content":"Um [cupom](/pt/docs/tutorials/cupons-beta) consiste em um código promocional, composto de uma sequência de letras e números. Você pode disponibilizar cupons para aplicar promoções sobre o valor do carrinho: ao informar o código de um cupom válido no momento da compra, os seus clientes podem obter descontos sobre o valor do pedido.\n\nPara criar um cupom pelo Admin VTEX, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse *Promoções > Cupons*, ou digite *Cupons* na barra de busca no topo da página.\n2. Clique em `Criar cupom`.\n3. Preencha o formulário com as [informações do cupom](#informacoes-do-cupom), a partir da seção [Geral](#geral).\n4. Clique em `Salvar`.\n\nPara ser utilizado, o cupom precisa estar vinculado a pelo menos uma promoção. Leia a seção [Vincular o cupom a uma promoção](#vincular-o-cupom-a-uma-promocao) para saber como fazer essa configuração.\n\nApós salvar, se você tiver criado um [grupo de cupons](/pt/docs/tutorials/cupons-beta#grupos-de-cupons), você verá uma tela com os cupons gerados. Leia a seção [Cupons gerados](#cupons-gerados) para mais informações. Se você tiver criado um [cupom único](/pt/docs/tutorials/cupons-beta#cupons-unicos), você será conduzido diretamente para a [lista de cupons](/pt/docs/tutorials/lista-de-cupons-beta).\n\n## Informações do cupom\n\nO formulário para criar ou editar um cupom apresenta as seguintes seções:\n\n* [Uso do cupom e promoções vinculadas](#uso-do-cupom-e-promocoes-vinculadas)\n* [Geral](#geral)\n* [Restrições](#restricoes)\n\n### Uso do cupom e promoções vinculadas\n\nO painel superior do formulário de criação e edição de cupom, ilustrado abaixo, apresenta a quantidade de vezes em que o cupom foi utilizado e a quantidade de promoções vinculadas ao cupom.\n\n\n\nAo clicar em qualquer uma dessas informações no painel, você tem acesso ao modal **Ver detalhes de uso**, que apresenta os dados 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 a seção [Vincular o cupom a uma promoção](#vincular-o-cupom-a-uma-promocao) para saber como fazer essa configuração.\n\n* **Uso**: exibe a quantidade de usos do cupom e a quantidade de usos restantes, caso você tenha limitado a quantidade de usos.\n\n Caso o cupom seja único, esta seção apresenta a lista de pedidos em que o cupom 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 Caso seja um grupo de cupons, esta seção 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. Clicando 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### Geral\n\nA seção **Geral** apresenta campos que você deve preencher com as informações gerais do seu cupom:\n\n* **Código do cupom:** código que os clientes da sua loja precisarão informar durante o checkout para aplicar o desconto do cupom. Você não pode usar o código de um cupom já existente. Somente letras, números e hífens são permitidos e o código pode ter até 300 caracteres. Este campo é obrigatório.\n* **UTM source:** possibilita atrelar o cupom a determinada `utm_source`. A `utm_source` representa a origem do tráfego, ou seja, de qual site, anunciante ou publicação veio o usuário. Exemplo: você pode definir que sempre que um usuário chegar à sua loja vindo de um clique num anúncio do Facebook, a URL será montada com o parâmetro `utm_source=fb` e o cupom será aplicado. Leia [O que são utm_source, utm_campaign e utm_medium](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) para mais informações.\n* **UTM campaign:** possibilita atrelar o cupom a determinada `utm_campaign`, ou seja, campanha que define um contexto de marketing. Exemplos: `natal`, `diadospais`. Leia [O que são utm_source, utm_campaign e utm_medium](/pt/docs/tutorials/o-que-sao-utm-source-utm-campaign-e-utm-medium) para mais informações.\n* **Gerar cupons em grupo:** ao manter essa opção desativada, você opta por criar um cupom único. Ao ativar essa opção, você cria um [grupo de cupons](/pt/docs/tutorials/cupons-beta#grupos-de-cupons) e visualiza os recursos a seguir. \n * **Número de cupons:** permite definir o número de códigos a serem gerados a partir do prefixo definido em **Código do cupom**. O número máximo é 1000.\n * **Exportar cupons:** botão que permite exportar os códigos do grupo de cupons. Essa opção fica disponível apenas ao editar um grupo de cupons já existente.\n\n> ⚠️ Ao menos uma das UTMs precisa ser definida, ou seja, é obrigatório preencher a **UTM source** ou a **UTM campaign**. Também é possível preencher ambos os campos.\n\n### Restrições\n\nNesta seção do formulário, você pode configurar as seguintes restrições de uso do cupom:\n\n* **Limitar o uso do cupom na minha loja:** ao ativar essa opção, você precisa informar a quantidade de vezes que o cupom poderá ser utilizado, utilizando os botões e ou digitando a quantidade desejada. O número mínimo é 1 e não há um número máximo.\n\n Ao manter essa opção desativada, o cupom pode ser utilizado por uma quantidade ilimitada de vezes.\n\n > ⚠️ Caso ocorra o cancelamento de um pedido com cupom de uso limitado, o limite será recalculado. Isso significa que pedidos com status **Cancelado** não contam no limite de vezes que o cupom poderá ser utilizado.\n\n## Cupons gerados\n\nApós salvar o novo cupom, se você tiver criado um [grupo de cupons](/pt/docs/tutorials/cupons-beta#grupos-de-cupons), você verá a tela __Cupons gerados__. Essa tela disponibiliza duas opções:\n\n* **Copiar tudo:** permite copiar os códigos gerados para a sua área de transferência. Posteriormente, se desejar, você pode colá-los em um editor de planilhas como o Excel ou o Google Sheets. 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### Gerar cupons em massa\nA [criação de cupons](#criar-cupons) para promoções deve ser feita a partir do módulo Promoções e Taxas. No entanto, podem ocorrer casos em que é necessário criar múltiplos cupons de uma vez, devido a alguma campanha ou ação de marketing.\n\nA criação de cupons em massa não pode ser realizada pelo Admin VTEX, apenas pela [Promotions & Taxes API](https://developers.vtex.com/docs/api-reference/promotions-and-taxes-api). Veja como gerar cupons em grandes quantidades seguindo o guia [Criação e gerenciamento de cupons com a API de Promoções](https://developers.vtex.com/docs/guides/creating-and-managing-coupons-with-promotions-api) \n\n## Vincular o cupom a uma promoção\n\nÉ obrigatório vincular um cupom a uma promoção para ativá-lo. Para isso, siga os passos abaixo. É possível associar um cupom a qualquer tipo de promoção, exceto a [Promoção de campanha](/pt/docs/tutorials/promocao-de-campanha).\n\n1. No Admin VTEX, acesse *Promoções > Promoções*, ou digite *Promoções* na barra de busca no topo da página.\n2. Clique na promoção existente em que deseja inserir o cupom ou crie uma promoção clicando no botão `Nova Promoção`.\n3. Se optar por criar uma nova promoção, clique no tipo de promoção que deseja criar.\n4. Na seção **Quais as condições para a promoção ser válida?**, preencha os campos **utm_source** ou **utm_campaign** com os mesmos valores do cupom criado.\n5. Clique em `Salvar` para finalizar.\n\nApós essas configurações, o cupom estará ativo e disponível para uso na sua loja.\n\n## Como usar múltiplos cupons\n\nÉ possível permitir que os clientes da sua loja utilizem mais de um cupom em cada compra. Para ativar essa funcionalidade, você deverá utilizar um dos endpoints a seguir. Essa funcionalidade só está disponível via API e o limite de cupons por compra é de 20 cupons.\n\nAmbos endpoints preenchem o campo `marketingData` do response body, não havendo diferença no uso para ativação. Siga os passos a baixo para ativar a funcionalidade:\n\n1. Utilize um dos endpoint para ativar essa funcionalidade:\n - [POST Add coupons to the cart](https://developers.vtex.com/docs/api-reference/checkout-api#post-/api/checkout/pub/orderForm/-orderFormId-/coupons)\n - [POST Add marketing data](https://developers.vtex.com/docs/api-reference/checkout-api#post-/api/checkout/pub/orderForm/-orderFormId-/attachments/marketingData)\n2. [Customize](https://developers.vtex.com/docs/guides/checkout-customization-guide#customizing-checkout-ui-admin-vtex) o storefront da sua loja para permitir utilizar múltiplos cupons.\n - Se sua loja utiliza a v5 do Checkout, utilize `checkout5-custom.js checkout5-custom.css`.\n - Se sua loja utiliza a v6 do Checkout, utilize `checkout6-custom.js checkout6-custom.css`.\n3. Depois da customização, você deverá solicitar a liberação da funcionalidade através de uma [abertura de chamado no Suporte VTEX](/pt/docs/tutorials/abrir-chamados-para-o-suporte-vtex).\n4. Marque a opção **Permitir acumular promoções** nas [configurações das promoções](/pt/tracks/promocoes--6asfF1vFYiZgTQtOzwJchR/7FjbeZdE2KMwk5L1t98pZI#4-restricoes-e-limitacoes-de-uso) associadas aos cupons para permitir que mais de uma promoção seja ativada pelos múltiplos cupons na mesma compra. Dessa forma, os descontos concedidos pelas diferentes promoções serão [acumulados](/pt/docs/tutorials/como-funciona-a-concorrencia-de-promocoes#acumular).\n\n#### Saiba mais\n\n* [Cupons](/pt/docs/tutorials/cupons-beta)\n* [Lista de Cupons](/pt/docs/tutorials/lista-de-cupons-beta)"}