Получение данных по референсам Систэм Электрик

Названия референсов
Статус референса
Принадлежность к тарифу
Описание товара (или основное наименование товара)
Описание товара на английском языке
Коммерческое название
Коммерческое описание
Ключевые слова связанные с товаром
Отметка "Честный знак"
Порядок ранжирование товара (рекомендация по ранжированию если вы планируете отображать товары списком или в матрице)
Категория товара (бизнес, категория, подкатегория, range)
Продуктовая иерархия товара

Медиаконтент Полная версия медиаконтента доступна в методе getmime

Изображения — главное и дополнительные
Фото 360
Сертификаты на продукцию
Каталоги
Техническая документация

Характеристики товара

Основные характеристики
Дополнительные характеристики:
- Батареи и продолжительность автономной работы
- Вход
- Выход
- Защита от всплесков напряжения и фильтрация шумов
- Коммуникационные средства и средства администрирования
- Общие
- Параметры окружающей среды
- Соответствие
- Физические параметры
- Гарантийные обязательства
Etim характеристики версии 7 — в соответствии с международной классификацией

Как обратиться к методу?

GET для получения в формате XML https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}

GET для получения в формате JSON https://api.systeme.ru/new-api/JSON/getdata?accessCode={YourApiToken}

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

Поддерживаемые параметры в методе

&page={N} — пагинация, осуществляет переход к указанной странице, где N — ее номер. Общее количество страниц в выдаче системой не определяется, поэтому осуществлять перебор данных постранично нужно до тех пор, пока ответ не перестанет возвращать продуктовые данные (выдача станет пустой).

https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&page=2

&pageSize={N} — задает количество записей в выдаче, где N — числовое значение. По умолчанию большинство методов содержит лимит в 50 записей на страницу. Максимальное значение лимита — 50.

https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&pageSize=50

&commercialRef={N} — запрос данных по конкретному референсу или списку референсов, где N — точное обозначение референса, например GSL000434. Если в качестве значения задается список референсов, то они должны перечисляться через запятую без пробелов: GSL000434,16765,18636. Максимальное значение лимита — 50.

https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&commercialRef=GSL000434
https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&commercialRef=GSL000434,16765,18...

&brand={ID-бренда} — бренд товара. Поддерживается фильтрация товара по бренду:

https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&brand={ID-бренда}

Чтобы получить список брендов с их идентификаторами (ID), используйте метод API getbrands:

https://api.systeme.ru/new-api/XML или JSON/getbrands?accessCode={YourApiToken}`

&update_date={N} — указывает на дату, от которой следует запросить обновленные данные у референсов. Формат данных «дд.мм.гггг», например «20.04.2026».

`https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&update_date=15.07.2026

video_type — позволяет задать какой тип видео нужно получить. Vожет принимать значения: youtube, rutube, vk. Если параметр не указан, по умолчанию выводятся ролики из YouTube.

`https://api.systeme.ru/new-api/XML или JSON/getdata?accessCode={YourApiToken}&video_type=rutube

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

