Связанные референсы

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

Содержание

Связанные референсы - getrefrelationship

Фильтрация по типам связи

Связанные референсы - getrefrelationship

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

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

Метод передает данные по связанным референсам запрошенного продукта. Возможны три типа связи:

  • Compatible - совместимые референсы, которые можно использовать вместе. Например, к выбранной розетке предлагаются подходящие рамки, подрозетники и т.д.
  • Cross selling - перекрестные референсы из других серий и ценовых сегментов (как правило, выше), подходящие по параметрам запрошенного.
  • Up selling - предложение аксессуаров, дополнительного оборудования к запрашиваемому референсу.

Без использования дополнительных параметров в запросе метод возвращает список всех референсов со всеми типами связей. По умолчанию pageSize=100 (отображается 100 референсов на странице).

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

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

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

<reference>
<commercialRef>16753</commercialRef>
<description>ДИФФ.ВЫКЛ.НАГР. ID 4П 40A 300mA B-ТИП</description>
<relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>16940</reference>
<description>АКСЕССУАР OFSP ДЛЯ RCCB</description>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>16939</reference>
<description/>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>27062</reference>
<description>Фальш-модуль на DIN рейку 9мм</description>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>26970</reference>
<description/>
</relationship>

В выдаче связанные референсы сгруппированы по типам связи. При том, внутри связи порядок отображения связанного референса означает его наибольшую совместимость по убыванию от самого первого (более совместимо или что нужно допредложить в первую очередь).

Фильтрация по типам связи

Фильтровать выдачу по типам связи возможно с использованием параметра relationshipType, например, если нужно загрузить только совместимые связанные референсы (тип связи compatible).

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

https://web.se-ecatalog.ru/new-api/XML/getrefrelationship?accessCode={YourApiToken}&relationshipType=up-selling

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

<content>
<result>success</result>
<data>
<reference>
<commercialRef>16753</commercialRef>
<description>ДИФФ.ВЫКЛ.НАГР. ID 4П 40A 300mA B-ТИП</description>
<relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>16940</reference>
<description>АКСЕССУАР OFSP ДЛЯ RCCB</description>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>26970</reference>
<description/>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>27062</reference>
<description>Фальш-модуль на DIN рейку 9мм</description>
</relationship>
<relationship>
<relationship-type>compatible</relationship-type>
<relationship-description>Товары этой же серии</relationship-description>
<reference>16939</reference>
<description/>
</relationship>
</relationship>
</reference>
</data>
</content>


Поддерживаемые параметры для фильтрации:

  • compatible - совместимые референсы
  • cross-selling - перекрестные референсы
  • up-selling - аксессуары, доппродажи

Параметры можно группировать знаком амперсанда &, например &relationshipType=up-selling&relationshipType=compatible. Группировка возможна для общего списка связанных референсов и по каждому референсу отдельно.

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

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

Ctrl + Enter

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