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

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

Настройка модуля достаточно сложная, нужно хорошо понимать работу сервиса 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 можно не указывать, пока не будет необходимости подключать функционал.