Introduction
A measurement is a quantity measured by someone, at a given time, linked to something in the system and with its proof. Each measurement belongs to a measurement type, which sets:
- The unit (kg, t, m³, l, h…) and the decimals.
- The custom fields the operator fills in. For example, the gross weight and the tare of a weighing.
- How the main value is obtained: typed by the operator, calculated with a formula over the fields (net = gross − tare) or taken from one of the fields.
- What it is linked to: zone, asset, work order, vehicle and catalogue value, each one required, optional or not applicable.
- The evidence it needs: photos, document (delivery note or ticket) and signature.
- The validations: minimum, maximum, not negative and a warning if the value is far from the average.
- Whether what is measured is handed over to a third party (a waste manager, a plant) and within what deadline.
The meter reading of reading batches is one more measurement type, owned by the system: its readings are still taken in batches, with their measuring points, and they also appear in the measurement list and aggregates. See Reading batches.
A measurement has three states:
| State | What it means |
|---|---|
| Draft | Saved without confirming. Required fields or evidence may be missing. |
| Confirmed | Confirmed by whoever measured it: it is their signature. Only an authorised profile corrects it, always with a reason. |
| Voided | Voided with a reason. It is never deleted and no longer changes. |
Prerequisites
Contracted module
Measurements are included in the Measurements and meter readings module. The provider enables it from the platform administration. Without it neither the menu nor the tab appear.
Permissions
| Permission | What it allows | Roles that have it |
|---|---|---|
| Measurements · View | View measurements, aggregates and handovers | Administrator, Supervisor, Technician, Read only |
| Measurements · Record | Record measurements and change your own drafts | Administrator, Supervisor, Technician |
| Measurements · Correct confirmed | Change a confirmed measurement, with a reason | Administrator, Supervisor |
| Measurements · Void | Void measurements and handovers, with a reason | Administrator, Supervisor |
| Measurements · Configure types | Measurement types, catalogues and instruments | Administrator, Supervisor |
Permissions are changed in Administration › Roles and permissions, Measurements group. Exporting to a spreadsheet or PDF also needs the export reports permission.
Measurement types
They are set up in Administration › Measurement types. The list shows each type with its unit, its nature, how the value is obtained and whether it requires a handover.

Create a type from a template
The quickest way is to start from a template of your sector and adapt it.
- Click Create from template.
- Choose the template. Those for your sector come first, marked For your sector.
- Click Create. The type is created and, if it uses one, its catalogue (for example, waste types with their EWC code).
- Review the type and adapt it to your contract.

Available templates:
| Template | Sector | Unit | Key points |
|---|---|---|---|
| Waste weighing | Beach and street cleaning | kg | Net = gross − tare, waste type, zone, vehicle, work order, photo and handover within 30 days |
| Pruning waste | Landscaping | kg | Waste type, zone, photo and handover |
| Plant protection treatment | Landscaping and agriculture | l | Product, dose, area and pest, work order |
| Paint applied | Road marking | l | Paint type, metres, work order and photo |
| Sludge and cleaning residues | Irrigation and channels | m³ | Section, material, photo and delivery note, handover |
| Sludge removed | Wastewater treatment | t | Dryness, plant, weighing ticket and handover |
| Hazardous waste | Industry and renewables | kg | EWC code, equipment, work order, photo and handover |
| Construction and demolition waste | Civil works | t | Net = gross − tare, EWC, site zone, ticket and handover |
| Refuelling | Fleet | l | Fuel, odometer, vehicle and photo of the receipt |
| Machine hours | Machinery | h | Cumulative: consumption is the difference from the previous one |
The type editor

