Skip to main content
Skip table of contents

Promotions Guide

Complexity

Intermediate

EMS Compatible

(tick)

iMIS 2017 Compatible

(error)

Actions

Insert, Update

image-20241230-142816.png

Overview

This article shares details on how to work with orders.

Mapping

Required Fields

  • GENERAL TAB Promotion Code - The code corresponding to the Promotion.

  • GENERAL TAB Promotion Name - Used for the name of the Promotion.

Optional Fields

  • GENERAL TAB Apply promotion automatically - Option to apply promotion to all orders automatically.

  • GENERAL TAB Discount Percent Offered- How much percent discount offered.

  • GENERAL TAB Promotion Available Begin Date - Start date of promotion.

  • GENERAL TAB Promotion Available End Date - End date of promotion.

  • GENERAL TAB Promotion Kind - Possible promotion types.

  • LIMIT USAGE TAB Maximum Cart Uses Overall - Maximum number of times that this promotion may be applied in the cart across all customers.

  • LIMIT USAGE TAB Maximum Cart Uses per Customer - Maximum number of times that a given customer may apply this promotion in the cart.

  • LIMIT USAGE TAB Minimum Cart Total - Minimum line item total that must be included in the current cart (excluding discounts and additional charges) in order to apply the promotion.

  • LIMIT USAGE TAB Qualified Customers - Specific customers allowed to use promo code.

  • SPECIFIC ITEM DISCOUNT TAB Discount Amount - For ItemCode, discount amount.

  • SPECIFIC ITEM DISCOUNT TAB Discount Type - For ItemCode, discount type (Percent or Dollars).

  • SPECIFIC ITEM DISCOUNT TAB Item Code - ItemCode specifically discounted.

  • SPECIFIC CATEGORY DISCOUNT TAB Category Code - Category Code.

  • SPECIFIC CATEGORY DISCOUNT TAB Discount Amount - For Category Code, discount amount.

  • SPECIFIC CATEGORY DISCOUNT TAB Discount Type - For Category Code, discount type (Percent or Dollars).

  • REQUIRED PURCHASE TAB Item Code - Specific item code required for promo code.

  • REQUIRED PURCHASE TAB Quantity Required to Qualify - Qty from above required to qualify.

  • REQUIRED PURCHASE TAB Which Purchases Qualify? - Same Cart, Same Registrant, Same Customer, Same Org.

  • DISCOUNTED ITEMS TAB Discount Amount - Specific item code for qty discounted amount.

  • DISCOUNTED ITEMS TAB Discount Type - Specific item code for qty discounted (percent or dollar).

  • DISCOUNTED ITEMS TAB Item Code - Specific item code for qty discounted.

  • DISCOUNTED ITEMS TAB Quantity Discounted - Max Qty allowed to be discounted.

Mapping Notes

image-20240930-151215.png
image-20240930-151145.png
image-20240930-151113.png

Adding Item Categories to a Promotion

When using item categories, you need to include the item class code in front of the category code.

How to Access Complete Item Category Codes

Look up the following IQA path: $/Common/Queries/Commerce/ProductClass/Simple

Remove the alias for the Item Class ID field in the Display tab, so you can see the item class code.

image-20250408-150417.png

Run the query to see the complete item category codes. These can be mapped to the Category Code field.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.