Roraima Vendor Guide
Time and use
What the Time and use tab controls
Time and use is the tab of a product in Equipment and spaces by time or by use: a washing machine, a sauna, a shower, a car park or a gate. It decides how the service starts: in which structure the Buyer uses it, whether it is sold by time or with tokens, in which unit it is counted, and which devices, scenarios or programmes it uses.
The Buyer starts every service on site, after scanning a QR code of the structure. What the Buyer chooses when buying, and what each choice costs, is not set on this tab: it is set on the Options tab, as described below.
Menu path
Vendor Back Office → Listings and structures → Listings → New equipment or space by time or by use, then create the product, open it and select the Time and use tab.
The tab appears after the first save of the product. A product of this type shows the tabs General, Options, SEO, Time and use and Extra info.
Field reference
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Structure | Sets where the Buyer starts the service. | Select the structure. After you choose it, Open structure, Preview and Download the QR to attach appear; Manage structures opens the list of structures. | Required. Without a structure the product is not put on sale. |
| How it is sold | Chooses the model. | Select By time or With tokens. By time lets the Buyer choose a duration, start it on site and control the devices you select while it lasts. With tokens lets the Buyer buy tokens and spend them on site on your programmes. | Required. It decides which other fields appear. |
| Counting unit | Sets what the number in each row of the Options tab means. | By time, select minutes, hours or days; a new product proposes hours. With tokens the unit is fixed and the tab shows tokens. | Required. Changing it does not convert the numbers already written: the tab warns you, and you check the rows on Options. |
| To be used within (days) | Sets how long the Buyer has to start the time or spend the tokens. | Enter the number of days after the purchase. | Required. At most 30. A new product proposes 30. |
| One buyer at a time | Prevents two Buyers from starting the same devices together. | Keep it selected when one person can use the equipment at a time; clear it when several Buyers can use it together. | Optional. Selected by default. |
| Devices the buyer controls | Selects the devices the Buyer controls during the purchased time. | Choose up to 10 of your devices. | By time only. At least one device or a start scenario is required. |
| Start scenario (optional), End scenario (optional) | Run automatically when the time starts and when it ends. | Select an on-request scenario, for example one that switches a socket off at the end. Automations that start with a trigger are not listed. | By time only. The Buyer does not run or stop them. |
| Add a programme | Adds a button that the Buyer presses on site. | Fill in the programme: Button name, Start scenario, Tokens, the duration in hours and minutes, and optionally End scenario. Use Remove to delete a programme. | With tokens only. At least one programme is required. The button name is written in the language selected at the top of the page. |
| Can be sold only once | Stops further sales after the first purchase. | Select it only when the product must be sold once; the checkbox reads Set quantity to zero after first purchase. | Optional. |
Use the product's main Save action: the tab has no save button of its own.
Start from a device
When you open a new product with Sell the use of this device from a device's edit page, the category is already set and three rows appear under What you offer: Devices the buyer controls with that device, Device entity when the device has several entities that turn on and off, so you choose one, and Ready-made scenarios, with its box already ticked: for a device called Washing machine it reads "Create “Turn on Washing machine” and “Turn off Washing machine” as the start and end scenarios". When you create the product with the box ticked, Roraima creates the two scenarios, or reuses the ones that an earlier product made from the same device already created, and links them as start and end scenario; with tokens they go on the first programme, whose button name you write yourself. If either scenario cannot be created, for example because no entity is chosen or you have reached the maximum number of scenarios, neither is linked: the product is still saved and a message says so. The structure, the prices and the durations remain yours to set, as for any other product.
Price and the Buyer's choice
The price entered on General is the starting point of every choice. The choices themselves are the rows of an option that Roraima adds to the product the first time you save this tab: Duration for a product sold by time, Tokens for a product sold with tokens. You find it on the Options tab, in the product's list of options.
Each row of the option has:
- a Name, which the Buyer reads, such as 30 min, 2 hours or 5 tokens;
- a Modifier / Type, the surcharge added to the product price, in euros or as a percentage; 0.00 means no surcharge;
- a Number, a whole number without a unit, counted in the unit you chose on the Time and use tab and shown next to the field;
- a Status, Active or Disabled.
Roraima writes three example rows at no surcharge: 30, 60 and 90 minutes, or 1, 2 and 3 hours, or 1, 2 and 3 days, or 1, 5 and 10 tokens. They are only a starting point: how long each row lasts and how many tokens each row gives are your decision, not Roraima's. Replace them with your own. The quantity stays the standard one: a Buyer who buys 2 of 1 hour gets 2 hours.
Checks when you save an option
When you save a row of the Duration or Tokens option, Roraima refuses the save and writes nothing in these cases:
| Check | What you see |
|---|---|
| The type is changed from a drop-down menu. | An error saying the option stays a drop-down menu. |
| A row has a number outside 1 to the limit. | An error asking for a whole number from 1 to the limit. The limit is 30 days in the chosen unit, so 720 for hours, and 500 for tokens. |
| No row is active. | An error saying the option must have at least one active row. |
The option cannot be deleted from the product: the attempt shows a warning and the option stays. To sell the product in another way, change How it is sold on the Time and use tab.
You can add other options of your own. Roraima lets the Buyer choose and pay for them, but does not use them to count time or tokens.
What happens when you save the tab
- First save: Roraima adds the Duration or Tokens option with the three example rows and tells you so.
- Change of model: Roraima replaces the option with the other one and writes three new example rows; the rows you wrote in the old option are not kept.
- Change of unit: the rows stay as they are and their numbers now mean the new unit, for example 2 hours becomes 2 days. Roraima warns you and does not convert anything.
- Missing requirements: the product is switched off and a warning lists what is missing.
Why a product stays off sale
A product in this category stays off sale until it has all of these: a choice in What you offer on General; a structure; by time, at least one device or a start scenario; with tokens, at least one programme; and the Duration or Tokens option with at least one valid row. A new product is created active and is switched off at the first save if something is missing. The warning "This product cannot be published" lists each missing point, and the same warning appears each time you open the product. The dashboard also counts the products that are not published: for an owner, the Listings card shows them under Not published with the reason and links to Listings; for other vendors the dashboard links to Manage products.
If you change the product's structure, download and print its QR code again.
Related guidance
Read Options for the general rules of the Options tab, Set up accommodation structures to create the structure, Manage devices before selecting the devices the Buyer controls, Manage automations to create the start and end scenarios, and Manage products for readiness requirements.
Back to Roraima