Entering Coupon Promotions on an Order
Purpose: Use the Coupon Discount Window to work with coupon promotions that provide dollar or percentage discounts on an order or order detail line. Unlike the discount amounts that you can enter at the Enter Coupon Discount Amount Window, coupon promotions can be restricted to particular source codes, offers, or qualifying items. There are two types of coupons:
• order-level (Coupon type = O): the discount applies to all eligible order detail lines.
• detail-level (Coupon type = D): the discount applies to the selected order detail line only.
You can use the Coupon Discount window to:
If you advance to the window by selecting Coupons for an order line: |
If you advance to the window by selecting Reprice in order entry/maintenance: |
• add an order-level coupon • add a detail-level coupon to the item on the order line • delete an order-level coupon • delete a detail-level coupon that was applied to the item on the order line • review order-level coupons • review detail-level coupons applied to the item on the order line • automatically reprice the order and apply order-level and detail-level coupon discounts if the Automatically Reprice Coupon (K02) system control value is selected See Selecting an Item (Working with Order-Level and Detail-Level Coupons). |
• add an order-level coupon • delete an order-level coupon • review order-level coupons • apply order-level and detail-level coupon discounts to all eligible items |
Restrictions and requirements for displaying this window:
• This window is available only when the Price method for the source code on the order header is set to D (regular plus reprice) and you have created one or more coupons through Working with Coupon Promotions (WCPR).
• In standard order inquiry, you can review coupons but not make any changes.
• You cannot make any changes to the coupons on an order if any of the order detail lines has a printed pick, or is in a closed (X) status.
• The system applies any changes you enter in order maintenance only if you have the Price Tables (E07) system control value at the Pricing Values (B31) screen selected.
For more information: See Working with Coupon Promotions (WCPR) for an overview on how coupon promotions work, and information on how to set up coupon promotions. Also, see Order Repricing, Premiums, Discounts, and Promotions for information on the windows and screens that open in order entry when you select the Reprice option.
In this chapter:
• Selecting an Item (Working with Order-Level and Detail-Level Coupons)
• Selecting Reprice (Working with Order-Level Coupons)
• Understanding Coupon Error Messages in Order Entry
• Understanding Coupon Error Messages through the Order API
How to display this window:
• Select Coupons for an item at the:
- Work with Order Lines Screen (Adding Items to the Order) in order entry (header format) or the Work with Order Lines Screen in order maintenance
- Scan Order Lines Screen in order entry or order maintenance
- Order Inquiry Detail Screen (standard order inquiry)
• Select Reprice at the Work with Order Lines Screen (Adding Items to the Order) if there are any order-level coupon promotions in your company. When you advance to the window by selecting Reprice, it displays only order-level coupons.
The methods of displaying the window in order entry differ in that:
Selecting Coupons for an Item |
Selecting Reprice |
You can enter and review both order-level coupons (which apply to each eligible item on the order) or detail-level coupons (which apply only to the selected item) |
You can enter order-level coupons only |
The system automatically reprices the order and applies coupon discounts at this time only if the Automatically Reprice Coupon (K02) system control value is selected. |
The system applies coupon discounts at this time |
Field |
Description |
Item |
The item on the order detail line that the coupon applies to; displayed only when you advance to the window by selecting Coupons for an item. Alphanumeric, 12 positions; display-only. |
SKU |
The item’s unique characteristics, such as its color or style; displayed only when you advance to the window by selecting Coupons for an item. Alphanumeric, three 4-position fields; display-only. |
Description |
The description of the item or SKU; displayed only when you advance to the window by selecting Coupons for an item. Alphanumeric, 120 positions; display-only. |
Coupon code |
The code that identifies the coupon applied to the order or order detail line. To add a coupon, enter the code here. You can also prompt to display a list of existing coupons in your company, and select a coupon from the list. Alphanumeric, 6 positions; optional. |
Coupon description |
The description of the coupon, truncated from 45 positions. Alphanumeric, 30 positions; display-only. |
Ord Det (Order or Detail level coupon) |
Indicates whether this is an order-level or detail-level coupon. Valid values are: • O = applies to all applicable items on the order • D = applies only to a specific item on the order Display-only. |
Discount Type (Unlabeled field after Ord Det) |
Indicates the type of the discount for the coupon; the amount of each discount displays in the Discount field: • D = Coupon applies the dollar discount indicated in the Discount field; if this is an order-level coupon, the total dollar discount applies to the eligible order detail line with the highest unit price; if this is a detail-level coupon, the total dollar discount applies to this order line. The total discount amount is prorated against the quantity of the order line. • % = Coupon applies the percentage discount indicated in the Discount field to the eligible items on the order (order-level coupons) or the order detail line (detail-level coupons) Alphanumeric, 1 position; display-only. |
Discount |
Indicates the amount of the discount. • If the Discount type is D, this is the dollar discount for the coupon; if this is an order-level coupon, the total dollar discount applies to the eligible order detail line with the highest unit price; if this is a detail-level coupon, the total dollar discount applies to this order line. The total discount amount is prorated against the quantity of the order line. • If the Discount type is %, this is the percentage discount for the coupon to apply to the eligible items on the order (order-level coupons) or the order detail line (detail-level coupons) Numeric, 7 positions with a 2-place decimal; display-only. |
Disc seq # |
Indicates the sequence in which to apply this coupon compared with other coupons for the same order or detail line. Coupons with lower sequence numbers apply first. The system uses all of the following information when determining the sequence in which to apply coupons: • Detail-level coupons always apply before order-level coupons. • Next, the system checks this sequence number. The coupon with the lower sequence number applies first. • Finally, if two coupons have the same sequence number, the first coupon alphanumerically, based on the coupon code, applies first. Numeric, 5 positions; required. |
Selecting an Item (Working with Order-Level and Detail-Level Coupons)
When you display the window by selecting Coupons for an item, you can review or work with order-level and detail-level coupons. See Selecting Reprice (Working with Order-Level Coupons) for an alternate method of displaying the window.
To apply a coupon to the order or order detail line: Enter the coupon code. You can also prompt to display a list of existing coupons in your company, and select a coupon from the list. When you add a coupon:
• If you enter a detail-level coupon, it applies to that order detail line only.
• If you enter an order-level coupon, it applies to any eligible line on the order.
See How an Order or Item Qualifies for a Coupon.
If the order or detail line does not qualify for the selected coupon, or if there is any other problem, the system displays an error message; see Understanding Coupon Error Messages in Order Entry for more information. Otherwise, the coupon is added to the detail line or all eligible detail lines, as appropriate, and displayed in the window.
Reviewing coupons: When you use this method to display the window, it includes:
• all order-level coupons applied to the order
• all detail-level coupons applied to this order detail line
Deleting a coupon: Select Delete for a coupon to delete it from the order or detail line.
Note: You cannot add or delete a coupon at this window if any item on the order has a printed pick slip or is in closed (X) status.
Click Accept or Exit to confirm your entries when you are done.
Canceling an item: Order-level dollar discount coupons apply the total dollar discount to the item on the order with the highest single-unit offer price. If you cancel this item, the system moves the discount to the item with the next highest single-unit price if the order is still eligible for the coupon.
When are the discounts applied? The setting of the Automatically Reprice Coupon (K02) system control value controls when the system applies the discounts to the order.
• If selected, the system applies order-level and detail-level coupon discounts and validates the order dollar minimum when you select Accept or Exit at the Coupon Discount Window, select Reprice, and when you accept the order.
• If unselected, the system applies order-level and detail-level coupon discounts and validates the order dollar minimum when you select Reprice and when you accept the order.
For more information: See Working with Coupon Promotions (WCPR) for an overview on how coupon discounts work, including examples and setup instructions.
Selecting Reprice (Working with Order-Level Coupons)
When you display the window by selecting Reprice at the Work with Order Lines Screen (Adding Items to the Order), you can review or work with order-level coupons only. See Selecting an Item (Working with Order-Level and Detail-Level Coupons) for an alternate method of displaying the window.
Completing this window: You can add, review, or delete order-level coupons; see Selecting an Item (Working with Order-Level and Detail-Level Coupons) for instructions. Click Accept or Exit to confirm your entries when you are done. The system validates that the order meets any order dollar minimum requirement, and applies all eligible coupon discounts, including discounts for detail-level coupons.
To recalculate item prices and order totals:
• If the Automatically Reprice Coupon (K02) system control value is unselected, each time you add or delete a coupon by selecting an item on the order, you will need to select Reprice again and then click Accept or Exit at the window to see the effect of your entries.
• If the Automatically Reprice Coupon (K02) system control value is selected, each time you add or delete a coupon by selecting an item on the order and select Accept or Exit at the Coupon Discount window, the system automatically recalculates the item prices and order totals.
For more information:
• See Working with Coupon Promotions (WCPR) for an overview on how coupon discounts work, including examples and setup instructions.
• See Order Repricing, Premiums, Discounts, and Promotions, particularly the Repricing Screen Flow, for more information on the other windows that may display when you perform repricing.
Understanding Coupon Error Messages in Order Entry
The following error messages are possible during order entry if there is an error related to a coupon you are trying to apply to the order.
Error Message |
Explanation |
% discount not allowed. |
You have tried to apply a detail-level percentage discount to an item that is restricted from percentage discounts, as specified through the Work with Coupon Item Restriction Screen; or, you have tried to apply a percentage discount to an order, and all of the items on the order are restricted. |
At least one item is restricted from this coupon. |
You have applied an order-level percentage discount to an order that includes an item that is restricted from percentage discounts, as set up through the Work with Coupon Item Restriction Screen. This discount will not apply to the restricted item; however, the discount will apply to any other eligible items on the order. |
Coupon cannot be used with existing offer. |
The coupon has an offer restriction (the Offer requirement field is selected), and the offer associated with the source code on the order header is not specified through the Work with Coupon Offer Requirement Screen. You cannot apply the coupon to this order. |
Coupon cannot be used with existing source. |
The coupon has a source code restriction (the Source requirement field is selected), and the source code on the order is not specified through the Work with Coupon Source Requirement Screen. You cannot apply the coupon to this order. |
Coupon code entered is invalid. |
The coupon code you entered is not a valid coupon in your company. Check your spelling, or prompt to display a list of coupons. |
Coupon is not currently active. |
The current date is earlier than the Start date or later than the End date for the coupon. You cannot apply this coupon at this time. |
Coupon item requirement(s) have not been met. |
The coupon has an item requirement (indicated by the Item requirement field), and the item on the order detail line does not match an item specified through the Work with Coupon Item Requirement Screen; or, if this is an order-level coupon with an item requirement, all of the required items are not on the order. • For detail-level coupons: you cannot apply the coupon to this item. • For order-level coupons: you cannot apply the coupon to this order without adding all required items. |
Coupon may not be used with a conflicting coupon. |
The coupon has a restriction against use with another coupon that is on the order (the Coupon restriction field is selected, and there is another coupon on the order that has a coupon restriction for this coupon as specified through the Work with Coupon Restriction Screen). You cannot apply both of these coupons on the same order. |
Coupon may not be used with non-discountable item. |
The item you have selected, or all items on the order, have the Discountable field in the Item table unselected. You cannot apply a coupon against this item (or order, if all items are non-discountable). |
Coupon type must be 'O' or 'D' |
The Coupon type is not set to Order Level or Detail Level. You cannot apply the coupon to an order until this field is set to one of the valid values. |
Detail coupon must be entered for specific item. |
You have displayed the Coupon Discount window by selecting Reprice at the Work with Order Lines Screen (Adding Items to the Order), and then attempted to enter a detail-level coupon. Only order-level coupons are accessible when you display the window this way. You need to display the window by selecting Coupons for an item and applying the coupon to the selected item. |
Detail coupon not allowed - item is sold out. |
You have tried to enter a detail-level coupon against an item that is soldout. |
Duplicate coupon not allowed. |
You have tried to apply the same order-level coupon twice to a single order. |
Item price is less than coupon requirement. |
The coupon has an order detail line total requirement (indicated by the Minimum detail $ amt field), and the regular offer price of the item is less than this minimum. You cannot apply the coupon to this item. |
No coupon maintenance allowed. Order has picks. |
Once you have printed a pick slip for any item you can no longer add or delete coupons for the order. |
No coupon maintenance allowed. Order must have only open lines. |
You cannot add or delete coupons if any item on the order has a status of closed (X). |
Order Detail Coupon already exists. |
You have tried to apply the same detail-level coupon twice on a single order detail line. It is possible to apply a coupon to more than one order detail line on an order if it is a detail-level coupon (the Coupon type is D). Also, the system applies an order-level coupon (the Coupon type is O) automatically to each eligible detail line on the order. |
Order total is less than coupon requirement. |
The coupon has an order total requirement (indicated by the Minimum order $ amt field), and the merchandise total on the order is less than this minimum. You cannot apply the coupon to this order unless you add more merchandise. Non-discountable items (the Discountable field in the Item table is unselected) are not included in the merchandise dollar total for the purposes of meeting this minimum. See How an Order or Item Qualifies for a Coupon. |
Understanding Coupon Error Messages through the Order API
The CWOrderOut response message might include coupon-related errors when the system receives an inbound order message (CWOrderIn) that includes a header-level or detail-level coupon and the response_type specified in the inbound message is E.
If it is possible to correct the error, the correction is indicated below. In all other cases, the customer cannot apply the coupon to the order, and the order remains in error status until you edit it in batch order entry.
Note: The system does not put an order in message if the CWOrderIn message includes the same coupon code twice; instead, it just creates the order and applies the coupon once, assuming that the order qualifies. Also, the system does not put an order in error if the message includes an order-level percentage discount coupon and there are any restricted items on the order as specified through the Work with Coupon Item Restriction Screen, provided that there is at least one unrestricted item.
For more information: See Generic Order Interface (Order API).
Code |
Error |
Explanation |
55 |
Invalid Cpn Code |
The coupon code you entered is not a valid coupon in your company. The customer cannot apply this coupon to an order. |
56 |
Cpn Not Active |
The current date is earlier than the Start date or later than the End date for the coupon. The customer cannot apply this coupon at this time. |
58 |
Offer Restricted |
The coupon has an offer restriction (the Offer requirement field is selected), and the offer associated with the source code on the order header is not specified through the Work with Coupon Offer Requirement Screen. The customer cannot apply the coupon to this order. |
59 |
Invalid Src Requirement |
The coupon has a source code restriction (the Source requirement field is selected), and the source code on the order is not specified through the Work with Coupon Source Requirement Screen. The customer cannot apply the coupon to this order. |
60 |
Cpn Restricted |
The coupon has a restriction against use with another coupon that is on the order (the Coupon restriction field is selected, and there is another coupon on the order that has a coupon restriction for this coupon as specified through the Work with Coupon Restriction Screen). The customer cannot apply both of these coupons on the same order. |
61 |
% discount not allowed |
The customer has tried to apply a detail-level percentage discount to an item that is restricted from percentage discounts, as specified through the Work with Coupon Item Restriction Screen; or, the customer tried to apply a percentage discount to an order, and all of the items on the order are restricted. |
62 |
Order Tot < Cpn Requires |
The coupon has an order total requirement (indicated by the Minimum order $ amt field), and the merchandise total on the order is less than this minimum. The customer cannot apply the coupon to this order without adding more merchandise. Non-discountable items (the Discountable field in the Item table is unselected) are not included in the merchandise dollar total for the purposes of meeting this minimum. See How an Order or Item Qualifies for a Coupon. |
63 |
Cpn Item Required |
The coupon has an item requirement (indicated by the Item requirement field), and the item on the order detail line does not match an item specified through the Work with Coupon Item Requirement Screen; or, if this is an order-level coupon with an item requirement, all of the required items are not on the order. • For detail-level coupons: the customer cannot apply the coupon to this item. • For order-level coupons: the customer cannot apply the coupon to this order without adding all required items. |
64 |
Detail $ < Required |
The coupon has an order detail line total requirement (indicated by the Minimum detail $ amt field), and the regular offer price of the item is less than this minimum. The customer cannot apply the coupon to this item. |
65 |
Non-Disc Item |
The item that the customer selected has the Discountable field in the Item table unselected. The customer cannot apply a coupon against this item. |
77 |
No Discountable Items |
All items on the order have the Discountable field in the Item table unselected. The customer cannot apply a coupon against this order. Note: The response does not return this error if other conditions prevent the coupon from applying to the order (for example, if one item on the order is non-discountable and the other item is sold out). |
78 |
Cpn Not Allowed-Item S/O |
The customer has tried to enter a detail-level coupon against an item that is soldout. |
80 |
Dtl Cpn Passed at Ord Lvl |
The message includes a detail coupon (Type = D) in the coupon_code attribute of the Coupon element, which should be used for header coupons (Type = O). To apply a detail coupon, the message should use the coupon_detail_code attribute of the CouponDetail element. Note: There is no edit against passing an order-level coupon at the detail level; the system still applies the coupon discount to the order if the order qualifies. |
