The Product Catalog API provides Schneider Electric distributors and partners with the ability to retrieve product offer data.
This new version has been updated to ETIM-9.0 (International classification standard for technical products).
Currently, the API has the capability to:
1- All the products which are in the distributor's scope those products with other necessary information will be returned if we provide supplierid, customerid, supplierid-type, customerid-type in the path params.
2- All the information related to a product will be returned through this API if we call this api with product's commercial reference, supplierid, customerid, supplierid-type, customerid-type in the path params.
3- If we request the API with supplierid, customerid, supplierid-type, customerid-type, date-of-reference, change-type parameters then it will return all the products which are in the distributor's scope and if the product's creation time is greater than the date given in the date-of-reference parameter.
API Access will require oAuth authentication, please refer to the details on portal.
Country Availability Assessment - Catalog of countries where we have conducted performance, availability, and response time testing for this API:
- Argentina, Australia, Belgium, Brazil, Bulgaria, Canada, Chile, Colombia, Croatia, Denmark, Finland, France, Germany, India, Italy, Mexico, Netherlands, New Zealand, Norway, Peru, Portugal, Romania, Slovenia, Spain, Sweden, Switzerland, Turkey and the United Kingdom.
If your country is not included in the list, please feel free to reach out to us directly or contact your designated Schneider Point of Contact (POC) to inquire about the API's accessibility in your country.
Get Products
| Method | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
QueryParams:
| Param | Data-type | Mandatory | Example | Description |
| supplierid | string | Y | 99887766 | Product supplier identifier, configured in the Schneider Electric product master system. |
| supplierid-type | string | Y |
specific |
(DUNS) ID number if available, else (Specific) Available values: specific, duns Default value: specific |
| customerid | string | Y | 1122334455 | Your Customer identifier (Duns if available) or the one configured in the Schneider Electric product master system (delivered by your Sales contact) |
| customerid-type | string | Y | specific | (DUNS) ID number if available, else (Specific) Available values: specific, duns Default value: specific |
| date-of-reference | string | N | 2021-12-01 | Starting date for any changes made to product data, which is used to query for delta changes. |
| change-type | string | N | all | Type of changes of interest since the date-of-reference. Available values: new, update, delete, all Default value: all |
| product-reference | string | N | QA_4659_DES_22 | One or multiple product references, entered as individual query parameters. |
| product-identifier | string | N |
commercialReference |
Product reference type, commercial reference or gtin.
|
| etim-version | string | N |
ETIM-9.0 |
ETIM version, where ETIM is a standard for classifying product data. Available values: ETIM-7.0, ETIM-8.0, ETIM-9.0 |
| english-descriptions | boolean | N |
true |
Whether or not English descriptions are included in addition of the local language Default value: false |
| mime-filtering | string | N | MD36 |
In this filter, provide multiple mime descriptor code such as MD01,MD04,MD99,etc. For the requested mime-filter all the doc-types associated with the mime descriptor code will be returned along with the doc-type which are allowed for the respective data-filters. - MD01 for Image of product - MD04 for Product Page Link - MD05 for REACh Declaration - MD14 for User guide - MD14 for System user guide - MD14 for Quick start guide - MD21 for Instruction sheet - MD22 for Product Data Sheet - MD36 for RoHs Declaration / RoHS China Declaration - MD99 for CAD / 3D Model / How to video / Promotional video / 360 set of image / Product environmental / End of life manual / Brochure / Catalog Available values: MD01, MD04, MD05, MD14, MD21, MD22, MD36, MD99 |
| data-filtering | string | N | up-selling |
Product data filter. By default all data is returned but this allows a specified set of data to be requested. These are the supported values that can be used to return filtered data : all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling Definition : Note: If using data-filtering = digital-asset-media AND mime-filtering
If you want to return specific Product relationship, these values can be used instead of relationship : Available values: all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling |
