Key Concepts
- Product - product is the Stock Keeping Unit (SKU)
- Trackable Items - if a product is individually trackable (meaning it’s returnable by the consumers), it’s trackable. Some of the example of trackable items: rechargeable battery for power tool, laptops, restricted substances like tranquilliser.
- Inspection Interval - the maximum interval between each inspection cycle
- Restrictions - the maximum quantity for non-trackable products per consumer account
- Product Value - the current worth of one unit of a product, used to enforce value-based usage limits
Product and Trackable Items
Each product has a dedicated SKU. An example would be T-shirt. A particular T-shirt (e.g. blue stripe) has three SKUs, they are
- Product #1 - size XS
- Product #2 - size M
- Product #3 - size XL
Although they are all the same T-shirt, they are of different SKUs, so they are different products in Industrial Vending system.
If a product is trackable, it may have trackable items. Each trackable item has different asset tag (or ID). An example would be Apple MacBook laptops,
- Product #12, MacBook Pro 14-inch A2442
- Trackable Item #1, Asset Tag: COMPANY001
- Trackable Item #2, Asset Tag: COMPANY002
- Product #13, MacBook Pro 16-inch A2485
- Trackable Item #5, Asset Tag: COMPANY004
- Trackable Item #6, Asset Tag: COMPANY005
When Employee John Doe took Trackable Item #1, John will return Trackable Item #1. John could not return Trackable Item #2 when John actually took Trackable Item #3.
For trackable items, we will keep track of the sessions (when did someone take a trackable item, and when did the trackable item get returned).
Product Value
Each product can carry a value. Its purpose is to gate access: it is the input to the value-based usage limits configured on Employee Groups. Before a product is dispensed, Industrial Vending adds up the value of what the employee has already taken in the current cycle, and denies the dispense if taking one more would push them past their group’s limit.
Product value also drives the value figures shown on the Transactions page, in the transaction CSV export, and in reporting, and it is what you re-charge contractors by.
Changing a Product’s Value
Every vend records the product’s value as it stood at the moment the item was dispensed. A vend’s value is that recorded value × the quantity — see How vend value is calculated.
So when you save a new value, it applies to vends from then on. Vends already recorded at a value keep it: past reports, re-charges and employees’ current-cycle totals do not move.
There are two exceptions, where no value was recorded and the vend is valued at the product’s current value instead:
- Vends made before vend values were recorded (before contractor billing was introduced). They follow the product’s current value permanently, so changing the value re-values them in reports and, if they fall in the current cycle, in employees’ group-limit totals.
- Vends of a product that had no value set at the time. Giving the product a value later values all of those vends at it.
If you re-charge by value or rely on value-based group limits, set each product’s value before it is first vended, and prefer changing values at the start of a limit cycle while older, unrecorded vends are still in the current cycle.
Restrictions
To avoid excessive waste, administrators could configure restrictions on products. Each restriction rule is evaluated before dispense, and the consumer is granted access only if the rule would not be violated. Multiple rules can be applied to a single product independently — if any rule is violated, access is denied.
A rule has two settings:
- Duration — how far back to look, in seconds. This is a rolling window that ends at the current moment. For example,
3600means “the last 1 hour”,86400means “the last 24 hours”, and604800means “the last 7 days”. - Maximum Quantity — the most of this product a single consumer may hold within that window.
What “Maximum Quantity” means
Maximum Quantity is an inclusive cap. A consumer may take up to and including that number within the window; the request that would push the total over it is refused.
So a rule of Maximum Quantity 2 over a Duration of 86400 (24 hours) means each consumer can take 2 of that product in any 24-hour period — the 3rd attempt is refused until one of the earlier two ages out of the window.
Concretely, for that rule (Maximum Quantity 2, Duration 24 hours):
| Already taken in the last 24 hours | Taking 1 more? |
|---|---|
| 0 | ✅ Allowed (total is 1) |
| 1 | ✅ Allowed (total is 2) |
| 2 | ❌ Refused (would be 3) |
Only the consumer’s own pickups of the same product that are successful or currently in progress count toward the window. Failed dispenses, cancellations, and returns are not counted.
Daily Reset
Each rule can also be configured with the Daily Reset toggle, which caps how far the window reaches back.
- Off (default): the window is the pure rolling Duration described above (e.g. if someone took their limit at 3pm yesterday, they are clear again at 3pm today).
- On: the window never reaches back past midnight of the current calendar day. Early in the day the count effectively starts fresh from midnight; it still never looks back further than the Duration. Midnight is calculated in your organisation’s configured timezone.
Inspection Interval
Certain products require periodical inspections to either maximize the lifespan or to fulfil its requirements. Some of the examples include,
- headlamp battery might require a full power cycle after 10 uses
- a safety helmet would require sanitization after each use during COVID-19 pandemic
- a controlled substance container would require site manager to acknowledge the quantity after return.
Calibration Schedule
A trackable product can also be put on a calibration schedule, for precision tools such as torque wrenches, gas detectors and gauges. Tick Trackable, then fill in either or both:
- Calibrate every (days) - each item is due this many days after it was last calibrated.
- Calibrate after days in use - each item is due once it has been out on loan on this many days since it was last calibrated.
Together with the Inspection Interval above, an item is due when it reaches the first of these, and a vending machine or locker will not issue an item that is due. Leave a field at 0 to switch that trigger off. Each item can override the product’s schedule. See Calibration for what happens when an item is due, and how to send items out and record the results.
Changing a product’s schedule applies straight away to all of its items, including ones already out on loan.
Add a Product
To add a new product (a new SKU) to the system, please follow this procedure,
- Visit Product Settings page
- Click “Add Product” button to open the dialog
- On the popup window, input “Product Name”
- Input product value for further tracking, transaction analysis, and usage limitations (Please note that the currency configuration can be customized in Organization settings to match your local standards.)
- Optionally, you can also specify the photo of the product. This is handy if “Mobile” pickup method enabled in the organization. Photos are optimised automatically when you save — see Photo uploads below.
- Toggle “Trackable” if the product should be trackable.
- If you want to make the product source information clearer, enter the Manufacturer, Manufacturer Code, Supplier, and Supplier Code
- Toggle “Require inspection after use” and specify “Inspection Interval” if the trackable product requires periodical inspections.
- Assign one or more tags to the product if you want to enable tag-based usage limitation
- Optionally, click “Add translation” to enter the product’s name and description in another kiosk language — see Kiosk Languages
- Click “Save” button to create the product

