Auto HotKey

The Auto HotKey, or Auto Code, is a way to add and remove products to/from the shopping cart based on items that are already in the cart, or were previously purchased. This is done using an instruction on the Program Code that you want to automatically add to/remove from the cart. This is not in the normal Instructions field, but in Line2 on the Program Code.  Check the Page Layout for the Program Code Format Code to see what it's actually called on the screen.  

An example would be if you want to add a discount to the cart when selected items are also purchased, and the Program Code for the discount would have the instruction to automatically add it to the cart with the selected items also noted in the instruction. For example

AUTO=TRUE RDHK=BOOK01M~BOOK02M

To set this up, the first instruction is AUTO=TRUE on the Program Code you want automatically added to the cart, making it an Auto HotKey. The subsequent parameters are described below determine where it is applicable. As with all instructions, the parameters are separated by a single space, and their values are not.

• RDHK (optional) = "RequireD HotKey"
  A pattern or list(s) of HotKeys that trigger insert/deletion. The pattern can be as simple as a single HotKey, or a wild card pattern using "%" (for many characters) and "_" (for a single character). For example, 16XYZ would match exactly 16XYZ; 16%XYZ would match 16OU812XYZ and 16XYZ; and 16_YZ would match 16XYZ and 16AYZ, but not 16AXYZ.
  To include more than one HotKey, you can use the “|” (pipe character) as an OR, and the “~” (tilde character) as AND. For example, 16%XYZ|16%ZYX would match 16OU812XYZ or 16ZYX but not 160U812ABC, whereas 16%A~16%B~16%C~16%D means you have to have at least one item that matches 16%A AND another item that matches 16%B AND another item that matches16%C AND another item that matches 16%D.  You may also use these in combination; for example, 16%A|16%x~16%B~16%C~16%D means you have to have at least one item the matches 16%A OR 16%x AND another item that matches 16%B AND another item the matches 16%C AND another item the matches 16%D. NOTE: When using them combination, thoroughly test to make sure it is doing what you want as this logic an be tricky.
  
  The result is if the cart (or sales history) has ANY of these HotKeys the Auto HotKey is added, and if the cart (or sales history) has NONE them the Auto HotKey is removed.
  
  
• CHLD (optional) =NO "Not a child item"  
  For HotKeys that apply to more than one item, or that are pricing for multiple items, this should be set.

• SHP2 (optional) =ONLY "Ship to Contact"
  All logic only applies to items with the same ship to contact (default is same bill to or ship to; implied SHP2=BOTH).  THIS
  CANNOT BE USED WITH TIERED PRICING!! 

• CART (optional) =ONLY "In Cart Only"
  Triggering items must all be in cart, not previously purchased (default is in cart or in sales history; implied CART=BOTH)

• FLDR (optional) = "Folder required"  
  = Affiliation~FieldName~Value
  For example, FLDR=SIG~CODE1~BEST means their most recent SIG folder have CODE1 = 'BEST'  

• CTRY (optional) =xx (xx|xx) "CounTRY"   
  Only applies when the key address is in these countries; this applies to both the Bill To and Ship To Contacts, unless the SHP2 parameter is used.  It is the 2-letter country (i.e. US=United States; CA=Canada) and the “|” (pipe character) can be used as an OR. For example, US|CA means the key address in the United States or Canada.

• EXHK (optional) =   "mutually EXclusive HotKey" 
  Similar patterns as RDHQ, but only the OR “|” is supported  (pipes but not tildes). If any HotKey matching pattern is found then this Auto HotKey is removed. Be careful not to set up a circular logic: If A has EXHK=B and B has EXHK=A then both will be deleted. 

• REMV (optional) = "REMoVe HotKey"             
  Similar to EXHK except EXHK removes the Auto HotKey with the instructions, whereas REMV removes the Program Code that match the HotKey pattern.

[[ko-topic:6478b88a95ddb22b36406ee4]]