Assign and edit products in the vending machine
  • 16 Oct 2023
  • 4 Minutes to read

Assign and edit products in the vending machine


Article summary

Products from the product database are assigned virtually to the machine’s slots and shown on the touch screen.

If this assignment (and other maintenance work) is undertaken directly on the vending machine, then it is necessary to open the door. The route driver screen is automatically shown on the monitor after the door has been opened.

Route driver screen

Here, you can view status information and login to the vending machine.

Note

If the route driver screen is not automatically displayed after opening the door, then the RS232 connection to the vending machine might be incorrectly configured.

The route driver screen is only shown on the screen of the vending machine.

Structure


1: Tabs to display the main window

2: Information
Status information on the door, connectivity, box ID and server address are displayed. Click the button REFRESH (5) to refresh this information.

3: Pogomat QR code
The QR code shown allows you to sign in to the Pogomat via an external device. 

4: START VENDING APP
Use this button to manually start the Vending app.

Note
This method should only be used for support purposes. Usually, the Vending app starts after the door has been closed.

5: REFRESH
Refreshes the information on the start screen.

6: TEST CASES
Use the button START TESTS to test if the vending machine and the plugins function correctly.

Pogomat

The internal structure of the vending machine and locker are depicted in the Pogomat. You can assign products from the product database to compartments or slots and edit them here.

The Pogomat is a HTML application that runs on the Grassfish IXM Platform server, which is optimised for tablets and the desktop browsers supported by Grassfish. The application is suitable for portrait or landscape format.

The Pogomat can be started in the following ways:

  • External device: The Pogomat can be opened on an external device e.g. a tablet. To do so, scan the QR code on the route driver screen (see above). Login with the IXM Platform user name.
Note
The external device must have network access to the IXM Platform.
  • Route driver screen (on the vending machine’s screen): Click on Login or the tab POGOMAT. Enter the login information into the IXM Platform or login via the QR code that you generated in the IXM Platform.
  • IXM Platform: In the IXM Platform, open the menu item Manage player (Channels > Location). Mark the vending machine’s player and select Tools > Pogomat from the bottom left margin in the menu.
Note

The Pogomat can only be edited if the vending machine’s door is open.

The session remains active after successful login until the door is closed.

Pogomat: main window

The planogram (an overview of a vending machine’s or locker’s slots and compartments) is shown after starting the Pogomat.

1

Opens a window to select a template.

2

Saves the current template.

3

Slot

4

Refreshes the display in the main window.

5

Saves all changes.

6

Fills all slots to the previously defined maximum fill level.

7

Opens a dropdown menu with the following functions:

  • SET GLOBAL CAPACITY: Sets the capacity (maximum fill level) of all slots to the defined value.

  • EMPTY ALL SLOTS: Removes all products from all slots.

8, 9

Buttons for the selection of the vending machine or locker (if a locker is connected).

Note
Save your changes in regular intervals.

Slots - structure

The following information is displayed in every slot:

1 – Slot number and price of a product

2 – Product image

3 – Product name

4 – Inventory and capacity:

  • Inventory (INV): current fill level of the slot.
  • Capacity (CAP): A slot’s maximum capacity (number of products).
Note
Use the icons  and  to switch between the previous and next slot.

Assigning products to a free slot

  1. Use the corresponding button on the upper margin to select the vending machine or the desired locker (when applicable).
  2. Click on a free slot. The product selection window opens.
  3. Select a product database from the upper selection list (only possible during the first assignment of a product to a vending machine).
  4. Select a product. You can search for specific products or filter by product categories.
  5. Double-click the desired product to accept it for a certain slot.
  6. Optionally, edit the name, description or price of a product. Only possible if the database is configured correspondingly.
  7. Define a value for the capacity (maximum fill level) of the slot in the field CAPACITY.
  8. Optionally, set the value to maximum via the button SET TO MAXIMUM. Use the icon  in the main window to define a global capacity for all slots. The capacity of every slot is always ‘1’ and cannot be changed.
  9. Define the fill level of the slot in the field INVENTORY. The fill level of all slots can be refilled in the main window via the button FILL ALL TO CAP. The fill level of all slots (INV) is set to the previously defined maximum fill level (CAP). For lockers, the capacity of every slot is always ‘1’ and cannot be changed.
  10. Save your changes.

Edit a product in a slot

Already assigned products can be edited retroactively.

  1. Click the button EDIT in the slot that you want to edit. Only possible if the database is configured accordingly.
  2. Edit the product’s settings and save the changes.

Remove a product from a slot

  1. Click the button EDIT in the slot that you want to edit.
  2. Click the button DELETE.
Note
You can remove all products from all slots via the entry EMPTY ALL SLOTS (Icon  in the main window).

Templates

Templates allow you to transfer a finished layout to another vending machine or save it for later use.

Save a layout

As soon as you have finished a layout you can save it as a template:

  1. Click the icon . The window SAVE TEMPLATE opens.
  2. Define a name for the template and click on SAVE. 

The layout is now available from the selection list via the button TEMPLATES and can be used on other vending machines.

Assign a layout to a vending machine

  1. Click on the button TEMPLATES. A selection list with all existing templates opens.
  2. Select an existing layout and click the button APPLY TEMPLATE in the corresponding layout.
  3. The layout is transferred to the vending machine.

Edit or delete a layout

  1. Click the button TEMPLATES. A selection list with all existing templates opens.
  2. Click the respective icons to rename or delete a template.

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.