Skip to main content

GoodWe integration

The GoodWe integration allows administrators to connect and monitor GoodWe inverters through the platform.

Requesting API credentials​

The request depends on the type of connection. In both cases, contact GoodWe support at soporte.es@goodwetechnology.zendesk.com and a GoodWe engineer will reach out to you. Once your request is approved, GoodWe's after-sales team sends you a Client ID and a Client Secret.

Installer credentials​

For admins, installers and other users who already have an organization account on the SEMS or SEMS+ platform. If you do not have one, register here.

Provide the following information:

  • Organization code: your organization code in SEMS+.
  • Registered account: make sure the account belongs to the target organization.
  • Email: if your stations belong to the European, American, Australian or international servers.
  • Company name.

User credentials​

For organizations that want their end users to connect their own GoodWe stations.

Provide the following information:

  • Company name.
  • Registered email address.
  • Application name.
  • Application description: a brief introduction of the application.
  • Application icon: JPG or PNG.
  • Redirect URI.

Setup from the portal (administrators)​

Installer credentials integration​

Follow these steps to integrate the Goodwe inverter using the installer's credentials:

  1. Go to Settings → My Integrations in the portal.
  2. Click Add Inverter.
  3. Select the GoodWe brand.
  4. Fill in the required fields:
    • Name: Identifier for this integration in the portal (e.g. Production, Test).
    • Client ID and Client Secret: Obtained after completing the credential request process above.
    • Domain URL (optional): If left empty, European domain is used by default. Use this field to set the correct regional URL when your installations are located outside Europe.

Once completed, your GoodWe inverter is integrated.

Setup from the App (end users)​

With user credentials, the end user connects their own GoodWe account from the app, without the installer needing to request API credentials from GoodWe.

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

  • Have a GoodWe monitoring platform (SEMS+) username and password.
  • Have owner permissions associated with their installation.

Steps:

  1. Go to More → Connections → Solar installation and batteries in the app.
  2. Tap on GoodWe to start the connection process.
  3. On the Connect your installation screen, confirm the connection request.
  4. Log in to the GoodWe platform with your credentials.
  5. Authorize the integration by accepting the requested permissions.

Once authorized, your GoodWe installation will be connected and ready for monitoring through the app.

Monitoring capabilities​

Once integrated, you will have access to:

  • Real-time installation data updated every 15 min
  • Energy production and consumption updated hourly
  • Historical energy data available from the connection date only
  • Production and consumption graphs
  • System alerts and installation status
  • Battery monitoring
  • Battery management: charge, discharge, idle or self-consumption modes, up to a target state of charge or the end of the scheduled interval (user credentials only)
note

Battery commands are asynchronous: GoodWe accepts the request first and the inverter applies it afterwards. Once the scheduled interval ends or the command is disabled, the inverter returns to self-consumption mode.