Metered Usage Imports

The Metered Usage import allows you to create metered usage records in Maxio directly from a CSV file. Unlike other import types, Metered Usage imports send each row to Advanced Billing through an API request rather than writing data directly to Maxio records.

Prerequisites

Review the notes below before completing a Metered Usage import:

• Your account has Advanced Billing integration enabled.
• The Metered Usage importer is enabled for your account. This is not self-serve and must be turned on by Maxio staff.
• You have metered components set up in Advanced Billing.

If you are having issues finding any of these, get in touch with our support team at support@maxio.com.

CSV fields

Prepare your CSV with the following columns before you start the import:

You must supply either Component ID or Component Handle. If you supply neither, the row fails with the error Either Component ID or Component Handle must be provided.

The Advanced Billing Usage ID is returned by the API for each successful row, so it is not a column you supply.

How to import metered usage

Follow the steps below to create metered usage records using the Metered Usage importer:

1. Go to Admin > Import > Create.
2. Under Create Records, choose Metered Usages from the list of available import types.
3. Click Choose File and select your prepared CSV file.
4. Click Next to continue.
5. On the field mapping page, map the CSV columns to the appropriate Metered Usage fields.
6. Select any desired map retention or formatting options.
7. Review your field mappings for accuracy and ensure that all required fields have values.
8. Click Import to submit the file.

After the import completes, the results page displays the number of successful and failed rows. You may download an error file if any rows require correction.

Import results for metered usage

Once the Metered Usage import has finished processing, the results page displays a detailed summary of the rows successfully sent to Advanced Billing and any rows that encountered errors.

During a Metered Usage import, each row is processed independently. This means the results may include a mix of successes and failures, depending on the API response from Advanced Billing.

The results page displays:

• Success Count
  The number of usage records successfully created in Advanced Billing. Each successful row includes the Advanced Billing Usage ID returned by the API.
• Error Count
  The number of rows that failed validation or were rejected by the Advanced Billing API. Error messages appear directly in the results grid to help identify the specific issue for each row.
• Downloadable Error File
  If any rows fail, you can download a CSV file containing only the failed records and their corresponding error messages. After correcting the issues, you can re-upload the file to complete the import.
• Partial Success Mode
  Metered Usage imports always run in partial-success mode. This ensures that valid rows are processed even if other rows contain errors.

After reviewing the results, confirm the successful usage records by navigating to the associated subscription in Advanced Billing. Imported usage behaves the same as manually entered usage for billing purposes.