Получение данных по референсам

Последнее обновление: 5 ноября 2020 г.

Содержание

Метод getdata

Выборка по сериям

Метод getdata

Поддерживаемые параметры: commercialRef, pageSize, page

Метод используется для первоначального, наиболее полного наполнения базы сведениями о продукции и передает следующие данные:

  • Названия референсов
  • Принадлежность к тарифу
  • Серии продукции и их id
  • Описание
  • Коммерческое название
  • Коммерческое описание
  • Изображения - главное и дополнительные
  • Сертификаты на продукцию для разных стран
  • Основные характеристики
  • Дополнительные характеристики:
    • Батареи и продолжительность автономной работы
    • Вход
    • Выход
    • Защита от всплесков напряжения и фильтрация шумов
    • Коммуникационные средства и средства администрирования
    • Общие
    • Параметры окружающей среды
    • Соответствие
    • Физические параметры
  • Etim характеристики версий 5, 6, 7 - в соответствии с международной классификацией
  • Каталоги
  • Техническая документация

Для получения сведений используется метод getdata. По умолчанию возвращается список по первым 50 референсам из базы данных.

Пример запроса:

https://web.se-ecatalog.ru/new-api/XML/getdata?accessCode={YourApiToken}

Пример выдачи в XML:

This XML file does not appear to have any style information associated with it. The document tree is shown below.
<content>
<result>success</result>
<data>
<reference>
<commercialRef>GSL000434</commercialRef>
<tariff>
<value>moscow</value>
<description>ШЭ (Москва)</description>
</tariff>
<description>
GLOSSA СВЕТОРЕГУЛЯТОР (диммер) поворотный, 300Вт, в сборе, ТИТАН
</description>
<images>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/TMcGh147.jpeg
</url>
<is_main>1</is_main>
<size>991557</size>
<type>jpeg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/527b8cd7b383dce5b38f7b0c20fc7767101.jpg
</url>
<size>60205</size>
<type>jpg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/6c9b0ec745ef9ec03216e8ac07b8c345.jpg
</url>
<size>55208</size>
<type>jpg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/817b8cd7b383dce5b38f7b0c20fc7767101.jpg
</url>
<size>35450</size>
<type>jpg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/739b8cd7b383dce5b38f7b0c20fc7767101.jpg
</url>
<size>12984</size>
<type>jpg</type>
</image>
</images>
<characteristics>
<characteristic>
<type>Основные характеристики</type>
<name>семейство продуктов</name>
<value>Glossa</value>
</characteristic>
<characteristic>
<type>Основные характеристики</type>
<name>тип нагрузки</name>
<value>
Лампа накаливания 230 В пер. тока : 60...300 Вт<br>Галогенная лампа 230 В пер. тока : 60...300 Вт
</value>
</characteristic>
<characteristic>
<type>Основные характеристики</type>
<name>оттенок цвета</name>
<value>Титан</value>
</characteristic>
<characteristic>
<type>Дополнительные характеристики</type>
<name>монтаж</name>
<value>Лапками<br>Винтами</value>
</characteristic>
<characteristic>
<type>Дополнительные характеристики</type>
<name>материал</name>
<value>
Монт. рама : оцинкованная сталь<br>Центре пластины : PC + ASA глянцевая<br>Рамка : PC + ASA глянцевая
</value>
</characteristic>
<characteristic>
<type>Условия эксплуатации</type>
<name>cтепень защиты IP</name>
<value>IP20</value>
</characteristic>
<characteristic>
<type>Экологичность предложения</type>
<name>Статус предложения</name>
<value>Продукт не входит в категорию Green Premium</value>
</characteristic>
<characteristic>
<type>Экологичность предложения</type>
<name>Директива RoHS</name>
<value>Будет соответствовать&#xA0;-&#xA0;4Q2016</value>
</characteristic>
<characteristic>
<type>Соответствие RoHS</type>
<name>Статус RoHS EUR</name>
<value>Будет соответствовать</value>
</characteristic>
<characteristic>
<type>Соответствие RoHS</type>
<name>Согласованная дата RoHS EUR</name>
<value>4Q2016</value>
</characteristic>
</characteristics>
<certificates>
<certificate>
<name>ТС RU С-RU.АТ21.В.00025</name>
<url>
https://web.se-ecatalog.ru/certificates/default/download/319
</url>
<type>
<name>С-ТР ТС-ЭМС</name>
<description>
Сертификат соответствия требованиям Технического регламента Таможенного союза ТР ТС 020/2011 "Электромагнитная совместимость технических средств"
</description>
</type>
<area>ЕАЭС</area>
<status>в наличии</status>
<start_date>24.10.2017 03:00:00</start_date>
<ended_date>24.10.2020 03:00:00</ended_date>
<update_date>10.11.2017 16:18:43</update_date>
</certificate>
<certificate>
<name>ТС RU С-RU.АТ21.В.00025</name>
<url>
https://web.se-ecatalog.ru/certificates/default/download/319
</url>
<type>
<name>С-ТР ТС-НВО</name>
<description>
Сертификат соответствия требованиям Технического регламента Таможенного союза ТР ТС 004/2011 "О безопасности низковольтного оборудования"
</description>
</type>
<area>ЕАЭС</area>
<status>в наличии</status>
<start_date>24.10.2017 03:00:00</start_date>
<ended_date>24.10.2020 03:00:00</ended_date>
<update_date>10.11.2017 16:18:43</update_date>
</certificate>
</certificates>
<photo360>
<url>https://web.se-ecatalog.ru/player/embed/GSL000434</url>
</photo360>
<enviromental_img/>
<infographic/>
<articles>
<article>
<url>
https://static-pcsp.se-ecatalog.ru/articles/50732/cf3eaIhp2V8z0Wm.pdf
</url>
<size>529437</size>
<type>pdf</type>
</article>
</articles>
<videos>
<video>
<url>httpss://youtu.be/jZHKglM6dME</url>
</video>
</videos>
<eComProductTitles/>
<eComeProductDescriptions>
Glossa, поворотный диммер 300Вт, титан. тип устройства или его аксессуаров: диммер - тип нагрузки: лампа накаливания 230 В переменный ток 60...300 Вт, Галогенная лампа 230 В переменный ток 60...300 Вт - сегмент рынка: малые коммерческие предприятия, рынок жилья. Преимущества: Серия Glossa имеет следующие достоинства:, Повышенное удобство, энергосбережение и безопасность при установке в жилых домах, Прекрасно подходит как для модернизации существующих систем, так и для установки в новых зданиях, Устройства изготавливаются из надёжных, высококачественных материалов., Новая функция, USB-розетка, делает предложение УНИКАЛЬНЫМ на рынке., Новая система подъемных коробок для наружного монтажа позволяет создать блок из 5-ти постов., Яркая индивидуальная упаковка привлекает внимание и сохраняет изделиям товарный вид.... применения: 35 функций в ассортименте Glossa создают широкие возможности для применения серии в различных помещениях: как в жилищном, так и гражданском строительстве....
</eComeProductDescriptions>
<typical_BOM/>
<etim>
<etim6>
<class>
<id>EC000025</id>
<descriptionRu>Диммер (светорегулятор)</descriptionRu>
</class>
<features>
<feature>
<id>EF000003</id>
<description>Способ монтажа </description>
<value>EV000383</value>
<valueDescriptionRu>Скрытой установки </valueDescriptionRu>
<valueDescriptionEn>Flush mounted (plaster)</valueDescriptionEn>
</feature>
<feature>
<id>EF000139</id>
<description>Защитное покрытие поверхности</description>
<value>EV006393</value>
<valueDescriptionRu>Гальваническое покрытие</valueDescriptionRu>
<valueDescriptionEn>Galvanized</valueDescriptionEn>
</feature>
<feature>
<id>EF006569</id>
<description>Тип поверхности</description>
<value>EV000146</value>
<valueDescriptionRu>Матовый (-ая)</valueDescriptionRu>
<valueDescriptionEn>Matt</valueDescriptionEn>
</feature>
</features>
</etimRu>
</etim>
<documents>
<document>
<type>
https://static-pcsp.se-ecatalog.ru/document/50732/5P_bUOMn.pdf
</type>
<name>1563015</name>
<value>Инструкция</value>
</document>
<document>
<type>
https://static-pcsp.se-ecatalog.ru/document/50732/IEN-wast.pdf
</type>
<name>38819869</name>
<value>PDF</value>
</document>
<document>
<type>
https://static-pcsp.se-ecatalog.ru/document/50732/rbaPCklW.pdf
</type>
<name>38819869</name>
<value>PDF</value>
</document>
<document>
<type>
https://static-pcsp.se-ecatalog.ru/document/50732/hUtJdj1o.pdf
</type>
<name>335555</name>
<value>PDF</value>
</document>
</documents>
<series>
<id>306</id>
<name>GLOSSA</name>
</series>
<packing_unit>
<packing_unit_code>C62</packing_unit_code>
<quantity_min>2</quantity_min>
<volume>0.00038578</volume>
<weight>0.135</weight>
<length>0.083</length>
<width>0.083</width>
<depth>0.056</depth>
</packing_unit>
</reference>
</data>
</content>


