API каталога продукции предоставляет дистрибьюторам и партнерам Schneider Electric возможность получать данные о предложении продукции.
Новая версия обновлена до стандарта ETIM-9.0 (международный стандарт классификации технических изделий).
В настоящее время API имеет возможность:
1- Если в параметрах пути указать supplierid, customerid, supplierid-type, customerid-type, то будут возвращены все товары, которые находятся в области действия дистрибьютора, а также товары с другой необходимой информацией.
2- Вся информация, связанная с товаром, будет возвращена через этот API, если мы вызовем этот api, указав в параметрах пути коммерческий артикул товара, supplierid, customerid, supplierid-type, customerid-type.
3- Если запросить API с параметрами supplierid, customerid, supplierid-type, customerid-type, date-of-reference, change-type, то будут возвращены все продукты, находящиеся в зоне действия дистрибьютора, и если время создания продукта больше даты, указанной в параметре date-of-reference.
Для получения доступа к API требуется пройти проверку подлинности oAuth, подробные сведения см. на портале.
Доступность по странам - Список стран, для которых мы уже протестировали производительность, доступность и время отклика API:
- Аргентина, Австралия, Бельгия, Бразилия, Болгария, Канада, Чили, Колумбия, Хорватия, Дания, Финляндия, Франция, Германия, Индия, Италия, Мексика, Нидерланды, Новая Зеландия, Норвегия, Перу, Португалия, Румыния, Словения, Испания, Швеция, Швейцария, Турция и Великобритания.
Если ваша страна не указана в списке, вы можете связаться с нами напрямую или с вашим контактным лицом Schneider (POC), чтобы узнать, доступен ли ваш API в этой стране.
Get Products
| Method | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
QueryParams:
| Параметр | Тип данных | Обязательный параметр | Пример | Описание |
| supplierid | string | Y | 99887766 | Идентификатор поставщика продукта, настроенный в основной продуктовой системе Schneider Electric. |
| supplierid-type | string | Y |
specific |
(DUNS) Идентификационный номер, если доступен, в противном случае «Specific» Возможные значения: specific, duns Значение по умолчанию: specific |
| customerid | string | Y | 1122334455 | Ваш идентификатор клиента (DUNS, если доступен) или идентификатор, настроенный в основной продуктовой системе Schneider Electric (предоставленный вашим контактным лицом в Schneider Electric) |
| customerid-type | string | Y | specific | (DUNS) Идентификационный номер, если доступен, в противном случае «Specific» Возможные значения: specific, duns Значение по умолчанию: specific |
| date-of-reference | string | N | 2021-12-01 | Дата, начиная с которой вы хотите получить обновления |
| change-type | string | N | all | Вид изменений изменений с даты date-of-reference. Возможные значения: new, update, delete, all Значение по умолчанию: all |
| product-reference | string | N | QA_4659_DES_22 | Один или несколько артикулов, указанных в качестве отдельных параметров запроса. |
| product-identifier | string | N |
commercialReference |
Тип артикула, коммерческое обозначение или GTIN.
|
| etim-version | string | N |
ETIM-9.0 |
Версия ETIM, где ETIM является стандартом классификации данных продукта. Возможные значения: ETIM-7.0, ETIM-8.0, ETIM-9.0 |
| english-descriptions | булево значение | N |
true |
Включаются ли описания на английском языке помимо описаний на местном языке Значение по умолчанию: false |
| mime-filtering | string | N | MD36 |
В данном фильтре укажите несколько кодов дескриптора MIME, например MD01, MD04, MD99 и т. д. Для запрошенного фильтра MIME будут возвращены все типы документов, связанные с кодом дескриптора MIME, а также типы документов, разрешенные для соответствующих фильтров данных. - MD01 — изображение продукта - MD04 — ссылка на страницу продукта - MD05 — декларация о соответствии Регламенту REACh - MD14 — руководство пользователя - MD14 — руководство пользователя системы - MD14 — краткое руководство пользователя - MD21 — инструкция по применению - MD22 — спецификация продукта - MD36 — декларация о соответствии Директиве RoHs / декларация о соответствии Директиве RoHS для Китая - MD99 — CAD / 3D-модель / видеоинструкция / рекламное видео / набор 360-градусных изображений / сведения об экологичности продукта / руководство по выводу из эксплуатации / буклет / каталог Возможные значения: MD01, MD04, MD05, MD14, MD21, MD22, MD36, MD99 |
| data-filtering | string | N | up-selling |
Фильтр данных продукта. По умолчанию возвращаются все данные, но с помощью этого фильтра можно запросить указанный набор данных. Поддерживаются следующие значения для возвращения отфильтрованных данных: all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling Определение: Примечание: При использовании data-filtering = digital-asset-media AND mime-filtering
Если необходимо вернуть конкретное отношение к продукту, то эти значения можно использовать вместо отношения : Возможные значения: all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling |
