Documentation Home »User Guide »Coupons
current version

Coupons

As a promotional tool, coupons can be generated and distributed to customers to be redeemed for a discount when purchasing goods online. In your Oro application, coupons are always linked to promotions, although they can be created separately and linked to a promotion when the need arises.

The following topics will explore how to create, generate and manage coupons in your Oro application.

Before You Begin

As coupons are linked to promotions, make sure that promotions are enabled in your system. For more information on configuration of promotions, see the relevant Configure Promotions topic, or refer to your administrator.

Enabling promotions allows you to perform the following actions with coupons:

  1. See Coupons under Marketing > Promotions > Coupons in the main menu of the management console.
  2. View and add coupons to orders in the management console.
  3. Apply coupons in shopping lists and checkout in the front store.

Coupons can be created manually or generated. Usually, you create coupons manually when you need a small number of them (e.g. 2), or generate coupons when you need many (e.g. 1000).

Create Coupons

To create a new coupon:

  1. Navigate to Marketing > Promotions > Coupons in the main menu.

  2. Click Coupons Actions > Create Coupon on the top right.

    The following page opens:

  3. In the General section, complete the following fields:

    • Owner — Select the business unit responsible for the coupon.
    • Coupon Code — Enter the coupon code. Code value should be numeric, alphabetic or both, and have no spaces. This field is mandatory.
    • Promotion — Select the promotion that the coupon should relate to, or click to load the list of promotions to choose from. Please note that only promotions with the Triggered by option set to Coupons and Conditions will be displayed on the list of available promotions. If there are no promotions to link the coupon to, they can be created and added to the coupon later.
    • Enabled — Enable the check box to activate the coupon. To deactivate it, clear the check box.
    • Uses Per Coupon — Enter the number of times that the coupon may be used.
    • Uses Per Person — Enter the number of times a specific customer can use the coupon.
    • Valid From/Until — Provide the expiration date and time for the coupon.
  4. Click Save.

Generate Coupons

To generate new coupons:

  1. Navigate to Marketing > Promotions > Coupons in the main menu.

  2. Click Coupons Actions > Generate Multiple Coupons on the top right.

    The following form appears:

  3. In the form, complete the following fields:

    • Promotion — Select the promotion that the coupon should relate to, or click to load the list of promotions to choose from. Please note that only promotions with the Triggered by option set to Coupons and Conditions will be displayed on the list of available promotions.
    • Enabled — Enable the check box to activate the coupons.
    • Uses Per Coupon — Enter the number of times that the coupon may be used.
    • Uses Per Person — Enter the number of times a specific customer can use the coupon.
    • Valid From/Until — Provide the expiration date and time for the coupon.
    • Owner — Select the business unit responsible for the coupon.
    • Coupon Quantity — Specify the quantity of coupons to be automatically generated.
    • Code Length — Enter the number that represents the desired length of the coupon code.
    • Code Type — Select the coupon code type from the list (numeric, alphanumeric or alphabetic).
    • Code Prefix — Enter the prefix for the coupon code. If provided, each code will start from this prefix.
    • Code Suffix — Enter the suffix for the coupon code. If provided, each code will finish with this suffix.
    • Add Dashes Every…Symbols — Provide the number to indicate where a dash should be placed in the coupon code (e.g. after each 2 symbols: xx-xx-xx).
    • Code Preview — Preview the sample of the code to be generated for the coupon.

    Note

    Please note that coupon codes must not be longer than 255 symbols, including prefix, suffix, and dashes.

  4. Click Generate.

    The coupons list should now have the coupon codes you have just generated.

Manage a Coupons List

View Coupons

To view all coupons, navigate to Marketing > Promotions > Coupons in the main menu.

The following page opens:

The page contains the list of all available coupons in your Oro application. From here, you can perform the following actions:

  1. Create a new coupon: Click Coupons Actions > Create Promotion on the top right.

  2. Generate coupons: Click Coupons Actions > Generate Multiple Coupons on the top right.

  3. Export coupons: Click Export on the top right.

  4. Import coupons: Click Import on the top right.

  5. View coupon details: Click on the item from the list to open its details page.

    OR

    Alternatively: Click the icon to the right of the item to open its details page.

Filter a Coupons List

You can use filters on the coupons list page to find the required records quicker:

  1. Filters are hidden by default. To show filters, click above the table on the far right.

  2. To apply a filter, click on its button in the bar, and specify your query in the control that appears.

    Note

    Filter controls might look different depending on the type of data you are going to filter, e.g. textual, numeric, a date or an option set.

Organize a Coupons List

  1. To define which columns to show in the table, click above the table on the far right:

    • To choose the columns to be displayed in the table, select the check box next to the required column under Show. Clear the check box to make the column disappear from the table.
    • To change the order of the columns, click next to the name of the column you wish to move, hold the mouse button and drag the column to the required position.
  2. To refresh the coupon list, click .

  3. To reset the coupon list, click to clear list customization and return to default settings. Reset applies to all filters, records per page and sorting changes that you have made.

Manage Coupons

By clicking the More Options menu at the end of the corresponding coupon row, you can find the following options:

  1. View coupon details: Click to the right of the item to view its details.
  2. Edit coupon details: Click the to the right of the item to start editing its details.
  3. Delete a coupon: Click to remove a promotion from the system.

