{"section":"tutorials","requestedLocale":"es","requestedSlug":"lista-de-cupones-beta","locale":"es","slug":"lista-de-cupones-beta","path":"docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta.md","branch":"main","content":"La página __Cupones__ te permite visualizar todos los [cupones](/es/docs/tutorials/cupones-beta)  registrados en tu tienda, gestionar los datos de cada uno y analizar cuántas veces y en qué pedidos se usaron.\n\nDesde esta página puedes:\n\n* Buscar cupones.\n* Exportar cupones.\n* Visualizar datos de uso de los cupones.\n* Filtrar cupones.\n* Visualizar la lista de cupones activos.\n* Acceder a la lista de cupones archivados.\n* Crear cupones.\n* Editar cupones.\n* Archivar cupones.\n\nPara acceder a la página desde el Admin VTEX, haz clic en **Promociones > Cupones**.\n\n![lista-cupons](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_1.png)\n\nLuego, verás la descripción de las acciones y los componentes incluidos en la página.\n\n## Barra superior\n\nLa barra superior de la página **Cupones** presenta una barra de búsqueda, filtros y botones para exportar cupones, ver datos de uso de los cupones y acceder a la lista de cupones archivados. En las secciones a continuación, podrás ver más detalles sobre cada una de estas opciones.\n\n### Buscar cupones\n\nPuedes encontrar cupones específicos usando la barra de búsqueda. Te permite buscar por código de cupón, por [UTM source](/es/docs/tutorials/que-son-utm-source-utm-campaign-y-utm-medium) o por [UTM campaign](/es/docs/tutorials/que-son-utm-source-utm-campaign-y-utm-medium).\n\n### Filtrar cupones\n\nPuedes usar los filtros para visualizar solo los cupones que cumplen con criterios específicos. Para aplicar filtros, sigue los pasos a continuación.\n\n1. En el Admin VTEX, accede a *Promociones > Cupones*, o escribe *Cupones* en la barra de búsqueda en la parte superior de la página.\n2. Haz clic en el filtro que desees usar:\n   * **Última modificación:** indica la fecha de la última vez en que se modificó el cupón.\n   * **Tipo de cupón:** indica si el cupón es sencillo o un lote. Para conocer los distintos tipos de cupones, consulta [Cupones](/es/docs/tutorials/cupones-beta).\n3. Marca la opción deseada.\n4. Haz clic en `Aplicar`.\n5. Repite el proceso si quieres aplicar otro filtro.\n\nPara limpiar los filtros, es decir, para desactivar los filtros aplicados, hay dos opciones:\n\n* Haz clic en <i class=\"fas fa-times\"></i> al lado de un filtro para desactivar un filtro específico.\n* Haz clic en `Limpiar filtros` para desactivar todos los filtros.\n\n### Exportar cupones\n\nPuedes descargar un archivo CSV con tus cupones y la información de cada uno.\n\nPara exportar los cupones, haz clic en el botón <i class=\"fa-solid fa-arrow-down-to-line\"></i> `Exportar`, al lado de la barra de búsqueda. La exportación tiene en cuenta los [filtros](#filtrar-cupones) aplicados en la lista.\n\nEl archivo que se genera contiene la siguiente información:\n\n| Columna | Descripción |\n|---|---|\n| `code` | Código de cupón. En los lotes de cupones, indica el prefijo de los códigos generados. |\n| `type` | Indica si el cupón es sencillo (single) o lote (multiple). Para más detalles sobre cada tipo de cupón, consulta [Cupones](/es/docs/tutorials/cupones-beta). Para saber cómo exportar los códigos que se generaron con un lote de cupones, consulta [Exportar códigos del lote de cupones](#exportar-codigos-del-lote-de-cupones). |\n| `quantity` | Número de códigos del cupón. Para los cupones sencillos, el valor siempre es `1`. Para los lotes de cupones, indica el número de códigos para ese lote. |\n| `archived` | Indica si el cupón está archivado (`true`) o activo (`false`). |\n| `utmSource` | Indica la UTM source asociada al cupón, en caso de que haya. |\n| `utmCampaign` | Indica la UTM campaign asociada al cupón, en caso de que haya.|\n| `maxUsage` | Número máximo de veces en las que se podrá usar el cupón. |\n| `maxItemsPerClient` | Determina la cantidad máxima de productos en los que se podrá aplicar el cupón. La cantidad definida vale para una o más compras del mismo cliente. Esa opción se completa solo en los cupones ya existentes configurados con esta limitación en versiones previas del módulo **Cupones**. |\n| `expirationIntervalPerUse` | Intervalo de tiempo mínimo para reutilizar el cupón. |\n| `lastModified` | Fecha en que el cupón se modificó por última vez. |\n\nA continuación, puedes ver un ejemplo del archivo CSV exportado:\n\n![cupons-exportados](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_2.png)\n\n#### Exportar códigos del lote de cupones\n\nEl archivo CSV exportado solo muestra una línea para el lote de cupones, es decir, no muestra todos los códigos del lote, solo el prefijo.\n\nPara ver o exportar todos los códigos de un lote de cupones, sigue los pasos a continuación:\n\n1. Busca el lote de cupones en la [lista de cupones](#lista-de-cupones).\n2. Haz clic en <i class=\"fas fa-ellipsis-v\"></i> en la línea del lote de cupones para que aparezca un menú con más opciones.\n3. Haz clic en <i class=\"fa-solid fa-arrow-down-to-line\"></i> **Exportar**.\n\n    Verás una pantalla con dos opciones:\n\n    * <i class=\"far fa-clone\"></i> **Copiar todos:** permite copiar los códigos generados a su área de transferencia. También puedes copiar cada código haciendo clic sobre él.\n    * **Exportar:** permite exportar los códigos generados a un archivo CSV. El archivo exportado tiene una columna con un código por línea.\n\n![exportar-cupones](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_3.png)\n\n### Ver uso de cupones\n\nPara ver el total de los cupones activos y el espacio disponible restante para los cupones nuevos, haz clic en <i class=\"fas fa-chart-line\"></i> `Uso de los cupones`.\n\n![uso-de-cupones](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_4.png)\n\nLa cantidad máxima de cupones activos que puedes tener es de 5000. Para liberar espacio, puedes archivar cupones desde la [Lista de cupones](#lista-de-cupones). Si necesitas aumentar el límite de los cupones activos, ponte en contacto con [nuestro Soporte](https://support.vtex.com/hc/pt-br/requests).\n\n### Acceder a cupones archivados\n\nPara acceder a la lista de cupones archivados, sigue los pasos a continuación.\n\n1. En la esquina superior derecha de la página **Cupones**, haz clic en <i class=\"fas fa-ellipsis-v\"></i> `Más`.\n2. Haz clic en <i class=\"fas fa-archive\"></i> `Cupones archivados`.\n\nLa lista de cupones archivados presenta la misma información descrita en la sección [Lista de cupones](#lista-de-cupones), excepto por las opciones disponibles en el menú <i class=\"fas fa-ellipsis-v\"></i> en la línea de cada cupón. Las opciones disponibles para los cupones archivados son:\n\n* <i class=\"fas fa-search\"></i> **Visualizar:** permite ver los detalles del cupón archivado en una versión no editable del [formulario de creación y edición del cupón](/es/docs/tutorials/crear-cupon-beta).\n* <i class=\"fas fa-archive\"></i> **Desarchivar:** permite disponer del cupón para su uso y edición.\n\n## Crear cupón\n\nEl botón `Crear cupón`, en la esquina superior derecha de la página, permite acceder al formulario de creación del nuevo cupón. Para obtener más información sobre este proceso, consulta [Crear cupón](/es/docs/tutorials/crear-cupon-beta).\n\n## Lista de cupones\n\nLa lista de cupones presenta todos los cupones activos en tu tienda, ordenados desde el más reciente. Al hacer clic en un cupón de la lista, serás redireccionado a la página de [edición del cupón](/es/docs/tutorials/crear-cupon-beta).\n\nA continuación, encontrarás más detalles sobre cada columna de la lista:\n\n* **Código:** muestra el código del cupón.\n* **Tipo de cupón:** indica si el cupón es [sencillo o un lote](/es/docs/tutorials/cupones-beta#tipos-de-cupones).\n* **UTM source:** indica la [UTM source](/es/docs/tutorials/que-son-utm-source-utm-campaign-y-utm-medium) asociada al cupón, en caso de que haya alguna.\n* **UTM campaign:** indica la [UTM campaign](/es/docs/tutorials/que-son-utm-source-utm-campaign-y-utm-medium) asociada al cupón, en caso de que haya alguna.\n* **Última edición:** muestra la fecha en que el cupón se modificó por última vez.\n   * **Menú** <i class=\"fas fa-ellipsis-v\"></i>: muestra un menú con más opciones, las cuales se describen a continuación.\n   * <i class=\"fas fa-pencil\"></i> **Editar:** permite acceder al formulario de edición del cupón para visualizar o modificar la información registrada. Consulta [Crear cupón](/es/docs/tutorials/crear-cupon-beta) para más información sobre el formulario. Opción disponible solo para cupones activos.\n   * <i class=\"fas fa-archive\"></i> **Archivar:** permite archivar el cupón, es decir, desactivar su uso en la tienda. Opción disponible solo para cupones activos.\n   * <i class=\"fas fa-download\"></i> **Exportar:** abre una ventana modal con los códigos del lote de cupones desde donde se puede copiar los códigos o exportarlos a un archivo CSV. Opción disponible solo para lotes de cupones.\n   * <i class=\"far fa-signal-alt-3\"></i> **Ver detalles de uso:** abre una ventana modal con información sobre el uso del cupón. Para más información, consulta la sección [Ver detalles de uso](#ver-detalles-de-uso). Opción disponible solo para cupones activos.\n\n### Ver detalles de uso\n\nLa ventana **Ver detalles de uso** muestra los datos de uso de cada cupón, que se describen a continuación.\n\n* **Promociones asociadas:** muestra el nombre de las promociones vinculadas al cupón, en caso de que haya alguna. Al hacer clic sobre el nombre de una promoción, serás redireccionado a la página de edición de la promoción.\n\n    El cupón solo estará disponible cuando esté vinculado a, por lo menos, una promoción. Para establecer dicho vínculo, debes usar la misma [utm_source o utm_campaign](/es/docs/tutorials/que-son-utm-source-utm-campaign-y-utm-medium) que utilizaste en el registro tanto del cupón como de la promoción. Consulta la sección [Asociar el cupón con una promoción](/es/docs/tutorials/crear-cupon-beta#asociar-el-cupon-con-una-promocion) para saber cómo realizar esta configuración.\n\n* **Uso** (cupones sencillos): muestra el número de usos del cupón y el número de usos restantes, en caso de que hayas limitado la cantidad de usos.\n\n    Esta sección muestra la lista de pedidos en que se usó el cupón y permite buscar por número de pedido. Al hacer clic en el número de un pedido, serás redirigido a la página de detalles del pedido en **Gestión de pedidos**.\n\n![ver-detalles-de-uso](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_5.png)\n\n* **Uso general de códigos de cupon** (lotes de cupones): muestra la cantidad total de usos de los códigos de un grupo de cupones y la cantidad de usos restantes, si ha limitado la cantidad de usos.\n\n    Esta sección también muestra la lista de códigos en el lote de cupones y le permite buscar un código específico. Al hacer clic en un código, se accede a la lista de pedidos en los que se ha utilizado el código y se puede buscar por un número de pedido. Al hacer clic en un número de pedido, accederá a la página de detalles del pedido en **Gestión de pedidos**.\n\n![selecciona-el-codigo-lotes-cupones](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/tasas-y-promociones/cupones/lista-de-cupones-beta_6.PNG)\n\n## Más información\n\n* [Cupones](/es/docs/tutorials/cupones-beta)\n* [Crear cupón](/es/docs/tutorials/crear-cupon-beta)"}