Overview

Asset Advisor API allows customers to collect and manage status and health of critical assets in electrical distribution networks.

Trial version

This API is a trial version available free of charge for selected customers and limited period.

For more information please contact the Schneider Electric Exchange support team.

API overview and usage

These API enables the following operations:

Sites and Assets

  • Browse and discover sites and assets information.
  • Provide sites and assets specific details (e.g. risk level, health indexes).

Tickets

  • Access all tickets generated on all assets from all sites.
  • Access all tickets for a given asset of a site.
  • Provide tickets specific details.

How it works

This API works for any Schneider Electric customer who has an identity in the Schneider Electric cIAM system. Nevertheless, customers must subscribe to this API to use it. The current version of the API is including the operations that are described below.

Explore Sites

This set of APIs allows the customer to browse all their Sites registered in Asset Advisor.

It is possible to access basic information of each site, such as ID, name, address, and location, which allows customers to do a mapping of Asset Advisor sites with their own representation and IDs, and also to locate all Sites in a map.

With the detailed view of a Site, customers are able to access information such as the Service Level subscribed for the Site, the Global Risk Level of the Site and the Health Matrix of the Site (including criticality and health index).

Explore Assets

This set of APIs allows the customer to browse all Assets for a specific Site registered in Asset Advisor.

It is possible to have two different views of the Assets within a given Site. The first one is the List View, providing a standard list of assets for a given Site, including asset information such as ID, name, description, type, and criticality. The second view is a Tree View, providing the entire hierarchy of assets for a given Site, allowing customers to build a complete Site topology.

Finally, it is possible to get specific details of each Asset, including the health index, maintenance information, and many other technical details.

Access Tickets

This set of APIs allows the customer to retrieve all tickets in Asset Advisor, including both alarms and recommendations. These tickets are either triggered by the Asset Advisor Analytics modules or manually created by Schneider Electric experts. This information allows customers to create their own customized dashboards with all tickets of their electrical distribution networks.

It is possible to query tickets using some filters such as:

  • By date range (ticket creation date)

  • By status (e.g. only "Opened" tickets)

  • By priority (e.g. Only "High" priority tickets)

Besides the above filters, it's also possible to limit the number of tickets in the response or retrieving specific range of tickets by setting the offset & limit filters for pagination capability. These queries return a list of "light" tickets, providing basic information such as title, description, asset, site, priority, status and creation date.

It is also possible to retrieve all tickets for a particular Asset of a Site, with similar filtering and pagination capabilities. This allows customers to create a consolidated view of tickets for a particular Asset of a Site.

Finally, it is possible to get specific details of each Ticket, including information such as priority, status, creation date, history of changes, comments and attachments. This allows customers to create a detailed view of each ticket.