Skip to content

SMA API#

This guide explains how to configure an SMA system with DataManager for PV curtailment by Octave via SMA API (cloud control).

1. Octave needs to request SMA access to the installation#

  • Octave needs the mail address of the owner of the PV installation
  • Via the cloud API, Octave will provide that owner mail address to SMA and request SMA access to the system.
  • SMA will then automatically send an e-mail to the owner mail address to request access.
  • The 'owner' then has to approve that request.

2. Configure the SMA system — SMA API cloud control#

  • The installer needs local network access on the SMA system for this.
  • Furthermore, Octave needs the serial number of the SMA data manager (or inverter with datamanager), and injection tariff formula to Octave to get the system operational.
  • To configure the SMA system for PV curtailment control by Octave via the SMA API cloud control option, perform the following steps. The interface is slightly different if there is an Separate Datamanager device, vs when the Datamanager is integrated into an SMA inverter.

3.1. Separate Data Manager device:#

Log in into the local web interface of the Data Manager with an administrator account:

Image

Enable PV curtailment control for 'Direct Seller':

  • Make sure to select the site and not an individual device:

    Image

  • Go to Configuration > Grid management service/Netbeheer:

    Image

  • Click on Active power > 'Go to Configuration':

    Image

  • Walk through the wizard:

    1. Step 1: Do not change anything and click on 'Continue'

    2. Step 2:

      1. Select 'Closed loop control' in 'Operating mode' (or 'Regeling' in Dutch).

      2. Select 'Manual control' in 'Selecting the setpoint' (or 'Handmatige besturing' in Dutch)

        Image

      3. Enable 'Direct Selling interface and select SMA SPOT

      4. Click 'continue'

      Image

    3. Step 3: Do not change anything and click 'Continue'

    4. Step 4: Do not change anything and click 'Save'

  • Log out.

Provide the Serial number of the SMA data manager to Octave, e.g. 3016690215 Provide the injection tariff formula to Octave for optimal PV curtailment, tailored to the customer's tariff

3.2. SMA Data Manager integrated into an SMA Inverter:#

Log in into the local web interface of the inverter with Data Manager with an administrator account:

Image

Enable PV curtailment control for 'Direct Seller':

  • Make sure to select the site and not an individual device:

    Image

  • Go to Configuration > Grid management service/Netbeheer

    Image

  • Click on 'Active and reactive power > Configuration & activation:'

    Image

  • Scroll down to “Active Power” and go to 'Operating mode':"

    Image

    1. Go to 'Operating mode':

    2. Make sure to select 'Closed-loop control' and 'Optimized closed-loop control' and click 'Continue on the bottom of the page:

      Image

    3. Do not change anything in the 'Grid operator specifications, click 'Continue'.

    4. On the 'Direct seller settings', change the following:

      • Select 'Source for external setpoint' and select 'SMA SPOT'

      • Select 'Behavior in case of setpoint change' and select 'Gradient'

      • Click 'Continue'

        Image

    5. You will now be redirected to the main 'Active and reactive power setpoints' page.

    6. Click 'Save' on the bottom of the page

  • Log out.

Provide the Serial number of the SMA inverter with integrated Data Manager to Octave, e.g. 3016690215 Provide the injection tariff formula to Octave for optimal PV curtailment, tailored to the customer's tariff