Measurements work in a similar way to usage, but the behavior of measured charges differs in several important areas. In this guide, the term Measurements refers specifically to the charge type Measured. This is separate from the Measurement Report feature, which follows the same import logic but applies to recurring charge types.
How Measurements Work
Measured charges always use the latest imported or updated measured quantity. The system bills the charge according to this latest measurement.
Key points:
-
The latest measurement is the active value used for billing.
-
A measurement is not consumed. It remains active after it has been billed.
-
The same measurement is billed again in the next period unless a new measurement is imported.
-
Measured charges can be billed in advance based on the latest measurement.
Example
Bob's Business has an order for an application priced by number of users. The price is 1,000 SEK per user. The order is billed monthly in advance.
If the latest measurement shows 5 users, the customer is billed for 5 users each month until a new measurement is imported.
Importing Measurements
To import measurements:
-
Go to Measurements.
-
Select Import Measurements.
-
Select File and upload your measurement CSV file.
Required fields in a measurement CSV
Your file must include:
-
Quantity. The measured value.
-
Tag. The unit of measure.
-
Date. The date when the measurement was updated.
You must also map your measurement to a specific charge by using the Charge Number or another supported key.
After the import, the order page shows that the measurement has been updated.
How Measurements Affect Billing
First billing period
If you import the first measurement at the start of the service period, it becomes the active value. When you create the invoice for that period, the invoice reflects that measurement.
Example:
If the order starts on 2020-05-01 and your measurement is set to 5 on that date, the invoice for May will use 5 as the quantity.
Subsequent billing periods
If you do not import a new measurement, the system continues to use the latest measurement.
Example:
If no new measurement is imported for June, the June invoice also uses the value 5.
Updated measurement during a period
If you import a new measurement in the middle of a period, the system updates the active value. The next invoice uses this new quantity.
Example:
If you import a measurement with quantity 8 on 2020-06-15, the July invoice uses quantity 8.
Measurement Rules
Measurement rules define how the system selects the measurement to use when multiple measurements exist in the same period for the same charge.
Available options:
-
Latest date. The system uses the measurement with the most recent date.
-
Sum latest date. The system sums all measurements that share the most recent date.
This setting applies to how measurements are interpreted for billing.
Measurement Report
The Measurement Report is a tool used for recurring charges that follow a quantity-based price model such as quantity, volume, or tiered. It is not connected to the charge type Measured, even though both processes involve importing quantities as measurements. The only similarity is that a quantity is imported in both cases.
You import quantities for recurring charges in the same way as described above for measured charges.
Creating a Measurement Report
After you have imported quantities to your recurring charges, you can open the Measurement Report by
- Go to Measurements.
- Select Measurement Report the three-dot menu in the top right corner.
The Measurement Report helps you to identify all recurring charges where the imported quantity differs from the current quantity on the charge. This allows you to create a change order to update quantities in bulk.
Purpose and Behavior
After generating the Measurement Report, you can mark the rows you want to apply through a change order. You can then choose whether to use the imported measurement date as the effective change date or set a single date for all selected rows.
The Measurement Report allows you to:
-
Identify all recurring charges where the imported quantity has changed.
-
Perform a bulk update of quantities through a change order. This will create a new version on the affected orders.
-
Include only the charges where the quantity has been updated.
This tool ensures that recurring charges remain aligned with the latest imported quantities.