Skip to main content

Set a charging profile on a charger

POST 
/chargers/:id/actions/set-charging-profile

Sends an OCPP SetChargingProfile command to configure power limits and charging schedules for smart charging and load management.

Use Cases:

  • Implement load balancing across multiple chargers
  • Enforce site-wide power limits and demand response
  • Schedule time-of-use pricing optimization
  • Integrate with grid signals and renewable energy
  • Implement vehicle-to-grid (V2G) discharge schedules
  • Control peak demand and avoid grid overloads

Charging Profile Types:

  • ChargePointMaxProfile: Site-wide power limit for all connectors
  • TxDefaultProfile: Default profile for all transactions
  • TxProfile: Profile for specific transaction or session

Profile Purpose:

  • ChargePointMaxProfile: Maximum power allowed by site infrastructure
  • TxDefaultProfile: Default charging behavior without custom profile
  • TxProfile: Custom per-session power schedule

Schedule Structure:

  • Stack Level: Priority (lower = higher priority, 0 = highest)
  • Charging Rate Unit: Power (W) or current (A)
  • Schedule Periods: Time-based power limits
  • Start Schedule: When profile becomes active
  • Duration: How long profile remains active

Best Practices:

  • Align power limits with site electrical capacity
  • Use stack levels to implement priority hierarchies
  • Test profiles on single charger before fleet rollout
  • Monitor composite schedule to verify behavior
  • Consider charger hardware limits (max power)
  • Coordinate with utility demand response programs
info

Charging profiles enable smart charging and load balancing. They define power limits over time to optimize grid usage, reduce costs, and prevent overloads.

tip

Use GetCompositeSchedule after setting profiles to verify the calculated charging schedule the charger will follow.

Request​

Responses​

Standard success response for actions