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.

Measurement types list
Measurement types list

Create a type from a template

The quickest way is to start from a template of your sector and adapt it.

  1. Click Create from template.
  2. Choose the template. Those for your sector come first, marked For your sector.
  3. Click Create. The type is created and, if it uses one, its catalogue (for example, waste types with their EWC code).
  4. Review the type and adapt it to your contract.
Templates by sector
Templates by sector

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

Measurement type editor
Measurement 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.

Waste types catalogue
Waste types catalogue

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:

  1. On the map, open the Measurements tab of the right panel and the Measurements sub-tab.
  2. 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.
  3. 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.
  4. Attach the photo or the document.
  5. Click Save draft or Save and confirm.
New measurement from the web
New measurement from the web

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.

Measurement list in the panel
Measurement list in the panel

The measurement record

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

Measurement record
Measurement record
  • 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.

Aggregates by waste type and month
Aggregates by waste type and month

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.

  1. In the Measurements sub-tab, choose the type and click Handovers.
  2. Click New handover.
  3. Choose the supplier or type the recipient, the date, the delivery note number and the quantity stated on the document.
  4. Tick the measurements being handed over and attach the document.
  5. Click Record handover. It gets a code ENT-YYYY-NNNNN.
New third-party handover
New third-party handover

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

Handovers and balance
Handovers and balance
  • 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: