Skip to main content

UC API - Prompts

Each of the main phases support a number of standard UC prompts which can be reached by raising specific menu events. When these prompts are displayed, they can in turn invoke a specified set of UC function events to trigger various behaviours, or to navigate to the various phases of the POS. It is of course possible for the Retailer to add their own custom events, prompts and functions, and integrate them into the existing extension points - this is not covered in this document however.

The available prompts, which phases they can be called from, the menu event required to trigger them and their supported functions are summarised below. The functions themselves are listed in UC Functions in more detail where appropriate.

Each of these prompts will be supplied the global data described in the Introduction, however in place of the TransactionHandler, they will be provided the Transaction itself.


Order Collection

PropertyValue
DescriptionThis prompt can be used to find an existing order and then add it to the basket for collection.
Supported PhasesSale
Menu Eventenactor.uc.OrderCollection
Prompt URLPos/UnifiedCommerce/Order/OrderCollection

Supported Function Events:

Function NameSummary
enactor.uc.LoadOrderThis function is used to load an order from a remote system. Once the order has been retrieved, the items that form the order will be added to the basket.
enactor.uc.SellProductThis function is used to "sell" a product, adding it to the basket. It is possible to supply a Price and Quantity, which will bypass those prompts should they normally be required by the product.
enactor.uc.UpdateQuantityThis function is used to update the quantity of an existing item in the basket. It is not possible to remove items from the basket (by setting the quantity to zero) using this function.
enactor.uc.VoidItemThis function is used to void an existing item in the basket. It will not be possible to void the transaction using this function, therefore this will not be able to void the last item in the basket.
enactor.uc.VoidTransactionThis function is used to void the basket.
enactor.uc.SetCustomerThis function is used to assign a customer to the basket.
enactor.uc.SetOrderNumberThis function is used to set an order number on the basket.
enactor.uc.AddNoteThis function is used to add a note to the basket.
enactor.uc.UpdateNoteThis function is used to update an existing note in the basket.
enactor.uc.CloseClose the prompt. If the prompt is displayed on the Launch phase, and the Basket now has items, the POS will navigate to the Sale phase.
enactor.uc.TenderClose the prompt and navigate directly to the Tender phase. This will bypass the Sale phase if necessary.

Find Order

PropertyValue
DescriptionThis prompt can be used to find an existing order and then add it to the basket for payment.
Supported PhasesLaunch, Sale
Menu Eventenactor.uc.FindOrder
Prompt URLPos/UnifiedCommerce/Order/FindOrder

Supported Function Events:

Function NameSummary
enactor.uc.SellProductThis function is used to "sell" a product, adding it to the basket. It is possible to supply a Price and Quantity, which will bypass those prompts should they normally be required by the product.
enactor.uc.SetCustomerThis function is used to assign a customer to the basket.
enactor.uc.SetOrderNumberThis function is used to set an order number on the basket.
enactor.uc.CloseClose the prompt. If the prompt is displayed on the Launch phase, and the Basket now has items, the POS will navigate to the Sale phase.
enactor.uc.TenderClose the prompt and navigate directly to the Tender phase. This will bypass the Sale phase if necessary.

Find Customer

PropertyValue
DescriptionThis prompt can be used to find an existing customer and then associate them with the basket.
Supported PhasesLaunch, Sale, Tender
Menu Eventenactor.uc.FindCustomer
Prompt URLPos/UnifiedCommerce/Customer/FindCustomer

Supported Function Events:

Function NameSummary
enactor.uc.SetCustomerThis function is used to assign a customer to the basket.
enactor.uc.CaptureCustomerTriggers the default Enactor Customer Capture process.
enactor.uc.CloseClose the prompt, re-displaying the main prompt for this phase.

Find Product

PropertyValue
DescriptionThis prompt can be used to find an existing product.
Supported PhasesSign On, Launch, Sale
Menu Eventenactor.uc.FindProduct
Prompt URLPos/UnifiedCommerce/Product/FindProduct

Supported Function Events:

Function NameSummary
enactor.uc.ProductSearchTriggers the default Enactor Product Search process.
enactor.uc.SellProductThis function is used to "sell" a product, adding it to the basket. It is possible to supply a Price and Quantity, which will bypass those prompts should they normally be required by the product. This function cannot be called from the Sign On phase.
enactor.uc.CloseClose the prompt, re-displaying the main prompt for this phase. If this is the Launch phase and the basket now has items, the POS will automatically navigate to the Sale phase.

Update Delivery Option

PropertyValue
DescriptionThis prompt can be used to update delivery options on an existing item in the basket.
Supported PhasesSale
Menu Eventenactor.uc.UpdateDeliveryOption
Prompt URLPos/UnifiedCommerce/Order/UpdateDeliveryOption

Supported Function Events:

Function NameSummary
enactor.uc.SetDeliveryOptionForProductSets the delivery option for a given product.
enactor.uc.CloseClose the prompt, re-displaying the sale prompt.
enactor.uc.TenderClose the prompt, navigating to the Tender phase.