Частые вопросы по API

Прочие инструкции
Обновление продуктовых данных

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

Содержание

Наличие обновлений - getdeltaproducts
Обновления Etim - getdeltaetim
Обновление характеристик - getdeltacharacteristics
Обновление изображений - getdeltaimages
Обновление документов - getdeltadocuments
Обновление сертификатов - getdeltacertificates
Полное обновление данных - getdatadelta

API позволяет получить обновления данных о продукции от указанной даты. Это исключает необходимость полного перебора данных по всему списку продукции, и сильно упрощает и ускоряет обновление.

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

Наличие обновлений - getdeltaproducts

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

Метод позволяет проверить наличие обновлений у референсов. Если от указанной даты до текущей произошло обновление данных, результат отобразит количество обновлений указанного типа данных.

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltaproducts?accessCode={YouApiToken}&date=29.07.2019

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>A9V01225</commercialRef>
            <description>БЛОК ДИФФ. ЗАЩ. Vigi iC60 2П 25A 30mA AC-ТИП 130В</description>
            <delta>
                <etimclass>6</etimclass>
                <etimfeatures>0</etimfeatures>
                <series>0</series>
                <characteristics>3</characteristics>
                <images>1</images>
                <documents>0</documents>
                <certificates>5</certificates>
                <packing_unit>0</packing_unit>
            </delta>
        </reference>
        <reference>
            <commercialRef>A9V01263</commercialRef>
            <description>БЛОК ДИФФ. ЗАЩ. Vigi iC60 2П 63A 30mA AC-ТИП130В</description>
            <delta>
                <etimclass>0</etimclass>
                <etimfeatures>0</etimfeatures>
                <series>0</series>
                <characteristics>0</characteristics>
                <images>2</images>
                <documents>1</documents>
                <certificates>5</certificates>
                <packing_unit>0</packing_unit>
            </delta>
        </reference>
    </data>
</content>


Описание тегов:
etimclass - наличие обновлений Etim-класса всех версий (6, 5 и т.д.)

etimfeatures - наличие обновлений Etim-свойств всех версий (6, 5 и т.д.)

series - наличие обновлений серии

characteristics - наличие обновлений характеристик

images - наличие обновлений изображений

documents - наличие обновлений документов и каталогов

certificates - наличие обновлений сертификатов

packing_unit - наличие обновлений логистических данных

Значение между тегами обозначает количество обновленных данных. Например, эта часть говорит о том, что характеристики от 29.07.2019 не были обновлены, 2 изображения обновилось и один документ также обновился:

<characteristics>0</characteristics>
<images>2</images>
<documents>1</documents>


Чтобы получить непосредственно обновленные данные, нужно вjзпользоваться методами ниже. Каждый их методов передает данные только по определенному типу данных.

Обновления Etim - getdeltaetim

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

Метод возвращает данные о всех обновлениях Etim (классы, свойства, значения и т.д.) в порядке приоритета (6, 5 и т.д.).

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltaetim?accessCode=J{YouApiToken}&date=29.07.2019

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>18632</commercialRef>
            <etim>
                <etim6>
                    <class>
                        <id/>
                        <descriptionRu/>
                    </class>
                    <features>
                        <feature>
                            <id>EF000416</id>
                            <description>Частота</description>
                            <value>50</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570028</id>
                                <description_ru>Гц</description_ru>
                                <description_en>Hz</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF000218</id>
                            <description>Глубина установочная (встраив.)</description>
                            <value>47</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570448</id>
                                <description_ru>мм</description_ru>
                                <description_en>mm</description_en>
                            </unit>
                        </feature>
                    </features>
                </etim6>
            </etim>
        </reference>
    </data>
</content>


Структура выдачи и название тегов полностью совпадает с выдачей метода getdata.

Обновление характеристик - getdeltacharacteristics

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

Метод возвращает список всех изменений по характеристикам продукта, как основным, так и дополнительным от указаной даты.

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltacharacteristics?accessCode={YouApiToken}&date=20.07.2019

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

<data>
    <reference>
        <commercialRef>A9V01225</commercialRef>
        <description>БЛОК ДИФФ. ЗАЩ. Vigi iC60 2П 25A 30mA AC-ТИП 130В</description>
        <delta>
            <characteristics>
                <characteristic>
                    <type>Основные характеристики</type>
                    <name>семейство продуктов</name>
                    <value>Glossa</value>
                </characteristic>
                <characteristic>
                    <type>Основные характеристики</type>
                    <name>тип изделия или компонента</name>
                    <value>Диммер</value>
                </characteristic>
                <characteristic>
                    <type>Основные характеристики</type>
                    <name>представление устройства</name>
                    <value>Механизм в сборе</value>
                </characteristic>
                <characteristic>
                    <type>Основные характеристики</type>
                    <name>тип нагрузки</name>
                    <value>
                        Лампа накаливания 230 В пер. тока : 60...300 Вт
                    </value>
                </characteristic>
            </characteristics>
        </delta>
    </reference>
</data>


Структура выдачи и название тегов полностью совпадает с выдачей метода getdata.

Обновление изображений - getdeltaimages

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

Метод возвращает список всех изменений по изображениям от указанной даты.

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltaimages?accessCode={YouApiToken}&date=20.07.2019

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>BLNDA000017</commercialRef>
            <description>
                BLANCA ПЕРЕГОВОРНОЕ УСТРОЙСТВО (ДОМОФОН), настен.монтаж, БЕЖЕВЫЙ
            </description>
            <images>
                <image>
                    <url>
                        https://static-pcsp.se-ecatalog.ru/image/2131f1Y5Fk.jpeg
                    </url>
                    <is_main>1</is_main>
                    <size>935304</size>
                    <type>jpeg</type>
                </image>
            </images>
        </reference>
    </data>
</content>


Структура выдачи и название тегов полностью совпадает с выдачей метода getdata.

Обновление документов - getdeltadocuments

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

Метод возвращает список всех изменений по документам и каталогам.

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltadocuments?accessCode={YouApiToken}&date=20.07.2019

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>40000DEK</commercialRef>
            <description>Выключатель-разъединитель 40A 3P ВР-101</description>
            <documents>
                <document>
                    <type>
                        https://http://static-pcsp.systeme.ru/document/212688/GKP6HrWq.pdf
                    </type>
                    <name>1564978</name>
                    <value>pdf</value>
                </document>
            </documents>
        </reference>
        <reference>
            <commercialRef>40001DEK</commercialRef>
            <description>Выключатель-разъединитель 63A 3P ВР-101</description>
            <documents>
                <document>
                    <type>
                        https://http://static-pcsp.systeme.ru/document/212689/Gc92NSpF.pdf
                    </type>
                    <name>1564978</name>
                    <value>pdf</value>
                </document>
            </documents>
        </reference>
    </data>
</content>


Структура выдачи и название тегов полностью совпадает с выдачей метода getdata.

Обновление сертификатов - getdeltacertificates

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

Метод возвращает список всех изменений по сертификатам.

Пример запроса:
https://api.systeme.ru/new-api/XML/getdeltacertificates?accessCode={YouApiToken}&date=20.07.2019

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

<content>
    <result>success</result>
    <data>
        <reference>
            <commercialRef>GSL000434</commercialRef>
            <description>
                GLOSSA СВЕТОРЕГУЛЯТОР (диммер) поворотный, 300Вт, в сборе, ТИТАН
            </description>
            <images/>
            <certificates>
                <certificate>
                    <name>ТС RU С-RU.АТ21.В.00025</name>
                    <url>
                        https://api.systeme.ru/certificates/default/download/319
                    </url>
                    <type>
                        <name>С-ТР ТС-ЭМС</name>
                        <description>
                            Сертификат соответствия требованиям Технического регламента Таможенного
                            союза ТР ТС 020/2011 "Электромагнитная совместимость технических средств"
                        </description>
                    </type>
                    <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://api.systeme.ru/certificates/default/download/319
                    </url>
                    <type>
                        <name>С-ТР ТС-НВО</name>
                        <description>
                            Сертификат соответствия требованиям Технического регламента Таможенного
                            союза Р ТС 004/2011 "О безопасности низковольтного оборудования"
                        </description>
                    </type>
                    <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>
            <characteristics/>
            <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>EF000007</id>
                            <description>Цвет</description>
                            <value>EV000300</value>
                            <valueDescriptionRu>Титан</valueDescriptionRu>
                            <valueDescriptionEn>Titanium</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF002169</id>
                            <description>Материал</description>
                            <value>EV000914</value>
                            <valueDescriptionRu>Металл</valueDescriptionRu>
                            <valueDescriptionEn>Metal</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF000025</id>
                            <description>Не содержит (без) галогенов</description>
                            <value>true</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                    </features>
                </etim6>
                <etim5>
                    <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>EF000007</id>
                            <description>Цвет</description>
                            <value>EV000300</value>
                            <valueDescriptionRu>Титан</valueDescriptionRu>
                            <valueDescriptionEn>Titanium</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF002169</id>
                            <description>Материал</description>
                            <value>EV000914</value>
                            <valueDescriptionRu>Металл</valueDescriptionRu>
                            <valueDescriptionEn>Metal</valueDescriptionEn>
                        </feature>
                    </features>
                </etim5>
                <etimRu>
                    <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>EF000007</id>
                            <description>Цвет</description>
                            <value>EV000300</value>
                            <valueDescriptionRu>Титан</valueDescriptionRu>
                            <valueDescriptionEn>Titanium</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF002169</id>
                            <description>Материал</description>
                            <value>EV000914</value>
                            <valueDescriptionRu>Металл</valueDescriptionRu>
                            <valueDescriptionEn>Metal</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF000025</id>
                            <description>Не содержит (без) галогенов</description>
                            <value>true</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF001257</id>
                            <description>Вид/марка материала</description>
                            <value>EV000154</value>
                            <valueDescriptionRu>Прочее</valueDescriptionRu>
                            <valueDescriptionEn>Other</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>
                        <feature>
                            <id>EF006243</id>
                            <description>Прозрачный</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF002442</id>
                            <description>Тип крепления</description>
                            <value>EV006354</value>
                            <valueDescriptionRu>Винтовое крепление</valueDescriptionRu>
                            <valueDescriptionEn>Mounting with screw</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF003876</id>
                            <description>Дополнит. вход управления</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF000416</id>
                            <description>Частота</description>
                            <value>50</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570028</id>
                                <description_ru>Гц</description_ru>
                                <description_en>Hz</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF003882</id>
                            <description>Цвет по RAL</description>
                            <value>0</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF006755</id>
                            <description>Подходит для степени защиты (IP)</description>
                            <value>EV006405</value>
                            <valueDescriptionRu>IP20</valueDescriptionRu>
                            <valueDescriptionEn>IP20</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF000005</id>
                            <description>Тип комплектации</description>
                            <value>EV006349</value>
                            <valueDescriptionRu>Механизм с цельной накладкой</valueDescriptionRu>
                            <valueDescriptionEn>Basic element with full cover</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF000006</id>
                            <description>Тип включения/управления</description>
                            <value>EV000092</value>
                            <valueDescriptionRu>Кнопка поворотная</valueDescriptionRu>
                            <valueDescriptionEn>Turn button</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF008810</id>
                            <description>Глубина устройства</description>
                            <value>33</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570448</id>
                                <description_ru>мм</description_ru>
                                <description_en>mm</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF008809</id>
                            <description>Высота устройства</description>
                            <value>82</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570448</id>
                                <description_ru>мм</description_ru>
                                <description_en>mm</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF008808</id>
                            <description>Ширина устройства</description>
                            <value>82</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570448</id>
                                <description_ru>мм</description_ru>
                                <description_en>mm</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF005116</id>
                            <description>Номин. мощность</description>
                            <value>300</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU000022</id>
                                <description_ru>ВА</description_ru>
                                <description_en>VA</description_en>
                            </unit>
                        </feature>
                        <feature>
                            <id>EF003911</id>
                            <description>Сочетается с таймером/выключателем</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003910</id>
                            <description>Сочетается с кнопкой</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003909</id>
                            <description>Сочетается с датчиком присутствия</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003908</id>
                            <description>
                                Сочетается с дистанционным (инфракрасным) выключателем
                            </description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003907</id>
                            <description>Сочетается с передающей кнопкой</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003906</id>
                            <description>Сочетается с датчиком движения</description>
                            <value>false</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003889</id>
                            <description>Перекрестный</description>
                            <value>true</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF003867</id>
                            <description>С памятью уровня освещенности</description>
                            <value>true</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                        </feature>
                        <feature>
                            <id>EF001508</id>
                            <description>Тип нагрузки</description>
                            <value>EV006463</value>
                            <valueDescriptionRu>Резистивная (активная) нагрузка</valueDescriptionRu>
                            <valueDescriptionEn>Resistive load</valueDescriptionEn>
                        </feature>
                        <feature>
                            <id>EF006144</id>
                            <description>Управляюшее напряжение</description>
                            <value>0</value>
                            <valueDescriptionRu/>
                            <valueDescriptionEn/>
                            <unit>
                                <id>EU570079</id>
                                <description_ru>В</description_ru>
                                <description_en>V</description_en>
                            </unit>
                        </feature>
                    </features>
                </etimRu>
            </etim>
            <documents/>
            <series>
                <id/>
                <name/>
            </series>
        </reference>
    </data>
</content>


Структура выдачи и название тегов полностью совпадает с выдачей метода getdata.

Если в выдаче отображется пустой тег, значит информация данного типа не обновлялась.

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

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

Ctrl + Enter

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