KioskForce Vending Machine Operation Manual

Operation Manual of Vending Machine Control System

Certain functions can be executed locally on the vending machine’s control system without requiring backend system involvement. Authorized personnel can access an administrative interface on the machine’s interactive touchscreen by inputting certain pin code via the user interface. The hybrid local-remote functionality model aims to optimize operational flexibility while maintaining appropriate security and connectivity.

Settings on Vending Machines

Enter the Admin Interface

Authorized personnel can gain access to the administration console through the vending machine’s primary user interface. Specifically, entering a predefined activation code such as 9999. After approaching the Pin Verification interface, input the assigned pin code for identity verification.

Upon authenticated entry into the administrative interface, multiple settings and test can be implemented.

code input pin verification vm settings

System Settings

Product Settings

Upon navigating to the product settings sub-section, a complete list of currently stocked items inside the machine is displayed. Relevant data such as product names and pictures are shown for each listing.

The operator is empowered to remove individual products by clicking the Delete key on the right side of the lists.

New products can be added through engagement of the + key located in the top right corner of the menu, requiring input of a product name. Updates to relevant product pictures should be performed via the backend telemetry system. Click Add Product to save.

Selecting a specific listing allows separate modification of product name or removal of product photo.

Note: Any product change will be synchronized to the server. This is a global setting and any change here will affect all the vending machines under the same organization.

product settings add product edit product remove product photo

Selection Settings

The Selection Settings module enables personnel to test dispensing, manage product mappings and couple/decouple motors.

Products can be reallocated to a specific selection code.

Both discounted and original prices for each selection can be modified easily in this section. To cancel the discount, simply click the Reset button, which will restore the original price to 0.

Underperforming selections can be removed from the system by clicking the Delete button on the right side of the listing.

Each Test has controls to simulate the dispensing process for validation or troubleshooting.

New selections can be created by clicking the + button in the top right corner and providing a unique selection code along with choosing the related products to include and setting up the price.

selection settings add selection

Motor Coupling

KioskForce vending machines have innovatively introduced a new feature - motor coupling, which allows operators to manually couple two seperated motors to make them operate in sync.

To couple motors, click on the Couple button and enter the motor number you want to link. To cancel the coupling, click on the Decouple button.

However, pay attention that there are several configuration rules to follow when coupling the motors:

  • The couple code entered must be in the correct format. Normally, the motor code should consist of four digits which represent the machine, the y and x positions respectively.
  • The couple code should not be the same as the pin code for entering the admin interface like 9999.
  • Cross-tray coupling is not allowed. Motors on separate shelves or levels cannot be coupled. In other words, the first three digits of the motor code should be the same.
  • Avoid coupling motors that have already been assigned to an item selection. Any motor that has been assigned to an item selection cannot be coupled.

couple decouple

Vending Machine System Settings

Currency

The currency symbol and name can be set here for appropriate financial display and reporting.

Decimal point

Decimal points can be configured here, with an example shown below as “Amount preview”.

Vending machine name

A unique machine name should be manually entered for clear tracking, monitoring and maintenance of each vending machine.

API key

Enter the valid API key to connect the machine to the backend telemetry system.

APN

Enter the APN code here to realize network communication of the machine.

Pin update

Administrative pin code can be modified here securely for access to the machine control system.

Timezone

Multiple time zones are provided to select according to the geographic location where the machine is located.

Language

Selectable languages accommodate diverse operator teams and customer bases globally.

Default Homepage

Set the default homepage to either the product selection page or the code input page based on requirements.

Instant Purchase (Disable Shopping Cart)

When the shopping cart is enabled, the customer will be able to purchase multiple products at one time. However, if the machine is running with the elevator, the shopping cart function should be disabled to make sure the proper functioning of the drop sensor. Once disabled, the machine will be switched to the Instant Purchase mode, whereby the customer will be directed to the payment interface after selecting their desired product.

Disable Automatic Server Sync

By default, KioskForce vending machines are configured to automatically synchronize data with the backend server. This ensures product pricing, inventory levels, and other modification settings remain up-to-date across all devices. However, to increase flexibility and cater to different requirements, we allow the admin to set whether to enable automatic data synchronization. Once disabled, any modifications made will not automatically sync.

Enable Automatic Refill

By default, the Automatic Refill feature is disabled in KioskForce vending machines. Once enabled, the machine will be automatically marked as Refilled as soon as the admin enters the admin portal. This provides convenience and saves time by eliminating the need to manually click the Refill button on the Maintenance and Diagnosis page.

Enable Two-Digit/Three-Digit/Four-Digit Code Selection