Описание тегов:

commercialRef - наименование референса по номенклатуре Schneider Electric

tariff - информация о тарифной референса цене в базе данных (подробнее, тут будет ссылка)

description - стандартное описание референса, на русском языке. Для корректной обработки символов-мнемоников используется экранирование.

images - ссылки на изображения референса с указанием расширений type и размеров size в байтах. У референса может быть несколько изображений, одно из них главное (основное). Если основное изображение определено, то у него появляется тег is_main со значением 1.

<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/50732/TMcGh147.jpeg
</url>
<is_main>1</is_main>
<size>991557</size>
<type>jpeg</type>
</image>


Такие изображения можно использовать в карточках товара на сайтах в качестве основных. По умолчанию все изображения хранятся в jpg, одно изображение может иметь несколько версий по размеру и весу.

characteristic - основные характеристики референса, список может сильно отличаться между типами продукции

certificates - список сертификатов на продукцию с указанием области действия (Россия, Украина, Республика Беларусь, ЕАЭС), в виде ссылок на документы формата pdf. Передается информация о статусе сертификации status и сроках действия сертификата (дата начала действия start_date, дата завершения действия ended_date и дате обновления информации update_date.

photo360 - ссылка на плеер с фото 360. Плеер доступен по протоколу https, поэтому на сайтах с httpss могут возникнуть ошибки в браузере (проблемы с безопасностью). В среднем общий вес фото составляет 1.5Мб, размер кадра 1000 пикселей по максимальной стороне. (Подробнее о передаче списка фотограий в отдельном методе).

enviromental_img - ссылки на изображения в интерьере, расширение jpg.

infographic - ссылки на элементы инфографики jpg, png, pdf

articles - ссылки на статьи в pdf формате

videos - ссылки на видеоролики в youtube

eComProductTitles - коммерческое название референса

eComeProductDescriptions - коммерческое описание референса, приходит в неформатированном виде. Для корректного оторбажения требуется дополнительная разметка на стороне партнера.

etim - описание референса на русском языке по стандарту Etim версий 6 и 5. В выдаче всегда отображается наиболее приоритетная версия Etim 6. Если референс имеет несколько версий Etim, все они отображаются в порядке понижения версий (6, 5, и т.д.). Рекомендуется всегда забирать самую последнюю версию.

<etim>
<etim6>...</etim6>
<etim5>...</etim5>
<etimRu>...</etimRu>
</etim>

Все классы Etim (EC), свойства (EF), значение (EV) передаются с их кодами и описаниями на русском языке.

documents - ссылки на документы и каталоги в pdf

series - id и наименование серии. Значение id может использоваться для получения сведений о всех референсах, которые в ней содержатся.

packing_unit - логистические данные об упаковке товара, передает информацию о минимальном количестве в упаковке, весе, длине, ширине и глубине.

Если в выдаче тег не содержит информацию, значит ее нет в базе данных. Чтобы убедиться, что это не ошибка выдачи, можно сверить данные в веб-версии базы web.se-ecatalog.ru, они также должны отсутствовать.
Если у вас уже имеется интеграция с API, но при этом информация по референсам не полная, проверьте через какой метод ваша система забирает данные. Возможно это устаревший метод getbasicdata, который передает только основную информацию. Рекомендуем обновить ваш код для использования метода getdata, иначе есть риск получения не полных данных или их полное отсутствие.

Выборка по сериям

API позволяет получать продуктовые данные референсов по сериям. Например, нужно получить все данные референсов, которые относятся к Blanca. Для этого в запрос подставляется id серии и в ответ приходят данные по всем референсам Blanca.

В одном запросе можно указать только один идентификатор серии, поиск по нескольким id не поддерживается.

Пример запроса:
https://web.se-ecatalog.ru/new-api/XML/getdata?accessCode={YourApiToken}&series=571

Пример ответа:

<content>
<result>success</result>
<data>
<reference>
<commercialRef>BLNRS000016</commercialRef>
<tariff>
<value>moscow</value>
<description>ШЭ (Москва)</description>
</tariff>
<description>
BLANCA С/У РОЗЕТКА без заземления без шторок 16А, 250В, АНТРАЦИТ
</description>
<images>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/184112/2BEZYOpN.jpeg
</url>
<size>659046</size>
<type>jpeg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/image/184112/Hz-EGgqZ.jpeg
</url>
<size>158193</size>
<type>jpeg</type>
</image>
</images>
<characteristics/>


Выдача идентична стандартной выдаче метода getdata, в данном случае используется лишь фильтр для вывода данных.

Список идентификаторов всех серий можно скачать по ссылке.

Структура вложенности серий и референсов в БД API кардинально отличается от сайта se.com. На данный момент нет списка соответствия иерархий меню между этими платформами. Это необходимо делать самостоятельно.
В текущей версии вложенности БД API референсы одной серии могут принадлежать различным id. Например, серии Blanca и ЭУИ Blanca имеют разные id, но содержат все референсы Blanca. Один референс может иметь только одну серию, поэтому необходимо проверять в каких id они могут содержаться. Как правило, эти серии созвучны между собой.

В будущем планируется унификация структуры меню между двумя платформами и группирование референсов в внутри одной серии. Следите за обновлениями.

Ошибка в тексте?

Выделите ее и нажмите

Ctrl + Enter

Продолжая просмотр сайта www.web.se-ecatalog.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.