Avarni has separate upload templates for different kinds of data. Each one asks for its own columns.
Download a blank template from inside the importer. Select the download link at the bottom left of the import window.
Which template to use
Template | Where to find it | What it is for |
Chart of accounts | Assessments › Chart of Accounts | Your list of accounts |
Trial balance | Assessments › Trial Balances | Account balances |
General ledger | Assessments › Ledger Import | Transaction-level spend |
Method import | Imported Data › Methods | Activity data processed by a Method |
Activity upload | Import Data | Activity data |
Emission factors | Settings › Emission Factors | Your own factors |
Survey answers | Supplier Engagement | Bulk survey responses |
Chart of accounts
Required: account code, account name, account type.
Optional: alternate names, account currency, scope, category, justification.
Trial balance
Required: account code, balance.
Optional: account name.
Each file is one balance at one date. You choose the as-of date and the currency when you start the import, not in the file. Every account code must already be in your chart of accounts, and each may appear only once.
General ledger
Required: account code, date, spend.
Optional: currency, description, country, invoice number, supplier name, entity, facility, and any custom fields you have set up.
Include a country column if your ledger covers more than one country. Without it, every row takes your organisation's country.
An account name column is not needed. Avarni takes the account name from your chart of accounts.
Method import
Required: amount, date, activity class, input unit, country.
Optional: description, GHG emission category, entity, facility, supplier name, invoice number, spend amount, spend currency, and your custom fields.
The columns change with the Method:
A distance Method asks for a start airport and an end airport instead of an amount. Avarni calculates the distance.
A market-based Scope 2 Method replaces amount and input unit with the certificate columns. See Market-based Scope 2: LGCs, GreenPower and on-site solar.
Can I add a missing required column in Avarni instead of in my file?
It depends on the upload.
Method import. No. Your file must have a column for date, activity class and country. It also needs amount and input unit, except in a distance Method. Every row needs a value in these columns. Add the column to your file before you upload. A column with the same value on every row is fine, for example
AUin every country cell.Activity upload (Import Data). If some rows have no country or no input unit, the importer adds the step Assign values to missing fields. Choose one value. Avarni applies it to those rows only. The country starts as your organisation's country.
General ledger. Country is optional. See General ledger above.
Do I need scope or GHG category columns in a Method import?
No. The Method sets the scope and the GHG category for every row. You can delete these columns from your file.
If you map a GHG emission category column, its value replaces the Method's category for that row. The value must be a category in the Method's scope. Rows with an empty cell follow the Method's settings.
Can one Method handle a file with different kinds of data?
Yes, with one limit: a Method has one scope. Put data for a different scope in a separate Method.
Rows of the same unit type. Use branches. Add a condition on a column that tells the rows apart, such as activity class or description. Give each branch its own factor. See Build and edit a Method.
Rows of different unit types, for example waste in kilograms and in square metres:
Open the Method.
Clear the Unit type field. The importer then accepts any unit.
On each branch that sets a factor, add an Input Unit condition. Use units of one unit type only in that branch.
Select Save.
Without an Input Unit condition, the factor field on that branch stays disabled. The Fallback branch has no conditions, so its factor field stays disabled in this set-up.
To leave some rows out, send them to a branch that sets the status to Exclude. You can also remove those rows from the file before you upload.
Emission factors
Required: name, year, input unit, and the CO2, CH4 and N2O factors.
Optional: description, scope, GHG category, region.
Enter factors in kilograms of each gas per unit, not tonnes.
Formats and limits
Excel and CSV are accepted.
A survey answer upload takes up to 2000 rows. Split larger files.
Dates are safest as yyyy-mm-dd. A date such as 03/04/2026 is ambiguous and can be read as either March or April.
Is there a row limit for ledger and Method uploads?
No. Avarni sets no row limit on a chart of accounts, trial balance, general ledger or Method upload.
The 2000-row limit applies only to survey answer uploads.
What happens to columns I do not map?
Avarni imports only the columns you map to a field. Any other column in your file is left out. It does not reach the Emissions Hub.
To keep an extra column, such as a site code or a supplier location, create a custom field first. The custom field then appears as a field you can map in the importer. See Custom fields: when you need one and how to set it up.
Column order in your file does not matter. You match each column to a field when you map.
Fixing errors
The importer checks your file as you map the columns. It shows which rows and columns are wrong so you can correct them before the data lands.
If a row errors on the account code in a general ledger upload, the account is usually excluded from your chart of accounts. Select delete rows with errors and continue.
What happens to a row with a blank, zero or unrecognised input unit?
In a Method import, the input unit is required on every row. It must be a unit of the Method's unit type. The importer marks a blank cell, a 0 or an unrecognised unit as an error. Correct the cell, or remove the row before you continue.
In an activity upload (Import Data), choose a unit for the blank rows at the step Assign values to missing fields.
A Method with no Unit type accepts any unit, including Unknown. Avarni also stores Unknown when it cannot read the unit from an invoice. A row with the unit Unknown has zero emissions.
For the units Avarni accepts, see Country codes and units.
How do I fix rows with an Unknown input unit after import?
A row with the unit Unknown has zero emissions, so its activity is missing from your totals. Find and fix these rows in the Emissions Hub.
Go to Emissions Hub.
Filter the table to rows where Input Unit is Unknown.
If you know the real unit, select the rows and select Bulk edit.
Under Field, choose Input Unit.
Set the unit and select Bulk Edit.
If a row is not a real activity, select the Exclude status on that row. When the table is grouped, the status controls on a group row apply to every row in that group.
To stop new Unknown rows, fix the unit in the source file. You can also set a Unit type on the Method, so that the importer checks each unit.
Can I upload emissions totals I have already calculated?
No. Method imports and activity uploads take activity data, not emissions totals. Enter a total you calculated yourself by hand in the Emissions Hub.
See Load historical and prior-year data. It also covers which prior years to load and how to handle sites that have since closed.
