SARAH

Creating and Configuring Promotions

Step-by-step guide to create and configure promotions in Sarah.

Last updated: 2026-11-17

This guide will teach you how to create and configure promotions in Sarah step by step.

Access to Promotions

  1. Navigate to Promotions in the main menu
  2. Click "New Promotion" or the add button

Basic Fields

Name

A descriptive name to easily identify the promotion.

Examples:

  • "2x1 on Beverages"
  • "20% OFF on Clothing"
  • "Burger Combo"

Barcode (optional)

You can assign a barcode to the promotion and scan it at the POS.

  • For a bundle or promos with product-only targets, scanning loads those products into the cart (each scan adds another full set).
  • If targets are category, brand, or all, the code can still be saved but POS will say it cannot assemble automatically.
  • The code must not match a product barcode or another promo in the same company (the form flags it and blocks save).

Discount code (optional, online store only)

You can turn the promotion into a code that the buyer types in the cart.

  • When a code is set, the promotion stops applying automatically and becomes online-store only: POS never applies it.
  • The buyer enters it in the cart; Sarah validates the code on the server, shows the savings and stores it with the sale.
  • Up to 40 characters: letters, numbers, dot, hyphen or underscore. Case-insensitive.
  • Leave it empty and the promotion works as before (automatic, according to the selected channel).
  • The channel is locked to Online store only while a code is present.
  • If two active promotions share the same code, the one with the highest priority wins.

Promotion Type

Select one of the four available types:

  • Buy X Get Y
  • Discount on Nth
  • Percentage Discount
  • Fixed Price for Combos

Priority

Number that determines the order of application when there are multiple promotions.

  • Higher number = Higher priority
  • If two promotions can apply, the one with higher priority is evaluated first

Recommendation: Use numbers like 10, 20, 30 to leave space between priorities.

Active

Checkbox to enable or disable the promotion without deleting it.

Stackable

If checked, this promotion can be combined with other stackable promotions.

If unchecked, this promotion has exclusive priority and can block other promotions.

Configuration by Type

Buy X Get Y

Required fields:

  • X: Quantity of products customer must buy
  • Y: Quantity of products they get free

Example:

X: 2
Y: 1
Result: Buy 2, get 1 free (2x1)

Discount on Nth

Required fields:

  • N: Product position (2 = second, 3 = third, etc.)
  • Discount: Percentage discount to apply

Example:

N: 3
Discount: 50%
Result: 3rd product has 50% discount

Percentage Discount

Required fields:

  • Percentage: Discount to apply (0-100)

Example:

Percentage: 20
Result: 20% discount on eligible products

Fixed Price for Combos

Required fields:

  • Products: List of combo slots (each with a quantity)
  • Fixed Price: Total combo price

On each slot you can pick one product (fixed) or several (mix and match: any counts toward that quantity).

Example:

Slot 1: Burger × 1
Slot 2: Fries × 1
Slot 3: Drink A or Drink B × 1
Fixed Price: 1500
Result: Completing all 3 slots costs $1500

Target Configuration

Targets define which products the promotion applies to.

Add Targets

  1. Click "Add Target"
  2. Select target type:
    • All: Applies to any product
    • Product: Select a specific product
    • Category: Select a category
    • Brand: Enter brand name

Multiple Targets

You can add multiple targets. The promotion applies if the product matches any of the targets (OR logic).

Example:

  • Target 1: Category "Beverages"
  • Target 2: Brand "Premium"
  • Result: Applies to beverages OR Premium brand products

Validity Dates

Start Date

Date and time when the promotion begins to be active.

If not specified, the promotion is active from its creation.

End Date

Date and time when the promotion stops being active.

If not specified, the promotion doesn't expire.

Sales Channel

Optionally, you can limit the promotion to a specific channel:

  • POS: Only at point of sale
  • Online Store: Only on the web store
  • All: In all channels

Stores

If the company has more than one store, you can limit the promotion to one or more locales (by store number).

  • Empty / all stores: applies at every branch (previous behavior).
  • Selected stores: applies only at the POS for those stores' open shifts. It does not apply in the online shop (the shop is not tied to a store).

Complete Example: 2x1 Beverages Promotion

  1. Name: "2x1 on Beverages - Summer 2025"
  2. Type: Buy X Get Y
  3. Configuration:
    • X: 2
    • Y: 1
  4. Targets:
    • Category: "Beverages"
  5. Priority: 10
  6. Stackable: No (unchecked)
  7. Active: Yes
  8. Dates:
    • Start: 2025-01-01 00:00
    • End: 2025-03-31 23:59
  9. Channel: All
  10. Stores: All (or pick specific branches)

Validation and Saving

Before saving, verify:

  • ✅ All required fields are complete
  • ✅ Numeric values are valid (X > 0, Y >= 0, percentages between 0-100)
  • ✅ At least one target is configured
  • ✅ Start and end dates are coherent

Click "Save" to create the promotion.

Edit Promotions

To edit an existing promotion:

  1. Go to the promotions list
  2. Click the promotion you want to edit
  3. Modify necessary fields
  4. Save changes

Note: Changes apply immediately to new sales.

Delete Promotions

  1. Select the promotion
  2. Click "Delete"
  3. Confirm deletion

Warning: Deleted promotions cannot be recovered.

Next Steps