INTERNAL - Bepoz Help Guides

Interfaces | Product, Pricing, Marketing & Promotions

Range Servant

1 | Range Servant Interface Setup

This article explains the Range Servant Interface which allows golf balls to be purchased from a SmartPOS Workstation and then Print a Voucher. The Customer can then scan that Voucher at the Ball Dispenser to receive the golf balls.

This article explains the Range Servant Interface which allows golf balls to be purchased from a SmartPOS Workstation and then Print a Voucher.

The Customer can then scan that Voucher at the Ball Dispenser to receive the golf balls.

About

The Range Servant Interface allows golf balls to be purchased from a SmartPOS Workstation which will Print a Voucher for a Customer
The Customer can then scan that Voucher at the Ball Dispenser to receive the golf balls
To Issue the Voucher/s
- Product/s need to be created & added to the relevant Keymap
- Voucher/s need to be setup & added to corresponding Prize Promotion/s
To Redeem the Voucher/s & dispense the golf balls
- A Transaction Queue Device must be setup in BackOffice to communicate with Range Servant

A Golf Ball Product to Sell will need to be created in BackOffice which will later be added to a Prize Promotion
This Product will then be added to a KeyMap so that the Product can be sold from SmartPOS to Issue a Voucher to a Customer
- Each Size of the Product will relate to the quantity of golf balls to be dispensed
- In this example, there are three (3) Sizes - Small, Medium, and Large - which will each dispense a different Quantity of golf balls

Add Golf Ball Product - Redeem

Next, a Golf Ball Product to Redeem will need to be created in BackOffice to be attached to the Vouchers when they're Redeemed
Copy the Golf Ball Sell Product so that the Size, Names, and Quantities are the same
- Disable the Show in Store flag for all Sizes
- Set all Prices to $0.00
- Set the Normal Mode to Zero Price

Add Product Key to Keymap

After the golf ball Product has been created, it will need to be added to the desired Keymap
Either add a separate Key for each Size, or as in this example, choose Select Size which will prompt the Operator to select a size at the SmartPOS Workstation
The Golf Ball Buckets can now be sold from a SmartPOS Workstation, but will not yet issue a Voucher

Issuing a Voucher

Voucher Setup

To issue Vouchers, they will first need to be Setup and configured
A separate Voucher will need to be setup for each Size of the golf ball Product that will be sold (three in this example)
- Give each Voucher a Name that is relevant to the Size being sold
- The Voucher Type must be set to Auto Product Finalise
- Optionally, set any Filters and/or Schedules that are relevant to your Organisation
  - In this example no filters have been set and the Vouchers are On Permanently
- In the Voucher Details section
  - Set the Qty to Give as 1
  - Select Not Set for the Product Promotion
  - Select the Golf Ball Redeem Product and the Size to correspond to the Voucher
  - Select other desired configuration options such as Start Type, Expiry Type, and Options flags

Promotion Setup

Next, Prize Promotions will need to be created
- Again, a separate Prize Promotion will need to be created for each size that is offered for the Product
Give the Promotions relevant Names and select Product Qty as the Promotion Type
In the Qualifying Criteria section
- Enter the Required Qty as 1
- Enable Qtys can Accumulate
- Select the Golf Ball Sell Product and the size to correspond to the Promotion (i.e. Size Small for Small Ball Bucket Promo)
Optionally, set any Filters and/or Schedules that are relevant to your Organisation
- In this example no filters have been set and the Promotions are On Permanently
In the Prize Details section
- Select Voucher as the Prize Type
- Select the relevant Voucher for the Voucher Name
- Leave the default Prizes to Award as 1
- Optionally, enter any desired Display or Printer Message/s
- Select the Printer for the Voucher to Print from
- Set the Print Format as Voucher Format

The Vouchers will now be issued through these Prize Promotions when the Products are sold

Redeeming a Voucher

Device Setup

For the Vouchers to be Redeemed through Range Servant, a device must first be added to the Till that will be selling the Product and Issuing the Vouchers
Within the Venue & Till List, select the Till/Workstation which will be selling the Product and select Add New Device
Give the Device a relevant name
For Device Type, select Transaction Queue
For External DLL Name, select Stdlibrary.Dll
The Class Name must be set to Range Servant

Device Options

A designated Operator, Store, and Till will need to be created to be used for Range Servant

Ensure that the designated Operator is configured to Issue Vouchers

Add the designated Store & Till in the same Venue as the Store & Till which is selling the Product
For Vouchers 1, 2, & 3 select the Vouchers which were Setup to be issued when the golf ball Product/s are sold
The data is sent over TCP/IP to a pre-agreed port; the Inbound Port should be set to that pre-agreed port

Dispensing Golf Balls

After the Device has been configured, the Issued Vouchers will be able to be Redeemed through the Range Servant Dispenser to dispense golf balls

From the Range Servant Dispenser home screen, tap on Barcode
Use the Barcode Scanner to scan the Barcode of the Voucher
If the Barcode is scanned properly, the Range Servant screen will then display the Barcode and the quantity of golf balls to be dispensed
Follow the on-screen instructions & tap the bucket icon

If one of these Voucher Barcodes is Scanned using a Barcode Scanner attached to a SmartPOS Workstation and the Voucher is applied, the Voucher will be marked as Redeemed and will then show as Not Valid through Range Servant since it has already been claimed