Once created, you should be able to see the product in the Product Settings page.
Update a Product
Industrial Vending allows the administrators to perform the following functionalities on the product,
- Add / Update the product name
- Add / Update the product value
- Add / Update / Remove the product photo
- Make a product trackable or non-trackable
- Require inspection after certain uses
- Add / Remove tags on the product
- Add or remove restrictions on products
Update product
To update product, please click Edit button in Operation column on Product Settings page. On the popup window, administrators can update the following attributes,
- Product name
- Product value
- Replace product photo
- Remove existing product photo
- Make the product trackable or non-trackable
- Enter the Manufacturer, Manufacturer Code, Supplier, and Supplier Code to make the product source information clear (Optional)
- Toggle Require Inspection after Use, and specify the number of use cycles between inspections if the trackable product requires periodical inspections
- Assign one or more tags to the product if you want to enable tag-based usage limitation
- Add, change or remove Translations of the product’s name and description, shown on the vending machine when it is in that language. You can also import them from CSV — see Kiosk Languages

After changing values in the popup window, click Save button to save the option.
Photo uploads
You do not need to prepare or shrink a picture before uploading it. When you save a product, PPE Vending processes the photo for you:
- It is converted to PNG, whatever format you uploaded.
- It is scaled down so that its longest side is no more than 1024 pixels. The shape of the picture is kept, so nothing is stretched or cropped. A picture already smaller than that is left at its original size rather than being blown up and blurred.
- It is compressed, and camera information embedded in the file — including the GPS location where a phone photo was taken — is removed.
This keeps kiosk screens and the employee mobile app quick to load, and it means a photo taken straight off a phone is a perfectly good source image.
Two things are worth knowing. The processing is not reversible: the picture stored against the product is the reduced one, so keep your own copy if you need the original. And uploads are still limited to about 3.5 MB per file — if a very large photo is rejected, shrink it slightly and try again.
The same treatment is applied to vending machine photos, locker photos, and your organization logo.
Add or remove restrictions
To add or remove restrictions, please follow this procedure,
- Visit Product Settings page
- Find the product and its row in the list
- Click Restricted or No Restrictions link in the Restrictions columns

To add a new rule, follow this procedure on Product Restrictions page,
- Click + symbol next to Current Restrictions
- Add the duration of seconds (e.g. 3600)
- Add the maximum quantity a consumer could take (e.g. 5)
- Toggle Daily Reset to refresh the restriction at the start of each new calendar day, regardless of the previous day’s latest transaction time.
- Click Save button to save the restriction.

To remove a rule, you could click Delete button on the Actions column. 
Products Stocked in More Than One Place
When the same product is mapped to more than one coil or cell in a vending machine, the Product Map shows an “Also available at” note next to that product. It lists the other coils where the identical product is stocked (and, where applicable, the quantity available at each). This helps operators see every location a product is held in a machine, so you can refill evenly and avoid emptying one coil while another sits full. No setup is required — the cross-reference appears automatically whenever a product is placed on multiple coils.
Frequently Asked Questions
Q1: What’s the difference between a trackable and non-trackable product?
According to the documentation:
- Non-trackable products: Regular consumable items without individual tracking
- Trackable products: Items that are individually tracked and returnable. The documentation states “if a product is individually trackable (meaning it’s returnable by the consumers), it’s trackable.” Examples include “rechargeable battery for power tool, laptops, restricted substances like tranquilliser.”
Each trackable item has a unique asset tag. For example, when “Employee John Doe took Trackable Item #1, John will return Trackable Item #1. John could not return Trackable Item #2 when John actually took Trackable Item #3.”
Q2: How does the Daily Reset toggle work for restrictions?
The Daily Reset feature is documented in the restriction rules section. When enabled, it will “refresh the restriction at the start of each new calendar day, regardless of the previous day’s latest transaction time.” This means:
- With Daily Reset OFF: The duration counts from each transaction backwards
- With Daily Reset ON: The restriction resets at midnight each day
Q3: What do the duration and maximum quantity mean in restriction rules?
As explained in the documentation: “The unit of duration is second, it specifies how long should we look back to calculate the consumption rate. Duration 3600 and Maximum Quantity of 5 means that any consumer could take up to 5 items per 1 hour immediately prior of the current time.” Multiple restriction rules can be applied independently, and “The consumer will not be granted to access the product if any of the rule is violated.”
Q4: What are the Manufacturer, Manufacturer Code, Supplier, and Supplier Code fields used for?
The documentation states these fields are used “to make the product source information clearer.” They are optional fields that can be entered when adding or editing a product. These fields help track the origin and supply chain information for products in your inventory system.
Q5: If I change a product’s value, what happens to transactions that already took place?
Nothing, for transactions that recorded a value: each vend records the product’s value at the time it was dispensed and keeps it. The new value applies to vends from then on. Transactions with no recorded value — those made before vend values were recorded, and those of a product that had no value at the time — are valued at the product’s current value, so they do change. See Changing a Product’s Value.
Q6: When should I use the “Require inspection after use” feature?
The documentation explains this feature is for trackable products that need “periodical inspections to either maximize the lifespan or to fulfil its requirements.” Examples provided include:
- “headlamp battery might require a full power cycle after 10 uses”
- “a safety helmet would require sanitization after each use during COVID-19 pandemic”
- “a controlled substance container would require site manager to acknowledge the quantity after return”
You specify the “Inspection Interval” to set the number of use cycles between required inspections.