User manualManual de usuario › Prices and promotions › Promotions › Creating a promotionPrecios y promociones › Promociones › Crear una promoción

Creating a promotion

Crear una promoción

A promotion is a rule that gives a discount when a cart meets a condition. You build it from a template: you choose the kind of rule, fill in its values, compile it and activate it.

Una promoción es una regla que da un descuento cuando un carrito cumple una condición. Se arma a partir de una plantilla: elegís la clase de regla, completás sus valores, la compilás y la activás.

👤 Who: Marketing manager📍 Where: Prices & Promotions → Promotions → New promotion

👤 Quién: Responsable de marketing📍 Dónde: Precios y Promociones → Promociones → Nueva promoción

Choose the template

Elegir la plantilla

The screen opens on Choose a template. Each card is a kind of rule. The names and descriptions of the templates are in English in both languages.

La pantalla abre en Elija una plantilla. Cada tarjeta es una clase de regla. Los nombres y las descripciones de las plantillas están en inglés en los dos idiomas.

Template	What it does	Values it asks for
% off entire order when subtotal ≥ threshold	A percentage off the whole order when the subtotal reaches an amount.	Currency, minimum subtotal, percentage.
% off lines in a given category	A percentage off the lines whose product belongs to a category.	Currency, category code, percentage.
Buy N of trigger SKU/category, get M of gift SKU at discount %	Buying a quantity of a category gives a gift product. The gift is reported in the test under Gifts; it does not change the total of the preview.	Category code, quantity that triggers it, gift product, gift quantity, discount on the gift.
% off for loyalty tier ≥ X (requires account)	A percentage off the order for customers with a loyalty tier. A sale without a customer does not qualify.	Currency, tier, percentage.
SHIELD — suppress all promotions on a currency	While it is in use, no promotion applies to carts in that currency. It is a way of pausing all of them.	Currency.
SHIELD — block apply when cart below minimum subtotal	Marks as blocked a cart whose subtotal is under an amount.	Currency, minimum subtotal.

Plantilla	Qué hace	Valores que pide
% off entire order when subtotal ≥ threshold	Un porcentaje de descuento sobre todo el pedido cuando el subtotal llega a un importe.	Moneda, subtotal mínimo, porcentaje.
% off lines in a given category	Un porcentaje de descuento sobre las líneas cuyo producto pertenece a una categoría.	Moneda, código de categoría, porcentaje.
Buy N of trigger SKU/category, get M of gift SKU at discount %	Comprar cierta cantidad de una categoría da un producto de regalo. El regalo se informa en la prueba, en Regalos; no cambia el total de la vista previa.	Código de categoría, cantidad que lo dispara, producto de regalo, cantidad de regalo, descuento sobre el regalo.
% off for loyalty tier ≥ X (requires account)	Un porcentaje de descuento sobre el pedido para clientes con un nivel de fidelidad. Una venta sin cliente no califica.	Moneda, nivel, porcentaje.
SHIELD — suppress all promotions on a currency	Mientras está en uso, ninguna promoción se aplica a los carritos en esa moneda. Es una forma de pausarlas a todas.	Moneda.
SHIELD — block apply when cart below minimum subtotal	Marca como bloqueado un carrito cuyo subtotal está por debajo de un importe.	Moneda, subtotal mínimo.

Fill in the details

Completar los datos

Click the template. The form opens with three blocks on the left and the generated rule on the right.
Decide whether it is automatic. Leave Apply automatically (no coupon code) ticked for a promotion without a code. Untick it to give it a Code; the code must be unique.
Type the Name and a description.
Choose Type and Scope. They classify the promotion in the lists and the calendar. The discount itself is the one of the template you chose.
Choose Stacking. Stackable lets it add to others; Exclusive makes it the only one. See How promotions combine.
Check Start (ISO) and End (optional). They are typed as text, year first, like the value that comes filled in. The end must be later than the start.
Set the Priority, from 0 to 1000. Among exclusive promotions, the higher number wins.
Fill in Template parameters. Each field shows the technical name of the value and its kind; the line under it explains what to type. They come with example values: replace them with yours.

Tocá la plantilla. Se abre el formulario con tres bloques a la izquierda y la regla generada a la derecha.
Decidí si es automática. Dejá marcado Aplicar automáticamente (sin código de cupón) para una promoción sin código. Desmarcalo para darle un Código; el código tiene que ser único.
Escribí el Nombre y una descripción.
Elegí Tipo y Alcance. Clasifican la promoción en las listas y en el calendario. El descuento en sí es el de la plantilla que elegiste.
Elegí Acumulación. Acumulable deja que se sume a otras; Exclusiva la convierte en la única. Mirá Cómo se combinan las promociones.
Revisá Inicio (ISO) y Fin (opcional). Se escriben como texto, con el año primero, igual que el valor que viene cargado. El fin tiene que ser posterior al inicio.
Poné la Prioridad, de 0 a 1000. Entre promociones exclusivas, gana el número más alto.
Completá Parámetros de la plantilla. Cada campo muestra el nombre técnico del valor y su clase; la línea de abajo explica qué escribir. Vienen con valores de ejemplo: reemplazalos por los tuyos.

