Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

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

  1. From the Range Servant Dispenser home screen, tap on Barcode

  2. Use the Barcode Scanner to scan the Barcode of the Voucher

  3. If the Barcode is scanned properly, the Range Servant screen will then display the Barcode and the quantity of golf balls to be dispensed

  4. 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