Scoder: Модуль интеграции с сервисом Onliner.by по Api

---

---

Модуль служит для экспорта товаров в один из популярнейших торговых площадок Белоруссии Onliner (Onliner.By) по API.

Данный модуль позволяет с помощью Client ID и Client Secret, полученных в Onliner, интегрироваться с данным сервисом.




ВНИМАНИЕ!

• Мы не являемся представителями компании Onliner и не несем ответственности за их деятельность. Чтобы пользоваться сервисом Onliner, вам необходимо предварительно заключить с ними договор и зарегистрироваться на их сайте.
  
• Перед использованием модуля обязательно ознакомьтесь с описанием установки и настройки решения во вкладке Установка, а также с условиями технической поддержки проекта.
  
• Решение не подходит для облачного Битрикс24.
  
• Данный модуль разработан с использованием апи D7, см. требования к 1С-Битрикс на ядре D7.
  

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


Настройка модуля достаточно сложная, нужно хорошо понимать работу сервиса Onliner.


После установки решения необходимо:

1. В настройках модуля (на странице Настройки -> Настройки продукта -> Настройки модулей -> Scoder: Модуль интеграции с сервисом Onliner.by по Api) указать Client ID и Client Secret, полученные в сервисе Onliner.
   
2. Настроить профиль отправки данных в сервис Onliner на странице Контент -> Highload-блоки -> Scoder: Модуль интеграции с сервисом Onliner.by по Api. Настройки и добавить запись. На момент публикации модуля интерфейс настроек профиля может быть сложным для заполнения, мы используем только родные возможности 1С-Битрикс, а именно Hilgload-блоки. Обещаем исправиться и со временем выпустить более "человечный" интерфейс. =)
   

Отправка данных в сервис Onliner происходит периодически с помощью агента CScoderOnlinerAgents::PriceList(). При необходимости изменить периодичность или время запуска, необходимо редактировать непосредственно агент.


Колонки названы аналогично колонкам в Onliner: https://github.com/onlinerby/onliner-b2b-api/blob/master/docs/price-lists/formats.md

• ИД инфоблока - целое число, равен ИД каталога товаров, который необходимо отправлять в Onliner.
  
• Поле для ИД раздела из Onliner - в данный момент не используется, модуль выгружает только товары, не категории
  
• Выгружаемые разделы - не обязательное поле, по умолчанию все категории. В каждой строке необходимо указать целое число, равное ИД раздела инфоблока, товары которых необходимо выгружать.
  
• Поле для названия раздела - стандартное или пользовательское поле (UF_*) раздела инфоблока, откуда берется название для категории. Например, NAME.
  
• courierDeliveryPrices - в данный момент не используется.
  

Все остальные поля могут браться из стандартных полей элементов инфоблока, свойств элементов инфоблока и полей торгового каталога и заполняются по следующему принципу:

• Если необходимо указать стандартное поле, то перед кодом поля нужно добавить префикс ELEMENT_. Например, ELEMENT_ID, ELEMENT_NAME, ELEMENT_PREVIEW_TEXT...
  
• Если необходимо указать свойство, то перед кодом свойства нужно добавить префикс PROPERTY_. Например, PROPERTY_BRAND, PROPERTY_ARTICLE, зависит от того, какой код ваших свойств. Если используется свойства типа привязки к элементам то, через "точку", например PROPERTY_BRAND.PROPERTY_MANUFACTURER... Т.е. работает принцип метода CIBlockElement::GetList.
  
• Если необходимо указать поле торгового каталога, то перед кодом поля нужно добавить префикс CATALOG_. Например, CATALOG_QUANTITY, CATALOG_PRICE_1, CATALOG_CURRENCY_1...
  
• Если необходимо задать статичное значение или текст, то так и пишете как есть в соответствующую строку.
  

Немного о сервисе Onliner:

Сопоставления торговых предложений с карточками товара в Onliner происходит двумя способами, по связке:

1. "Производитель" - "Артикул"
   
2. Если Артикул не записан в каталог (не существует на стороне Onliner/не был предоставлен при создании карточки товара/вы передали ошибочный), то валидация происходит вторым способом: "Раздел" - "Производитель" - "Товар"
   

Другими словами, ваши наименования полей "Раздел" - "Производитель" - "Товар" - должны полностью совпадать с аналогичными полями товара в Onliner.


Все выделенные поля обязательны:



Поля:

• "stockStatus"
  
• "termHalva"
  
• "priceHalva"
  

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

Техническая поддержка осуществляется по e-mail адресу scoder.ru@yandex.ru. Все просьбы и предложения, пожалуйста, отправляйте на указанный почтовый ящик или в комментариях к решению.

При обращении в службу поддержки обязательно указывайте:

• адрес сайта,
  
• логин и пароль администратора,
  
• ftp логин и пароль,
  
• e-mail покупателя модуля или номер вашего купона,
  
• техническая поддержка не оказывается, если закончился срок получения обновлений модуля.
  

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