Solar Inverter Attributes

Solar inverter attributes are writable parameters that control battery behavior, self-consumption optimization, and system configuration for photovoltaic installations.

Required Parameters

string (UUID)

required

User ID that owns this solar inverter.Example: 016b78a7-0c7c-4241-a277-015c3ad3cb90Writable: No (set at device creation)

Device Model

object

The device model assigned to this inverter. Set during onboarding.Writable: No (set at device creation)

Show device_model fields

string

Manufacturer name. Example: Fronius

string

Model name. Example: Symo GEN24 10.0 Plus

integer

Model year, if available. Example: 2022

object

Show device_type fields

string

Machine-readable device type identifier. Example: inverter

string

Human-readable device type label. Example: Solar Inverter

Optimization Control

boolean

Flag indicating whether Podero’s smart optimization is actively controlling this inverter.Set to false to pause optimization without disconnecting the device.Example: trueWritable: Yes

Solar System Configuration

float

Currently installed peak power rating of the solar system in kilowatts.Example: 10.2Writable: Yes

Battery Configuration

boolean

Flag indicating whether the inverter has a storage battery connected.Set to false for solar-only installations without battery storage.Example: trueWritable: Yes

float

Currently installed battery capacity in kilowatt-hours.Required if is_battery_connected is true.Example: 10.0Writable: Yes

Battery Charge Limits

float

Minimum allowed battery charge level in percent.Battery will not discharge below this level, ensuring backup power availability.Example: 20Range: 0-100Writable: Yes

float

Maximum allowed battery charge level in percent.Useful for battery longevity or to reserve capacity for grid services.Example: 90Range: 0-100Writable: Yes

Usage Examples

Configure Solar System with Battery

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "solar_power_rating_kw": 10.2,
    "is_battery_connected": true,
    "battery_capacity_kwh": 13.5,
    "min_battery_charge": 20,
    "max_battery_charge": 100
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}',
    headers={
        'Authorization': f'Bearer {auth_token}',
        'Content-Type': 'application/json'
    },
    json={
        'solar_power_rating_kw': 10.2,
        'is_battery_connected': True,
        'battery_capacity_kwh': 13.5,
        'min_battery_charge': 20,
        'max_battery_charge': 100
    }
)

Configure Solar-Only System (No Battery)

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "solar_power_rating_kw": 8.5,
    "is_battery_connected": false
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}',
    headers={
        'Authorization': f'Bearer {auth_token}',
        'Content-Type': 'application/json'
    },
    json={
        'solar_power_rating_kw': 8.5,
        'is_battery_connected': False
    }
)

Configure Battery Limits for Backup Reserve

# Reserve 30% battery for backup power
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "min_battery_charge": 30,
    "max_battery_charge": 90
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}',
    headers={
        'Authorization': f'Bearer {auth_token}',
        'Content-Type': 'application/json'
    },
    json={
        'min_battery_charge': 30,
        'max_battery_charge': 90
    }
)

Best Practices

Battery Limits

Set min_battery_charge to 20-30% to ensure backup power availability
Set max_battery_charge to 90-95% for battery longevity
Adjust limits seasonally based on usage patterns

System Configuration

Keep solar_power_rating_kw updated if panels are added or removed
Update battery_capacity_kwh if the battery is upgraded
Set is_battery_connected to false for solar-only installations
Review configuration after system maintenance

Common Scenarios

New Installation Setup

# Configure newly installed 10kW system with 13.5kWh battery
update_inverter({
    'solar_power_rating_kw': 10.0,
    'is_battery_connected': True,
    'battery_capacity_kwh': 13.5,
    'min_battery_charge': 20,
    'max_battery_charge': 100,
})

Add Battery to Existing Solar

# Update system after battery retrofit
update_inverter({
    'is_battery_connected': True,
    'battery_capacity_kwh': 10.0,
    'min_battery_charge': 20,
    'max_battery_charge': 90
})

Emergency Backup Reserve

# Increase backup reserve for expected power outage
update_inverter({
    'min_battery_charge': 50,  # Reserve 50% for backup
})

# After emergency passes, return to normal
update_inverter({
    'min_battery_charge': 20
})

Seasonal Adjustment

# Summer: more production, higher max charge
update_inverter({
    'max_battery_charge': 100
})

# Winter: less production, reserve more battery
update_inverter({
    'min_battery_charge': 30
})

Solar Inverter State

Read-only state data and current readings

Setting Preferences

User workflow for configuring preferences

Overview

Getting Started

End-User Workflows

Back-Office Workflows

Notifications

API Reference

Heat Pumps

Electric Vehicles

Solar Inverters

Solar Inverter Attributes

Solar Inverter Attributes

Required Parameters

Device Model

Optimization Control

Solar System Configuration

Battery Configuration

Battery Charge Limits

Usage Examples

Configure Solar System with Battery

Configure Solar-Only System (No Battery)

Configure Battery Limits for Backup Reserve

Best Practices

Common Scenarios

Solar Inverter State

Setting Preferences

​Solar Inverter Attributes

​Required Parameters

​Device Model

​Optimization Control

​Solar System Configuration

​Battery Configuration

​Battery Charge Limits

​Usage Examples

​Configure Solar System with Battery

​Configure Solar-Only System (No Battery)

​Configure Battery Limits for Backup Reserve

​Best Practices

​Common Scenarios

Solar Inverter State

Setting Preferences

Solar Inverter Attributes

Required Parameters

Device Model

Optimization Control

Solar System Configuration

Battery Configuration

Battery Charge Limits

Usage Examples

Configure Solar System with Battery

Configure Solar-Only System (No Battery)

Configure Battery Limits for Backup Reserve

Best Practices

Common Scenarios