To increase user experience, we provide 2-digit or 3-digit express code selection (only applicable to vending machines without slaves).
Typically, when using 4-digit selection code, the first digit represents the machine number. However, if there are no slave machines attached, the first digit can be ignored. The remaining three digits represent the y, x, and x position, respectively. In the case of vending machines that are smaller than 5-wide (10 selections), the second digit can be disregarded. This allows for a simplified code structure and easier selection process.

four digit three digit two digit

Enable One-Based or Zero-Based Numbering

We allowed express input of x position codes. As for the y position code, you will have the freedom to start it from either one or zero, depending on your preference and specific requirements. For example, under the 2-digit code selection mode, the numbering for the first row and first column can be represented as either 00 or 10.

Slaves Settings

Information of peripheral devices / slaves is shown here, such as IP address, online status, and the last time the slave communicated to the host.

vm system settings

WiFi Settings

Input the correct key to connect the machine to the specific local wireless network.

wifi

Maintenance and Diagnosis

vm maintenance and diagnosis

Mark Vending Machine as Refilled

Trays that are out of stock will automatically be disabled to prevent failed vending until inventory is restocked and the Refill key is clicked.

Upon Refill confirmation, optional remarks can be added.

refill additional info

IP Addresses

IP Address can be checked here.

IP address

Open All the Lockers

This feature allows the admin to open all the cells of the locker slave with one click on the Open All Locker button. Once clicked, the doors will open one by one. 

If the machine is not connected to any locker, the button will be disabled and shown as No Locker Available instead.

open all locker

no locker

Sync Data

When the Automatic Server Sync feature is disabled, the admin can manually initiate an immediate synchronization of all updated data from the machine to the server.

sync data

Restart Vending Machine

Click the Restart button will restart the vending machine. This enables operators to directly restart the machine without having to contact a technician to remotely operate.

Reset Vending Machine Settings

This feature serves the primary purpose of connecting the vending machine to the telemetry backend system. After clicking the Reset Machine Settings button, proceed to input the number of rows and columns of the vending machine. This information enables the system to configure the corresponding selections within the machine. It should be noticed that both the Row and Column fields cannot be left empty or set to 0.

After completing this configuration, please provide the QR code generated to the Vending on Track support team. This will enable us to configure the UUID and API Key in the telemetry backend system on your behalf, ensuring seamless communication between the vending machine and the system.

In the event of a reset, please be aware that the following changes will occur:

  1. All existing products will be cleared.
  2. The default homepage will be set to the code input page as there is no product to display.

reset notice input row and column row and column notice

Factory Mode Test

This section is exclusively designed for distributors or workshops, in which the rotation of all the coils and the opening of all the locker cells can be tested.

Contact us if you require detailed instructions.

factory mode test1 factory mode test2

KioskForce Report

KioskForce Orders

In the VoT telemetry backend system, there is a KioskForce Orders module, which provides visibility into order records across the deployed KioskForce vending machines.

Firstly, designate the target machine(s) or grouping(s) under review.

KioskForce report

Secondly, select a start and end date to define the timeline scope.

Thirdly, click Query to present the report. It can also be exported as CSV or Excel forms by clicking the Download as CSV button at the bottom.

report

There are 5 kinds of order states in total.

  1. Pending Payment: The customer placed an order but has not inserted payment yet.
  2. Succeeded: The customer ordered and paid successfully.
  3. Canceled: The customer actively canceled the order before payment.
  4. Refunded: The selected product failed to dispense after payment, so the money was automatically returned to the customer.
  5. Expired: The customer placed an order but did not insert payment within the timeout period, so the unpaid order was marked expired.

Search Order

Upon confirmed payment processing, the system will generate a unique Receipt ID, linking the transaction record to the associated payment details. Should there appear post-sales issues, the receipt id provides traceability to check the specific order details, items, and payment events.

search order

Vending Machine Groups

The groups are customizable through the Vending Machine Groups section, allowing logical arrangements such as location or owner assignment.

vending machine groups

Operations such as adding, removing, editing groups, and editing screen savers are allowed in this section.

groups operation

To add a new vending machine group, click the Add button, comprehensive group details such as name, description, organization name, organization contact, organization email, and organization introduction are supposed to be included.

add a new group

Vending Machine Screen Saver Settings

Screen Savers facilitate the machine to provide a promotional, informational or interactive content display. To add a screen saver for a vending machine group, go to Vending Machine Groups page, choose a machine group, and click the Screen Savers button to go to the screen savers settings page. On the add screen label page, upload a unique image(.png) or video(.mp4). Then the media type and duration time will automatically change according to the updated file. You can also add a description so that when the customer taps on the machine screen, a QR code will be displayed. Customers can then scan the QR code to view the description.

add screen saver

On the screen savers list page, you can see all the screen savers of this vending machine group. In the Action column, you can edit or remove individual screen savers.

report