⚠️

The code does not hold back the discount. Today none of the templates in the list checks the coupon code: a promotion built from them discounts every cart that meets its condition, with or without the code. The code identifies the promotion and lists it under Coupons.El código no frena el descuento. Hoy ninguna de las plantillas de la lista revisa el código de cupón: una promoción armada con ellas descuenta en todo carrito que cumple su condición, con o sin el código. El código identifica la promoción y la hace figurar en Cupones.

Compile and activate

Compilar y activar

Press Create + compile. The promotion is saved and its rule is checked. From here the details block is locked.
Read the result. Compiled OK with Ready to activate. means the rule is correct. If you then change a parameter, press Re-compile before activating. Compile failed. shows the reason and the screen offers no way to retry: see the note below.
Press Activate. The banner changes to Active. and the promotion takes part in the calculation from that moment.
Test it. See Testing promotions.

Tocá Crear + compilar. La promoción se guarda y se revisa su regla. Desde acá el bloque de datos queda bloqueado.
Leé el resultado. Compilación correcta con Lista para activar. quiere decir que la regla está bien. Si después cambiás un parámetro, tocá Recompilar antes de activar. Error de compilación. muestra el motivo y la pantalla no ofrece forma de reintentar: mirá la nota de abajo.
Tocá Activar. El cartel cambia a Activa. y la promoción participa del cálculo desde ese momento.
Probala. Mirá Probar promociones.

⚠️

Activating is immediate. The promotion starts to count when you press Activate, whatever the start date says. Activate it on the day it has to begin. A promotion can only be tested once it is active: have the test cart ready and check it right away.Activar es inmediato. La promoción empieza a contar cuando tocás Activar, diga lo que diga la fecha de inicio. Activala el día en que tiene que empezar. Una promoción solo se puede probar una vez activa: tené listo el carrito de prueba y revisala enseguida.

ℹ️

Once created, a promotion cannot be edited: name, code, dates and stacking stay as you typed them. If the compilation fails, create the promotion again from New promotion with the right values; if it had a code, use a different one, because the failed draft keeps the first. The button Author raw DRL (Tier-3) is for trained staff who write rules by hand and needs its own permission.Una vez creada, una promoción no se puede editar: el nombre, el código, las fechas y la acumulación quedan como los escribiste. Si la compilación falla, creá la promoción de nuevo desde Nueva promoción con los valores correctos; si tenía código, usá uno distinto, porque el borrador fallido se queda con el primero. El botón Escribir DRL directo (Nivel 3) es para personal capacitado que escribe reglas a mano y necesita su propio permiso.

The markdown launcher

El lanzador de rebajas

Markdown launcher lets you list products with a current and a reduced price and choose dates, but it is not finished: Launch only creates a draft promotion with the code and the name. The products and the prices you typed are not saved and no price is reduced. To lower prices for a period today, use a price list with its dates or a bulk change with a date.

Lanzador de rebajas deja listar productos con un precio actual y uno rebajado y elegir fechas, pero no está terminado: Lanzar solo crea una promoción en borrador con el código y el nombre. Los productos y los precios que escribiste no se guardan y no se rebaja ningún precio. Para bajar precios por un período hoy, usá una lista de precios con sus fechas o un ajuste masivo con fecha.

Common issues

Problemas habituales

The template list is empty: Your role cannot read the templates. Creating promotions needs the marketing manager role.
The Create + compile button stays grey: The name is missing, or the code when the promotion is not automatic, or one of the required parameters, marked with an asterisk.
"Compile failed." with a message about the rule: A parameter has a value of the wrong kind: text where a number goes, or a category code with strange characters. Create the promotion again with the right values.
"Compile failed." right after pressing Create + compile, with a message about the code or the dates: The promotion could not be saved. The usual causes are a code that another promotion already uses, an end date that is not after the start, or a date that is not written like the example. Correct the field and press the button again.
An error appears after pressing Activate: The promotion has no correctly compiled rule, or your role cannot activate. Ask for the permission, or create the promotion again.

La lista de plantillas está vacía: Tu rol no puede leer las plantillas. Para crear promociones hace falta el rol de responsable de marketing.
El botón Crear + compilar queda en gris: Falta el nombre, o el código cuando la promoción no es automática, o alguno de los parámetros obligatorios, marcados con un asterisco.
«Error de compilación.» con un mensaje sobre la regla: Un parámetro tiene un valor de la clase equivocada: texto donde va un número, o un código de categoría con caracteres raros. Creá la promoción de nuevo con los valores correctos.
«Error de compilación.» apenas tocás Crear + compilar, con un mensaje sobre el código o las fechas: La promoción no se pudo guardar. Las causas habituales son un código que ya usa otra promoción, una fecha de fin que no es posterior al inicio, o una fecha que no está escrita como el ejemplo. Corregí el campo y tocá el botón de nuevo.
Aparece un error después de tocar Activar: La promoción no tiene una regla compilada correctamente, o tu rol no puede activar. Pedí el permiso, o creá la promoción de nuevo.