Add production devices portfolio

This article explains how to upload production devices into the Granular Energy platform, what data is needed and how the file is structured.

What is this about?

Before the platform can track your supply portfolio, it needs to know which generation assets you are working with, whether those are assets you operate directly or assets you have an offtake agreement with (e.g. a PPA). These are called production devices in the platform.

Each production device is linked to one or more production meters, the metering points where generation volumes are measured. The device upload is how you define this structure. Once devices and meters are in the platform, you can upload actual generation volumes (hourly or monthly metering data) against them.

How to upload generation devices

Production devices can be added to your portfolio either individually through the UI or in bulk using a CSV file.

To add a single device, navigate to Portfolio → Production devices → Add a production device and fill in the required fields (data structure described below)

For adding multiple devices at once, navigate to Portfolio → Production devices → Import a CSV (or via Import data → Portfolio data) and download the CSV template directly from the UI. The template includes the exact column names and any required field formats.

Upload the completed CSV file through the same interface. The platform will validate the file and flag any errors before saving.

Data structure

The generation device file is meter-centric: each row represents a production meter, with the associated production device data included in that same row.

This means:

• A production device that has multiple meters will appear across multiple rows, one per meter.
• Device-level fields (such as technology or location) must be consistent across all rows that reference the same device. The platform validates this and will reject the file if there are contradictions.
• File format requirements and accepted values list available in the platform (Portfolio data → Import production devices portfolio, right side green section in screen above)

Key fields

Production device fields (device-level, must be consistent across rows for the same device):

• production_device_reference  , your internal identifier for this asset. This is the permanent key used to identify the device in the platform. It cannot be changed after the first upload.
• production_device_registry_identifier  , The identifier of the device in the registry
• technology  , the generation technology (e.g. solar, wind, hydro)
• country  , ISO 2-letter country code of where the device is located (e.g. DE  , AT  , FR  )

Recommended optional production device fields:

• production_device_name  , an optional human-readable name for the production device. Defaults to the metering_point_reference if not provided
• production_device_subsidy_regime  , a state/national support scheme
• production_device_capacity  , The capacity of the production device, measured in kW
• production_device_longitude  and production_device_latitude  , the geographical coordinates of the device to allow precise mapping in reports

Production meter fields (meter-level, one row per meter):

• metering_point_reference  , your internal identifier for this meter. Also, a permanent key that cannot be changed after upload
• metering_point_grid_identifier  , the official grid/network ID for this metering point, relevant for registry compliance

Updates and incremental uploads

You can upload new devices and meters incrementally; a file does not need to contain your entire portfolio each time. You can also update existing records:

• Modified properties on a known device or meter (identified by their reference field) result in an update of that record.
• The reference field itself cannot be updated, as it is the identifier used to look up the record.

Tips & things to know

• Reference fields are permanent; choose meter and device references that are stable in your internal systems (e.g. asset IDs from your ERP or SCADA system).
• One device, multiple meters; a single production device can have several metering points. Add one row per meter, repeating the device-level fields consistently.
• This article covers device and meter setup only. For uploading actual generation volumes (hourly or monthly production data), see: Upload data into the platform): Metering data.
• For questions or support, contact support@granular-energy.com