<reference>
    <commercialRef>C9F34106</commercialRef>
    <brand>Systeme Electric (ранее Schneider Electric)</brand>
    <keywords>
        <item>акти9</item>
    </keywords>
    <update_date>12.06.2023 00:12:29</update_date>
    <StatusRef>В ассортименте</StatusRef>
    <close_date>10.08.2023</close_date>
    <Substitution>
        <newReference>
            <NewCommercialReference>A9A15212</NewCommercialReference>
            <QuantityOld>1</QuantityOld>
            <QuantityNew>1</QuantityNew>
            <SubstitutionBeginning>15.02.2021</SubstitutionBeginning>
        </newReference>
    </Substitution>
    <description>ШИНКА ГРЕБЕНЧАТАЯ ЛЕВАЯ ГРУПП 4П (NL1L2L3(ШАГ18ММ)NL1NL2&hellip;NL3(ШАГ9MM)) 12 МОД.80А</description>
    <international_description>LEFT GROUP 4P COMB-BREEDED SHINKA</international_description>
    <eComProductTitles>ШИНКА ГРЕБЕНЧАТАЯ ЛЕВАЯ ГРУПП 4П (NL1L2L3(ШАГ18ММ)NL1NL2&hellip;NL3(ШАГ9MM)) 12 МОД.80А</eComProductTitles>
    <eComeProductDescriptions><p>ШИНКА ГРЕБЕНЧАТАЯ ЛЕВАЯ ГРУПП 4П (NL1L2L3(ШАГ18ММ)NL1NL2&hellip;NL3(ШАГ9MM)) 12 МОД.80А. Использование гребенчатых шинок упрощает установку оборудования. Они могут быть разрезаны за один заход. В комплект входят 2 боковые заглушки IP20. После разрезания шинки установка заглушек обязательна. На каждую сторону шинки нанесена маркировка для идентификации фаз при установке во всех позициях. Места разрезов помечены на изоляции.</p></eComeProductDescriptions>
    <countries>
        <country>Китай</country>
        <country_code>CN</country_code>
    </countries>
    <gisp>true</gisp>
    <gisp_url>false</gisp_url>
    <tnved>
        <code>8536500700</code>
        <description>Электромеханические комнатные выключатели на силу тока не более 11 а</description>
    </tnved>
    <warranty>
        <period>2</period>
        <type>КППО 8: Выезд сервисного инженера</type>
    </warranty>
    <markirovka>true</markirovka>
    <order>1</order>
    <tariff>
        <min_order_quantity>12</min_order_quantity>
        <value>55994</value>
        <description>Москва (Лобня, RU01)</description>
    </tariff>
    <images>
        <image>
            <url>https://static-pcsp.systeme.ru/image/SAe_7Cf0t_Ti7Y_S63d8c85151615.jpeg</url>
            <hash>6da07c71c78e13968857336222c26a5c5e933a9a</hash>
            <is_main>1</is_main>
            <size>72343</size>
            <type>jpeg</type>
            <sort>1</sort>
            <update_date>31.01.2023 10:53:35</update_date>
        </image>
        <image>
            <url>https://static-pcsp.systeme.ru/image/SAe_7Cf0t_Ti7Y_S63d8c85151615.jpeg</url>
            <hash>6da07c71c78e13968857336222c26a5c5e933a9a</hash>
            <size>72343</size>
            <type>jpeg</type>
            <sort>2</sort>
            <angle>1</angle>
            <update_date>31.01.2023 10:53:35</update_date>
        </image>
    </images>
    <characteristics>
        <characteristic>
            <type>Гарантия на оборудование</type>
            <name>Гарантия</name>
            <value>Срок гарантии на данное оборудование составляет 3 года</value>
            <update_date>07.08.2023 13:01:02</update_date>
        </characteristic>
    </characteristics>
    <certificates>
        <certificate>
            <name>ЕАЭС RU С-CN.НВ26.В.02514_22</name>
            <filename>ЕАЭС RU С-CN.НВ26.В.02514_22.pdf</filename>
            <url>https://api.systeme.ru/certificates/default/download/2879</url>
            <extension>pdf</extension>
            <types>
                <type>
                    <name>С-ТР ТС-НВО</name>
                    <description>Сертификат соответствия требованиям Технического регламента Таможенного союза ТР ТС 004/2011 "О безопасности низковольтного оборудования"</description>
                </type>
            </types>
            <fgis>https://pub.fsa.gov.ru/rss/certificate/view/3184195/product</fgis>
            <preview_img>https://static-pcsp.systeme.ru/media_preview/certificates/68mkdAXRJk0TmJlGQRy.jpg</preview_img>
            <preview_hash>86494bd13dc511b208a0d3aaac69ead4aa65f3b8</preview_hash>
            <hash>86494bd13dc511b208a0d3aaac69ead4aa65f3b8</hash>
            <status>в наличии</status>
            <start_date>20.12.2022 03:00:00</start_date>
            <ended_date>19.12.2027 03:00:00</ended_date>
            <update_date>21.12.2022 17:57:16</update_date>
            <keywords>
                <keyword>дифференциальный блок</keyword>
                <keyword>compact</keyword>
            </keywords>
        </certificate>
    </certificates>
    <photo360>
        <url>https://api.systeme.ru/player/embed?ref=C9F34106</url>
        <update_date>14.11.2023 15:10:29</update_date>
    </photo360>
    <videos>
        <video>
            <url>https://www.youtube.com/watch?v=icabd-y4veo</url>
            <title>Заголовок</title>
            <description>Описание видео</description>
            <preview_img>https://static-pcsp.systeme.ru/video/rYPTuKagb8ECCW.jpg</preview_img>
            <preview_hash>86494bd13dc511b208a0d3aaac69ead4aa65f3b8</preview_hash>
            <update_date>21.08.2023 16:22:30</update_date>
        </video>
    </videos>
    <etim>
        <etim7>
            <class>
                <id>EC000042</id>
                <descriptionRu>Модульный автоматический выключатель (автомат)</descriptionRu>
            </class>
            <features>
                <feature>
                    <id>EF005474</id>
                    <description>Степень защиты (IP)</description>
                    <value>EV006405</value>
                    <valueDescriptionRu>IP20</valueDescriptionRu>
                    <valueDescriptionEn>IP20</valueDescriptionEn>
                </feature>
                <feature>
                    <id>EF000187</id>
                    <description>Тип напряжения</description>
                    <value>EV000460</value>
                    <valueDescriptionRu>AC</valueDescriptionRu>
                    <valueDescriptionEn>AC</valueDescriptionEn>
                </feature>
                <feature>
                    <id>EF000228</id>
                    <description>Номин. напряжение</description>
                    <value>230</value>
                    <valueDescriptionRu/>
                    <valueDescriptionEn/>
                </feature>
                <feature>
                    <id>EF000416</id>
                    <description>Частота</description>
                    <value>50</value>
                    <valueDescriptionRu/>
                    <valueDescriptionEn/>
                </feature>
                <feature>
                    <id>EF000218</id>
                    <description>Глубина установочная (встраив.)</description>
                    <value>45</value>
                    <valueDescriptionRu/>
                    <valueDescriptionEn/>
                </feature>
                <feature>
                    <id>EF002950</id>
                    <description>Модульная ширина (общ. кол-во модульных расстояний)</description>
                    <value>1</value>
                    <valueDescriptionRu/>
                    <valueDescriptionEn/>
                </feature>
                <feature>
                    <id>EF000227</id>
                    <description>Номин. ток</description>
                    <value>6</value>
                    <valueDescriptionRu/>
                    <valueDescriptionEn/>
                </feature>
                <feature>
                    <id>EF000889</id>
                    <description>Характеристика срабатывания (кривая тока)</description>
                    <value>EV000084</value>
                    <valueDescriptionRu>C</valueDescriptionRu>
                    <valueDescriptionEn>C</valueDescriptionEn>
                </feature>
            </features>
        </etim7>
    </etim>
    <documents>
        <document>
            <type>Техническая документация</type>
            <title>Выключатели и переключатели серии AtlasDesign</title>
            <description>Руководство по эксплуатации выключателей и переключателей серии AtlasDesign</description>
            <url>https://static-pcsp.systeme.ru/media/63ecd0fbSBa_rGkPYEYryLTeUrF1_1676464375.pdf</url>
            <size>331165</size>
            <fileType>pdf</fileType>
            <hashSum>89f2b5671937eaf67e36a4a3dcf5bee6d884088a</hashSum>
            <preview_img>https://static-pcsp.systeme.ru/media_preview/media/rYPTuKagb8ECCW.jpg</preview_img>
            <preview_hash>86494bd13dc511b208a0d3aaac69ead4aa65f3b8</preview_hash>
            <update_date>15.02.2023 15:32:15</update_date>
            <keywords>
                <keyword>Модульное оборудование</keyword>
            </keywords>
        </document>
    </documents>
    <series>
        <id>399</id>
        <name>City9 SET</name>
    </series>
    <cos_hierarchies>
        <cos_hierarchy>
            <cos1>15PVM</cos1>
            <cos1_description>Power Медиум</cos1_description>
            <cos2>C94</cos2>
            <cos2_description>City9 SET</cos2_description>
            <cos3>M45</cos3>
            <cos3_description>City9 Автоматические выключатели 4,5кА</cos3_description>
            <update_date>30.08.2023 10:27:09</update_date>
        </cos_hierarchy>
    </cos_hierarchies>
    <product_hierarchy>
        <parent_series>City9 Box</parent_series>
        <series>City9 Box</series>
    </product_hierarchy>