Each section of the editor has its own collapsible Help, explaining each option, with a table of field types and examples. In the formula, the example buttons write it for you and Try it with sample values calculates the result with the numbers you enter, before saving.
- General data: name, code (for the API and exports), unit, decimals and nature. A cumulative measurement is a meter (machine hours): what matters is the difference from the previous one of the same asset or vehicle. A quantity of an event is what is measured once (the kilos of a load).
- Custom fields: each field has a key (lowercase, numbers and _), a label, a type, whether it is required and, for numbers, minimum, maximum and unit. Types: whole number, decimal number, text, date, yes or no, list of options and catalogue value.
- Main value: typed by the operator, calculated with a formula or taken from one of the fields. The formula accepts numbers, the keys of the numeric fields,
+ - * /and brackets. The editor tells you at once whether it is valid and which fields it uses. The server always recalculates the value. - Associations: for the zone, the asset, the work order, the vehicle and the main catalogue value, whether it is required, optional or not applicable. A required one does not let the measurement be confirmed without it.
- Evidence: photo, document and signature, each one required, optional or not applicable, the minimum number of photos and a help text for the camera.
- Validations and deadlines: minimum and maximum value, not negative, warning if it deviates from the average (in %), whether it requires a third-party handover and its deadline in days, the deadline for recording measurements later (late entry) and where they can be recorded from (app, web, import, API).
If the type already has measurements, it cannot be deleted: you are offered to deactivate it. Its nature cannot be changed either.
Catalogues
Catalogues are the lists types use: waste types, products, fuels. They are managed from Measurement types › Catalogues. Each value has a code, a name and, if needed, its EWC code, shown in the app before the name.

A value already used in measurements is not deleted: it is deactivated and no longer offered.
Measuring instruments
An asset that measures (a scale, a flow meter, an hour meter) is registered as an instrument from its record on the map, Measurements tab, Measuring instrument block. Brand, model, serial number, capacity, resolution, whether it is subject to legal metrology control and the verification dates are stored.
- If you leave the next verification empty, it is calculated from the last one and the interval in months.
- If a measurement exceeds the instrument capacity, a warning is shown.
- Thirty days before the next verification, and once it is overdue, the Instrument verification alert arrives.
Recording measurements
In the mobile app
The technician records the measurement in the field, online or offline. The screen is built from the type setup: the custom fields, the value calculated live, the zone, work order, vehicle and catalogue pickers, and the camera. The app preloads what it knows: the work order it is opened from, the asset of the record, the vehicle for the day, the time and the position. Without the required data and evidence it does not let you confirm.
On the web: late entry from a document
For what is not measured in the field, for example the weight on the plant delivery note:
- On the map, open the Measurements tab of the right panel and the Measurements sub-tab.
- Choose the type and click New measurement. You can also do it from the record of an asset or a work order: the asset or work order comes preloaded.
- Enter the measurement date and time, the fields, the catalogue value, the zone, the vehicle and the work order. The work order and the asset are searched by typing their code.
- Attach the photo or the document.
- Click Save draft or Save and confirm.

If the date is older than the late entry deadline of the type, the measurement is saved anyway and the office gets the Measurement recorded late alert.
What the server completes
- Value: if the type has a formula, it always recalculates it.
- Zone: if none is given, the work order zone; if not, the asset zone; if not, the zone that contains the position.
- Vehicle: if none is given and the type allows it, the operator vehicle for the day.
- Client: the one of the work order or of the asset.
Tracking
The measurement list
The Measurements sub-tab lists those of the period with filters by type, state, dates, pending handover and a search by asset, work order, plate, zone, operator or note. View on map draws the measurements that have a position: confirmed ones in green, drafts in orange.

The measurement record
Clicking a measurement opens its record with all the data, the evidence and the change history.

