Sales Screen Action Macro Commands : Macros for use in the Sales screen action to execute when the item is sold/validated : Macros for use in the Discount macro for assigned item: fields
 
Macros for use in the Discount macro for assigned item: fields
 
The macros in the following table are designed for use in the SysManager > DCIs > New/Edit > Action tab > Validation section > Template button > Item/Pass Relationships tab > Discount macro for assigned item: field and the SysManager > DCIs > New/Edit > Action tab > Item Type: dropdown > select Create Pass > Action Specifics button > Item Discounts tab > Discount macro for assigned item: field.
 
Function
Sales screen action macro
Description
Modify the number of points on a pass after a validation
CHANGENUMVAL()
 
Used with the above macros to alter the amount of points on the pass if the special macro fired. For more information, see Example of combined macros:.
Special check to prevent point accumulation if a special is applied
CHECKNOSPECIAL()
 
Used with the above CHECKPOINTS macro to prevent a point accumulation if a special has been applied to an item. A message may be sent to the operator by inserting a message between the parentheses, such as CHECKNOSPECIAL(You may not proceed with a special applied to this item).
For more information, see Example of combined macros:.
Automatic discounting based on point values
CHECKPOINTS(pts_txt, min, max, question, macro)
 
The arguments are used as defined in the following table.
Argument
Description
pts_txt
The points1 or points2 field.
min
The minimum number of points necessary on the pass for the macro to fire.
max
The maximum number of points allowed in the program.
question
The prompt the operator receives if the pass has enough points.
macro
The special macro that discounts the qualifying item when validated with the pass.
 
For more information, see Example of combined macros:.
 
EVERYX
 
SPECIAL("40% OFF   ")EVERYX(points1, 6, "This is your 6th purchase - it’s free", SPECIAL("100% OFF  "))
This macro displays a message and executes a Sales screen action macro every X points.
 
 
Example:
The macro applies a 40% discount every time, but the sixth time the item is sold, it’s free.
Set the price of an item without applying a discount when a pass validates and item.
PRICE( 10.00 )
 
This example sets the price of an item to $10 and does not apply any special or calculate a discount amount based on the original price of the item.
Apply a special when a pass is validates an item
SPECIAL("XXXXXXXXXX")
 
Applies the special specified between the quotes (special nickname padded out to ten characters).
Apply a special and define the price when a pass validates an item
SPECIAL("XXXXXXXXXX" , 10.00)
 
Applies the special name to the line and sets the item’s price to the specified amount. This adjusts the amount of the discount accordingly. In this example the special specified between the quotes is applied to the line, but the end price of the item is $10. A $50 item would show a $40 discount, a $100 item would show a $90 discount, etc.
Apply a special and define both a percent discount and a dollar discount when a pass validates an item
SPECIAL("XXXXXXXXXX", 5, 3.00)
 
In this example, special XXXXXXXXXX is applied to the item, a 5% discount and a $3 discount is applied to the item.
 
Example of combined macros:
CHECKNOSPECIAL()CHECKPOINTS(points1, 10, 9999, Do you want your half price ticket?, SPECIAL("50%DISC ")CHANGENUMVAL(-10))
 
When a ticket is validated and is set up with this Sales screen action macro in its validation template, the pass swiped for the ticket may accumulate points as long as no special has been applied to the item (you only get points for paying full price). Once the pass accumulates 10 points (and no more than 9999) the operator is prompted that guest is eligible to receive a half-price ticket. If the guest wants to take his discount ticket, the operator says, “YES” to the question, the ticket has the 50%DISC special applied and 10 points are deducted from the pass. If the guest wants to wait to get their discount later, the operator says, “NO” and the guest accumulates more points on his pass and pays for the full price ticket.