The PurchaseEntryCommand macro commands may be used to perform the purchase-related functions described below.
VendorEntry:
The "PurchaseEntryCommand: VendorEntry" command is used to display the Enter Vendor screen (same as [F8]).
Usage:
PurchaseEntryCommand: VendorEntry
EnterItem:
The "PurchaseEntryCommand: EnterItem" command is used to enter a line item on a Purchase Transaction and includes parameters for the field with which line item is to be entered. This command is preferred over the SendKeys macro for entering line items because it only works when the Purchase Transaction Item Entry screen is displayed and is ignored at all other times. When the macro command "PurchaseEntryCommand: EnterItem" is selected from the list of available macro commands, a list of Inventory fields with which the item is to be entered is displayed. After the item entry field is selected the Inventory Lookup List is displayed from which the desired item can be chosen. Once an item is selected, the macro command will be completed based on the choices made. The Inventory item does not have to be selected from the Lookup List, [Esc] can be pressed to close the Lookup List and then the item's lookup text can be manually entered or its barcode scanned into the Edit Macro screen.
Usage:
PurchaseEntryCommand: EnterItem, Code=
PurchaseEntryCommand: EnterItem, Number=
PurchaseEntryCommand: EnterItem, AltID=
PurchaseEntryCommand: EnterItem, Manufacturer=
PurchaseEntryCommand: EnterItem, Description=
PurchaseEntryCommand: EnterItem, Class=
EnterPayment:
The "PurchaseEntryCommand: EnterPayment" command is used to enter a new payment on a Purchase Transaction. This command is preferred over the SendKeys macro with the Payment's Hotkey because it only works when either the Purchase Transaction Line Item Entry screen or the Complete Purchase Transaction screen are displayed and will be ignored at all other times. When the macro command "PurchaseEntryCommand: EnterPaymentItem" is selected from the list of available macro commands, the list of available Purchase Payment types is displayed. Once a Purchase Payment Type is selected, the macro command will be completed based on the choices made. The Purchase Payment Type does not have to be selected from the Purchase Payments list, [Esc] can be pressed to close the Payments List and then the Payment Number can be manually entered into the Edit Macro screen.
Usage:
PurchaseEntryCommand: EnterPayment, Number=# (where # is the payment number to be used).
ToggleReserved:
The "PurchaseEntryCommand: ToggleReserved" command is used to toggle the Purchase Transaction Type to Reserved Order and back again (same as [Ctrl]+[R]).
Usage:
PurchaseEntryCommand: ToggleReserved
TransactionSearch (available only with Keystroke Advanced licenses):
The "PurchaseEntryCommand: TransactionSearch" commands are used to control the Transaction Search function. Unless otherwise specified, the search settings will be the same as those displayed when the Transaction Search function is selected through the Transaction-Search menu. Any of the search settings can be chan ged using the macro command parameters.
The macro command parameter default settings are:
Note: If more than one parameter is used they must be separated by a comma and a space (", ").
TransactionSearch macro command details:
Confirm Settings:
Normally, when the Transaction Search is called from a macro, the list of search results are displayed immediately (bypassing the Search Parameters screen). This command is used to pause the Transaction Search to display the Search Parameters screen for confirmation or changes.
Note: If this command is not used, pressing [F8] from the Transaction List displays the Search Parameters screen.
Usage:
ConfirmSettings=Yes
Transaction Types:
Values accepted by this command include: The Purchase Transaction Type: Name or "(All)" (for all types). If specifying more than one type, separate each type with a comma but no space (",").
Usage:
TransTypes=(All)
Start Date:
The date from which the Transaction Search begins (how far back to search for transactions). Tip: use date entry text ("-3M" for back 3 months, "-2W" for back 2 weeks) instead of an actual date.
Usage:
StartDate=-3M
End Date:
The date on which the Transaction Search ends. Tip: often left blank but can be set to "-1D" to exclude the current date's transactions.
Usage:
EndDate=-1D
Vendor:
The field normally used to look up Vendors (commonly the same as the field defined by the Vendor Field Entry Parameter). Use "%Current%" to use the currently selected Vendor (defined as the Vendor selected in the Vendor Lookup List or, if no Lookup List is in use, the Vendor from the current transaction).
Usage:
Vendor=%Current%
Transaction Number:
Enter the TransactionNumber (and sub letter if needed). Use "%Current%" to use the currently selected transaction.
Usage:
TransNumber=#
Inventory Item:
The field normally used to enter Inventory items (commonly the same as the field defined by the Line Item Entry Field Parameter). Use "%Current%" to use the currently selected Inventory item (defined as the Inventory item selected in the Inventory Lookup List or, if no Lookup List is in use, the current line item on the current transaction).
Usage:
Item=%Current%
Trans Comment:
Search for Transaction Comment searches the Transaction Comments of the Purchase Transactions and displays only those transactions where the Transaction Comment contains the specified text. Use the special value "%EnterText%" to display a screen where the text to be searched for can be entered.
Usage:
TransactionCommentContains=%EnterText%
Comment (Line Item):
Search for Line Item Comment searches the Line Item Comments of the Purchase Transactions and displays only those transactions where at least one line item's comment contains the specified text. Use the special value "%EnterText%" to display a screen where the text to be searched for can be entered.
Usage:
LineCommentContains=%EnterText%
Serial Number:
Search for Serial Number searches the Line Item Comments of the Purchase Transactions and displays only those transactions where at least one line item's comment contains the specified Serial Number. Use the special value "%EnterText%" to display a screen where the Serial Number to be searched for can be entered. The "%EnterText%" special value works the same as it does with the Comment (Line Item) parameter but the Serial Number prefix is automatically added to the text being search for (e.g. "SerialNumber= 123" will search for "S/N: 123").
Usage:
SerialNumber=%EnterText%
Vendor's Invoice Number (available only with Keystroke Advanced licenses):
Search for Vendor's Invoice Number searches the Invoice No. field in the Purchase Transactions and displays only those transactions where the Invoice No. field contains the specified text. Use the special value "%EnterText%" to display a screen where the Invoice Number to be searched for can be entered.
Usage:
VendorsInvoiceNumber=%EnterText%
Max Records Listed:
The maximum number of Purchase Transactions that can be displayed (and searched for). The default setting is 1000.
Usage:
MaxRecords=# (where # is a numeric value)
Display File:
The format of the detail screen that displays the currently highlighted Purchase Transaction is controlled by a display file. The default file is PorSrch.xml (located in the data folder). Use this command to define an alternate or custom display file. The file path may be entered and is relative to the Data folder. If a filename extension is not specified, then ".xml" will be added to the filename.
Usage:
DisplayFile=FILENAME (where FILENAME is the display file name with optional extension and/or path)
Transaction Search Macro Examples:
PurchaseEntryCommand: TransactionSearch, TransTypes=(All), TransNumber=%Current%:
Displays all the Purchase Transactions associated with the current transaction (either the transaction currently displayed on the Purchase Transaction screen or the transaction currently selected on the Purchase Transaction Lookup List).
PurchaseEntryCommand: TransactionSearch, TransTypes=Invoice, Vendor=%Current%, Item=%Current%:
Displays all Purchase Invoices that contain the currently selected Vendor and Inventory Item.
Case/Each: (available only with Keystroke Advanced licenses)
The "PurchaseEntryCommand: CaseEach" command is used to display the Case/Each screen (sames as[Ctrl]+[F7]).
Usage:
PurchaseEntryCommand: CaseEach
SortLineItems (available only with Keystroke Advanced licenses):
The "PurchaseEntryCommand: SortLineItems" command is used to sort the Transaction Line Items by a wide variety of fields including Department, Category, Location, TaxCode,
etc.
Usage:
PurchaseEntryCommand: SortLineItems, Field=Dep
EditMSAllotments:
The "PurchaseEntryCommand: EditMSAllotments" command is used to display the MultiStore Allotment screen for MultiStore Purchase Orders (same as [Ctrl]+[F9]).
Usage:
PurchaseEntryCommand: EditMSAllotments
EditMSOrderRestrictions:
The "PurchaseEntryCommand: EditMSOrderRestrictions" command is used to display the MultiStore Order Restrictions screen for MultiStore Purchase Orders (same as [Ctrl]+[Shift]+[F9]).
Usage:
PurchaseEntryCommand: EditMSOrderRestrictions
SetMSOrderRestrictions:
The "PurchaseEntryCommand: SetMSOrderRestrictions" command is used to set the MultiStore Order Restrictions GroupMask for MultiStore Purchase Orders.
Usage:
PurchaseEntryCommand: SetMSOrderRestrictions, GroupMask=
PriceCheck:
The "PurchaseEntryCommand: PriceCheck" command is used to display the Price Check screen which is used to enter/scan/look up an Inventory item in order to view its
current price.
Note: the PriceCheck function does not alter the transaction in any way.
Usage:
PurchaseEntryCommand: PriceCheck