- Confirm: your own draft, if it has everything required.
- Edit or Correct: your own draft, or a confirmed one with the correct permission. The correction asks for a reason and is kept in the history with its author.
- Void: asks for a reason. The measurement is not deleted.
- Upload: adds a photo or a document; drag it onto the file area or click it to choose one.
- The work order, the asset and the zone are links: the work order and the asset open in the right panel, and the zone is drawn and framed on the map.
- Clicking a photo opens it full size, with arrows to move to the others. Documents open in another tab.
- The history shows what changed in each correction, with the previous and new value, who did it and the reason.
Aggregates
Aggregates gives the sum, average, minimum and maximum of the value of a type, grouped by catalogue value, zone, asset, vehicle, work order, operator or client, and by day, week, month or year. For cumulative types you can see the consumption between measurements instead of the value. Only confirmed ones count.

Export
CSV, Excel and PDF export the filtered list, with dates in the format set in Settings. The spreadsheet also includes the links to the evidence and the custom fields of the chosen type. The PDF is landscape, without evidence, and only has the Asset column when some measurement has an asset.
The Excel file is an editable spreadsheet with live formulas:
- With a single type chosen and its value calculated by a formula (for example, Value = gross - tare), the Value column is that formula over the cells of the same row: if you correct the tare in the sheet, the net value is recalculated. If a measurement is missing one of the fields, it carries the value as it is.
- The Total row counts the measurements (it respects the sheet filter) and, with a single type, adds up the Value of the Confirmed ones.
- It holds at most 20,000 measurements; if there are more, the header says so and you should narrow the period.
Lists
In Lists there are two entries: Measurements, those of the period, and Pending third-party handover, the confirmed ones of types with handover not yet handed over, with how many days they have been waiting and whether they are past the deadline.
Third-party handovers
For types that require it, what is measured is handed over to a third party with its document: waste to the authorised manager, pruning to the composting plant.
- In the Measurements sub-tab, choose the type and click Handovers.
- Click New handover.
- Choose the supplier or type the recipient, the date, the delivery note number and the quantity stated on the document.
- Tick the measurements being handed over and attach the document.
- Click Record handover. It gets a code ENT-YYYY-NNNNN.

The Handovers window shows the balance of each month: measured, handed over and pending.

- A measurement already in a handover cannot be corrected or voided: void the handover first.
- When a handover is voided, its measurements are pending again.
- If a measurement passes the handover deadline of its type, the Third-party handover pending alert arrives. It closes by itself when the handover is recorded.
The client portal
The end client (a city council, the owner of a plant) sees in their portal, Measurements button, the confirmed measurements of their client with their photos, the total of the period and a monthly chart. If they have zones assigned, only those in their zones. The portal roles Manager, Administrator and Technical supervisor can see them. See Client portal.
Integration
Measurements, their types, catalogues, evidence and handovers are read through the public API with the key permission Measurements and are included in the data copy. There are three webhook events: measurement confirmed, measurement voided and third-party handover recorded. See ERP integration.
Current limitations
- No automatic integration with instruments. The value is typed with the photo of the display or ticket as proof. Reading a scale or a flow meter directly is studied case by case.
- No file import. Measurements cannot yet be loaded from a CSV of the instrument software.
- No usage-based preventive maintenance. Machine hours do not yet generate services every N hours.
- The export PDF does not include the photos, only their links.
Troubleshooting
| Symptom | Likely cause | Solution |
|---|---|---|
| Measurement types does not appear in Administration | The module is not contracted or the role does not have Measurements · View | Ask the provider for the module or check the role |
| It cannot be confirmed: «The evidence required by the type is missing» | Photos or the required document are missing | Upload the photo or document from the record and confirm |
| It cannot be confirmed: «Missing association» | A required association is missing and the server could not deduce it | Edit the measurement and choose the zone, work order or vehicle |
| The saved value is not the one typed | The type has a formula and the server recalculates it | Check the formula fields |
| A measurement cannot be corrected or voided | It is in a third-party handover | Void the handover first |
| The work order does not appear when typing its code | At least three characters are needed | Type more of the code and choose it from the list |
| The client does not see their measurements in the portal | Their portal role does not have the permission or the measurements do not have their client | Measurements take the client from the work order or asset: link them to one of them |
Last updated: