Documentation · For device manufacturers
The portal for device manufacturers
Contents
The onlineWatt portal has three roles: customer, installation company and device manufacturer. This page describes the manufacturer role: what it does in the portal, what it cannot see and where to find things.
What a manufacturer does in the portal
- Defines device types – technology, communication method, serial number format, variable mapping and event types.
- Creates individual devices – serial numbers, registration tokens and access credentials for communication.
- Tracks the state of devices from production to handover to the customer.
- Handles service tickets passed on by an installation company.
A customer or an installation company then adds the device to their account with the serial number and registration token created by the manufacturer. The procedure is in the guide Adding a site and a device.
What a manufacturer cannot see or do
- It does not see the devices' measured data. The manufacturer profile shows only when the device was last online (column Last metrics).
- It does not see end-customer data or who owns a device.
- It cannot sign up on its own. onlineWatt sets up a manufacturer account by agreement; there is no self-service sign-up for manufacturers yet.
- It cannot change its tariff in the portal. The tariff is agreed in advance; tariff changes and changes of contact information are handled by the sales representative.
- There are two device type technologies: photovoltaics (FVE) and heat pump.
How to become a manufacturer in onlineWatt
- Write to info@onlinewatt.com which devices you make and how many you want to connect.
- We agree a tariff. Manufacturer tariffs differ in the number of devices and the number of device types and are paid yearly – see Tariffs for manufacturers.
- onlineWatt sets up your manufacturer account.
- You make your devices send data over MQTT – see Connecting devices: MQTT and HTTP API. A ready-made example for a microcontroller is on the page Your own ESP32 device, one for a PLC on Tecomat PLC (Mosaic); we help you with the integration.
The manufacturer menu
A full overview of screens, buttons and fields is on the Portal map.
The main menu has four items: Devices · Types of devices · Tickets · Settings. At the top right is the user name with Change password and Logout, and the language switcher.
Device types
A device type is a template for all devices of one series. The list Types of devices shows for each type the number of devices, technology, communication, hardware version and serial number format. You can filter by technology, Communication and who created the type.
1. Add a type
Click Add type of device at the top right. The page Add new type of device opens; after filling it in click Save. Edit an existing type with the three-dot menu and Edit.
2. Fill in the type data
| Field | Meaning |
|---|---|
| Name | for example the series and version |
| Technology | FVE (photovoltaics) or Heat pump |
| Communication | MQTT or HTTP |
| Customer control | Yes / No – whether the customer can control the device from the portal. It can be switched on only with MQTT communication, because only MQTT is two-way. |
| HW version | hardware version |
| Format SN | serial number pattern with the placeholders {year} and {count_in_year}, for example Abc{year}{count_in_year}X |
| Note | internal note of the manufacturer |
| Mapping | variable mapping in YAML – which values the device sends, in which units and which ones the customer sees |
How to write the mapping is described on the page Connecting devices: MQTT and HTTP API.
3. Set up event types
When editing the type, click Event type management. Each event has a priority, a number (UID), a Czech and an English description and the setting whether it is visible to the customer (Customer visibility). Add a new event with Create; edit all of them at once in YAML with Bulk editing of event types.
There are five priorities, from 1 (highest, red) to 5 (informational, blue).
Special action marks an event by which the device confirms that it carried out an instruction from the portal – a temperature setting. When the customer shifts the temperature in the portal by, for example, +1 °C, the device answers with an event carrying the special action for +1 °C. Special actions exist for shifts of −2, −1, 0, +1 and +2 °C.
Devices
The Devices list shows for each unit the serial number, type, state, time of the latest metrics, who created it and when, and a note. You can filter by Device type, State and who created the device; Search searches the list.
1. Add devices
Click Add device at the top right. In the window choose the Device type, enter the number of devices and click Confirm. The portal creates that many devices: it generates serial numbers from the type's Format SN and creates registration tokens and passwords automatically. Devices can thus be created one at a time or in bulk.
2. Check the device data
When editing a device (three dots → Edit) you see: - State, - Serial number and Registration token – you hand these two over with the device; the customer or installation company registers the device with them, - for a type with MQTT communication: MQTT user and MQTT password – credentials you load into the device – and MQTT topics, i.e. the addresses for metrics, events, commands and command responses, - for a type with HTTP communication: PLC password, with which the device signs the data it sends, - Note.
Never send the registration token or device passwords to anyone unencrypted and never publish them.
3. Keep the device state up to date
The state is an aid for the manufacturer: it shows whether the device is only created in the database, manufactured, or already shipped to an installation company. It has no effect on how the device works in the portal. You choose it from a list, usually in this order: Created in DB → Programmed → Material → Electrically connected → Attached → Tested → Dispatched → At the customer.
4. Other actions
The three-dot menu at a device contains Edit, Create ticket and Delete.
5. Exporting device data
The Export data device button at the top right immediately downloads an Excel file (.xlsx) with the device list: device type, serial number, user name, password and registration token. The file contains the access credentials of all devices – store it securely and never send it unencrypted.
Tickets
Tickets receives the requests an installation company cannot solve on its own. The path is customer → installation company → manufacturer. The list shows priority, ID, name, category, to whom the ticket is assigned, installation company, device type, creation date and last comment.
- Filters: Priority, Category (Device, Device event, General), Device type and a search in names and comments.
- Show closed tickets by checking Display closed.
- Create a new ticket with Add ticket: fill in Ticket name, Ticket content, Priority and Installation company, add Attachments if needed (png, jpg or gif up to 10 MB) and click Save.
- A ticket can also be created directly from a device: Devices → three dots → Create ticket. The device is prefilled in the ticket.
Ticket detail
Click a ticket to open its detail. The heading shows the name and priority (for example High or Medium).
- Values: Author, Category, Assigned, Installation company, Created, Modified, Device (link to the device), Ticket content and Attachments with the link Download.
- Comments: write the text into Comment, add Attachments if needed (png, jpg or gif up to 10 MB) and click Send. Earlier comments are below the form.
- Assign installation company returns the ticket to the installation company; the portal asks "Do you really want to reassign this ticket?" and you confirm with Confirm.
- Close ticket closes the ticket.
Tariffs for manufacturers
The tariff is agreed with onlineWatt when the account is set up and is paid yearly. It is shown in the portal in Settings → Tariffs; changes are handled by the sales representative.
| Price per year excl. VAT | Number of devices | Number of device types |
|---|---|---|
| CZK 4,500 | 100 | 2 |
| CZK 8,500 | 250 | 6 |
| CZK 12,000 | 400 | 6 |
| CZK 15,500 | 550 | 6 |
| CZK 18,000 | 700 | 12 |
| CZK 22,000 | 850 | 12 |
| CZK 29,000 | unlimited | unlimited |
Prices are excluding VAT, as shown in the portal on 13 November 2026. You get a binding offer when agreeing the account at info@onlinewatt.com.
Settings
| Tab | What is there |
|---|---|
| Contact information | company name, e-mail, phone, company ID, VAT ID and address. Changes are handled by the sales representative. |
| Tariffs | your tariff and its validity, number of devices and number of device types. Changes are handled by the sales representative. |
| User management | users of the manufacturer account, their roles, last login and state. Invite another user with Invite user. |
In the Invite user window you fill in First name, Last name, Role (Admin or Engineer), Email and Phone number.
Roles of manufacturer users:
| Admin | Engineer | |
|---|---|---|
| Devices, device types, tickets | yes | yes |
| Change parameters in Settings | yes | no |
| Change contact information and tariff | through the sales representative | no |
| Invite and delete other users | yes | no |
With Receive notifications from tickets checked, the user gets an e-mail with a button to open the ticket whenever a ticket is created or changed.
← All documentation · Found a mistake or missing something? Write to info@onlinewatt.com.