Skip to main content

SMA integration

The SMA integration allows end users to connect their SMA solar installation by logging in with their SMA account (Sunny Portal), so you can monitor its production through the platform.

Each tenant uses its own SMA application: you request your own client credentials from SMA and add them in the portal.

Requesting API credentials​

Follow these steps to request your SMA client credentials.

  1. Contact SMA developer support to request access to the SMA Monitoring API and ask for a Client ID and Client Secret. SMA may ask you to sign an agreement.

  2. When SMA asks for the redirect URL of your application, give them:

    https://integrations-proxy.clever.gy/external-oauth/$tenant$/sma/callback

    Replace $tenant$ with your tenant identifier. Without this URL, end users cannot complete the connection.

  3. SMA will issue your Client ID and Client Secret. Store them securely.

Setup from the portal (administrators)​

Before end users can connect their SMA systems, an administrator must add the client credentials in the portal:

  1. Go to Settings → My Integrations.
  2. Click the Add Inverter button.
  3. Select the SMA brand.
  4. Fill in the following fields:
    • Name: Identifier for this integration in the portal (e.g. Production, Test).
    • Client ID and Client Secret: The credentials SMA issued to you.

Once completed, end users will be able to connect their SMA systems by logging in with their SMA account. To check whether the integration is available for end users, go to Settings → My Integrations. If the integration does not appear, you can request its activation.

Setup from the App (end users)​

Only end users who meet the following requirements will be able to complete this process:

  • Have an SMA account (Sunny Portal) with access to their installation.

Steps:

  1. Go to More → Connections → Solar installation and batteries in the app.
  2. Tap on SMA to start the connection process.
  3. On SMA's login page, log in with your SMA account.
  4. Authorize Clevergy to read your installation's data.

Once authorized, your SMA installation will appear in the app within a few seconds and will be ready for monitoring. The last 12 months of energy data are loaded in the background and may take about an hour to appear.

Check the microfrontend here.

Monitoring capabilities​

Once integrated, you will have access to:

  • Real-time installation data updated every 5 min. Grid import and export too, when the installation has an SMA energy meter
  • Energy production and consumption updated daily
  • Historical energy data available for the last 12 months
  • Production and consumption graphs
  • System alerts and installation status, including peak power
  • Battery monitoring (if applicable)