</reference>

Описание тела ответа

Основные данные

commercialRef — наименование референса.

StatusRef — может иметь значение:

«В ассортименте»
«Выведен из ассортимента». Более полную информацию по референсу, который выведен из ассортимента, можно получить в методе Замены референсов.

close_date — дата снятия с производства.

tariff — информация о тарифе, включает информацию:

min_order_quantity — минимальное количество для заказа;
value — идентификатор склада, допустимы следующие значения: 55994 (Лобня) и 55995 (Екатеринбург);
description — описание склада.

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

international_description — описание товара на английском языке.

eComProductTitles — коммерческое название.

eComeProductDescriptions — коммерческое описание.

countries — страна происхождения.

brand — бренд товара. Поддерживается фильтрация по бренду, см. параметр brand.

Сведения о наличии в реестрах

gisp — наличие референса в реестре ГИСП (государственная информационная система промышленности).

markirovka — отметка «Честный знак» говорит о том, что товар прошёл официальную регистрацию в государственной системе. Может принимать значения true или false.

tnved — информация о ТН ВЭД:

code — код ТН ВЭД;
description — описание ТН ВЭД.

Данные о гарантии

warranty — информация о виде послепродажного обслуживания.

period — значение гарантии, указывается в годах, например 2 обозначает: гарантия 2 года;
type — тип послепродажного обслуживания.
Дополнительная информация о гарантии публикуется в блоке characteristics:

Прочие данные

order — ранжирование товара, целое число. Рекомендованный вес, который позволит вам вывести какой товар следует отображать выше/ниже в своем сервисе.

update_date — дата обновления товара.

Медиаданные

videos — ссылки на видео. Может быть размещено на площадке YouTube, Rutube, VK Видео. Вместе с видео приходит превью стоп-кадра для «заглушки» (кроме видео, размещенного в VK Видео).

Параметр video_type может принимать значения: youtube, rutube, vk. Если параметр не указан, по умолчанию выводятся ролики из YouTube.

Обратите внимание, что одно и то же видео может быть размещено на нескольких площадках.

https://api.systeme.ru/new-api/JSON/getdata?accessCode={YourApiToken} — выводятся только ролики из YouTube (параметр не задан).

https://api.systeme.ru/new-api/JSON/getdata?accessCode={YourApiToken}&video_type=rutube — выводятся только ролики из Rutube.

https://api.systeme.ru/new-api/JSON/getdata?accessCode={YourApiToken}&video_type=vk — выводятся только ролики из VK.

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

<image>
    <url>https://static-pcsp.systeme.ru/image/50732/TMcGh147.jpeg</url>
    <hash>2e426b145f01bc3667a4224f0e246b392a7faa7b</hash>
    <is_main>1</is_main>
    <sort>1</sort>
    <size>991557</size>
    <type>jpeg</type>
</image>

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

Для второстепенных изображений может быть указан ракурс. Если ракурс указан, то у изображения появится параметр angle.

<image>
    <url>https://static-pcsp.systeme.ru/image/50732/TMcGh147.jpeg</url>
    <hash>2e426b145f01bc3667a4224f0e246b392a7faa7b</hash>
    <sort>2</sort>
    <angle>1</angle>
    <size>991557</size>
    <type>jpeg</type>
</image>

Возможные значения параметра angle:

1 — вид спереди
2 — вид под углом
3 — вид справа
4 — вид сзади
5 — вид слева
6 — вид сверху
7 — вид снизу
8 — фото в упаковке

characteristics — основные характеристики референса. Это список дополняет значения указанные в ETIM справочнике (класификаторе электротехнических товаров).

certificates — список сертификатов на продукцию в виде ссылок на документы формата pdf. Передается информация о статусе сертификации status и сроках действия сертификата (дата начала действия start_date, дата завершения действия ended_date и дата обновления информации update_date).

Если поле ended_date будет пустое, то это обозначает, что сертификат бессрочный.

Описание полей сертификатов:

name — наименование сертификата;
filename — наименование файла сертификата;
url — ссылка на скачивание файла сертификата;
extension — расширение файла сертификата;
types — типы сертификата;
fgis — ссылка на реестр ФГИС Росаккредитации;
preview_img — ссылка на превью-изображение;
preview_hash — хэш-сумма файла превью-изображения;
hash — хэш-сумма файла сертификата;
status — статус сертификации;
start_date — дата начала действия сертификата;
ended_date — дата окончания действия сертификата;
update_date — дата обновления;
keywords — ключевые слова, связанные с сертификатом.

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

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

<etim>
    <etim7>...</etim7>
</etim>

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

product_hierarchy — новая продуктовая иерархия товара. Представлена в виде вложенного справочника:

parent_series — наименование родителя серии товара;
series — наименование серии товара.

series — устаревшая продуктовая иерархия товара, состоит из id и наименования серии.

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

type — тип файла;
title — заголовок файла;
url — ссылка на скачивание;
size — размер файла в байтах;
fileType — расширение файла;
hashSum — хэш-сумма файла;
preview_img — превью-изображение файла;
preview_hash — хэш-сумма превью-изображения;
update_date — дата обновления;
keywords — ключевые слова файла.

Выборка по категориям вложенности

generalHierarchies — категория вложенности товара:

<generalHierarchies>
    <generalHierarchy>
        <business>...</business>
        <category>...</category>
        <subcategory>...</subcategory>
        <range>...</range>
    </generalHierarchy>
    <generalHierarchy>
        <business>...</business>
        <category>...</category>
        <subcategory>...</subcategory>
        <range>...</range>
    </generalHierarchy>
</generalHierarchies>

Поддерживается фильтрация по параметрам бизнеса, категории, подкатегории и range:

business — фильтр по бизнесу;
category — фильтр по категории;
subcategory — фильтр по подкатегории;
range — фильтр по range.

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

https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&business={ID бизнеса}
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&category={ID категории}
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&subcategory={ID подкатегории}
https://api.systeme.ru/new-api/XML/getdata?accessCode={YourApiToken}&range={ID range}

Для получения ID бизнесов, категорий, подкатегорий и range используйте отдельные методы API:

Бизнесы — https://api.systeme.ru/new-api/XML/getbusiness?accessCode={YourApiToken}
Категории — https://api.systeme.ru/new-api/XML/getcategories?accessCode={YourApiToken}
Подкатегории — https://api.systeme.ru/new-api/XML/getsubcategories?accessCode={YourApiToken}
Range — https://api.systeme.ru/new-api/XML/getranges?accessCode={YourApiToken}

Выборка по уровням COS

cos_hierarchies — продуктовая иерархия товара.

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

Персональный процент скидки необходимо добавлять к тарифной стоимости на своей стороне. По API получить персональные цены нельзя.

https://api.systeme.ru/new-api/XML/getcos?accessCode={YourApiToken}&cos1=15RTP&cos2=AC9&cos3=RTD

COS имеет 3 уровня иерархии:

COS1,
COS2,
COS3.

Полностью соответствует Коллекции, Линейке и Сублинейке в тарифе. Каждый уровень имеет свой уникальный код, по которому можно применить фильтр. Коды и уровень COS изначально определены у референса:

<cos_hierarchies>
    <cos_hierarchy>
        <cos1>15RTE</cos1>
        <cos1_description>Ритейл Эконом</cos1_description>
        <cos2>BLA</cos2>
        <cos2_description>ЭУИ BLANCA</cos2_description>
        <cos3>FMS</cos3>
        <cos3_description>Механические функции, открытый</cos3_description>
        <update_date>09.03.2023 15:07:58</update_date>
    </cos_hierarchy>
</cos_hierarchies>

Референсы могут иметь не все 3 уровня COS, а только один или два, начиная с первого уровня. Это является нормой.

COS1 в примере имеет код 15RTE, который и подставляется в фильтр. Для более удобного и наглядного представления этих данных можно использовать фильтр в каталоге https://api.systeme.ru/, выбрав вкладку «Тарифное». Получив необходимый набор референсов, эти коды COS можно перенести в запрос API, тем самым получив тот же самый набор референсов в выдаче.