1. Custom discount buttons
2. Inline discount buttons

Custom Discount Buttons

• Custom discount buttons are used for more complex discounts defined in the back office (see Discount Engine Types and Options)
• To create a button that applies a custom discount, change button's Command to Discounting: Perform Custom Discount.
• In the text area below Command, you will need to specify parameters.

• Range: Each (applies to all current line items), All (applies to all current and future line items), CurrentLineItem (only applies to current line item).  
  • Note: Some discount engines will require the Range set to All to function correctly when invoked through a task pad button.
• CustomDiscountId: The internal id of the Custom Discount to apply. The screenshot below shows how to find the internal id when you have the Custom Discount open for editing. This id will never change even if the Custom Discount's code changes.
  
  
• CustomDiscountCode: The code is simply the name of the Custom Discount. This name can be changed which will break the button, so consider using the CustomDiscountId parameter detailed above.
• PromptOnMissingDiscount: true or false. If this is true and the CustomDiscountId and CustomDiscountCode parameters are missing or invalid, the user will be prompted to select the discount to be used.
• ApplySeparately: true or false. By default this is set to false. If this is true, when you apply the discount it will generate a unique ReferenceName(see next bullet point) This means that if it is also set to double dip it will apply the discount multiple times to the same item as it will not overwrite itself.  If you are not double dipping then it will only apply once.
• ReferenceName: Reference name is used to define groups of Discounts.  Discounts with the Same reference name will overwrite one another accepting the last applied discount.  Discounts with Different ReferenceNames defined will apply the better of the two discounts as applicable. You can think of ReferenceName as a group of Discounts that should either replace or stack on top of one another.
  • If Military and Senior discounts have a ReferenceName of ManualDiscounts and double dipping is set to No pressing the Military Discount button and then the Senior Discount button would switch the discount from Military to Senior.
  • If you have a special edge case sale say this week you are giving a 30% discount on specially labeled items and you Don't want to also get other lesser discounts such as Military or Senior.  You would want to have that discount as a different ReferenceName.example: LabelSale  this will allow you to apply the 30% off discount and still apply your discount from the ManualDiscount ReferenceName 
• Comment: Adds the defined comment to the discount.

Inline Discount Buttons

• Inline discount buttons are generally used for quick and simple discounts. Although they have the potential to be used for more complex discounts, it is easier to use custom discounts and custom discount buttons for complex discounts, as shown above.
• To create a button that applies a custom discount, change button's Command to Common: Perform Discount.
• In the text area below Command, you will need to specify parameters.
• The parameters are a comma-separated list of name:value pairs enclosed in curly brackets. For example:
  
  {
CommandType: 'PercentOffSingle',
Amount: '10'
}