To edit or delete several coupons at the same time:

  1. Select the check boxes on the left of the corresponding rows. The selected coupons will be highlighted in yellow.

  2. Click on the far right of table header.

  3. Click Edit to edit, or Delete to delete the selected coupons.

Manage Coupons in Orders

In your Oro application, you can manage coupons from the page of the selected order. Specifically, you can:

  1. View the coupon applied to the order under Promotions and Discounts of the order page.
  2. Add a coupon to the order manually.

View Coupon Codes

To view the coupon codes that apply to the selected order:

  1. Navigate to Sales > Orders in the main menu.

  2. Click once to open the required order to open it.

  3. Click Promotions and Discounts to open the section.

  4. Under All Promotions on the left of the section, click at the end of the coupon code row.

  5. In the popup that opens, you can view the details of the selected coupon, as illustrated below.

Add Coupons Through the Order Page

To add a coupon code to the required order from its page:

  1. Navigate to Sales > Orders in the main menu.

  2. Click once to open the required order to open it.

  3. On the order page, click Add Coupon Code on the top right.

  4. In the popup that opens, choose a coupon code from the list:

    Alternatively, click to load the list of all available coupons:

  5. Click Add to add the selected coupon code.

  6. Click Apply to apply the coupon code.

    Note

    Please keep in mind that you cannot apply two coupon codes to one order if they are related to the same promotion.

  7. The applied coupon code will be displayed under All Promotions in the Promotions and Discounts section.

This way you can apply as many coupons to the order as necessary as long as they belong to different promotions.

Manage Coupons When Editing the Order

When editing the selected order, you can perform the following actions with the coupons under All Promotions in the Promotions and Discounts section:

  1. Add a new coupon code — Click Add Coupon Code and follow the steps described in the Add Coupons Through the Order Page page.

  2. View a coupon code — Click .

  3. Deactivate/activate a coupon code — Click /.

    Note

    When you deactivate the coupon code, its status is changed from active to inactive. It is not removed and you can reactivate it when necessary.

  4. Delete a coupon code — Click .

Note

When you add, deactivate or delete coupons when editing orders, the price totals and the shipping cost may change. Please, review the order totals to make sure that the cost is acceptable.

Sample Coupon Generation

As an illustration, let us create a sample promotion and generate 100 coupons for it. These coupons will be redeemed for orders placed by first-time customers. The promotion will offer 50% discount for all orders between 18 and 22 September 2017.

Create a Promotion

As coupons should always be linked to promotions, the first step is to create a new promotion:

  1. Navigate to Marketing > Promotions > Promotions in the main menu.

  2. Click Coupons Actions > Create Promotion on the top right.

  3. In the form that opens, specify the discount details and items, making sure that the Triggered by field is set to Coupons and Conditions.

    The sample promotion is called Summer Sale and the discount options are 50% off all orders

  4. Click Save and Close.

Generate Coupons

Next, we will generate coupons for this promotion:

  1. Navigate to Marketing > Promotions > Coupons in the main menu.

  2. Click Coupons Actions > Generate Multiple Coupons.

  3. In the pop up that opens, specify the details of the coupons, making sure that the Coupon Quantity is set to 100 and the coupons are linked to the newly created promotion (in our case, the Summer Sale promotion).

  4. Click Generate once all the details are provided.

Add Coupons to an Order

Now that the promotion has been created and coupons generated, we can add a coupon to the order that fits the conditions of the discount.

  1. Navigate to Sales > Orders in the main menu.

  2. Select the relevant order and click on it once to open.

  3. Click Add Coupon Code on the top right of the order page.

  4. Select the coupon from the list, click Add and then Apply.

  5. The coupon for 50% off is now applied to the order.

  6. In their front store account, the customer will be able to see the discount applied to their order in the Order History menu.

Export Coupons

You can export the coupon details in the .csv format following the Exporting Bulk Items guide.

Import Coupons

Import File option helps import large bulk of coupon information into the coupons list using the .csv file.

Example of coupon bulk import template

Coupon Code Enabled Uses per Coupon Uses per Person Valid From Promotion Name Owner Name
123 1 1 1 01-12-2018 Discounts Owner Name

To import a bulk of coupons:

  1. In the main menu, navigate to Marketing > Promotions > Coupons. The coupons list opens.

  2. Click Import File on the top right.

  3. In the Import dialog, click Choose File, select the .csv file you prepared, and then click Import File.

  4. Click Export Template to download a sample .csv file with the necessary headers.

  5. Prepare data for import: Based on the downloaded file, create your bulk information in the .csv format. Once your file is ready, click Choose File, select the prepared comma-separated values (.csv) file, and click Import File.

  6. Validate import results: Click Validate to check your import results. If there are any Records with errors, fix them in the .csv file before starting the import.

  7. Launch import: After successful validation, click Import File.

  8. Click Cancel to decline the import.

Important

Interactive status messages inform about the import progress, and once the import is complete, the changes are reflected in the list upon refresh. Additionally, an email message with the import status is delivered to your mailbox.

Follow the on-screen guidance for any additional actions. For example, for the inventory template, select one of the options: a) inventory statuses only or b) detailed inventory levels.

Browse maintained versions:
current1.41.5
ssossossosso